watsonx Orchestrate のバージョン 5.2 からバージョン 5.3.1 へのアップグレード

データをバックアップしてください

• watsonx Orchestrate はオンラインとオフラインの両方のバックアップをサポートします。
• watsonx Orchestrate は、OADP ユーティリティ、NetApp Trident protect、および IBM Fusion を使用したオンラインバックアップをサポートします。 詳しくは、オンラインバックアップとリストアを参照してください。
• OADP ユーティリティーを使用したオフライン・バックアップについて詳しくは、OADP ユーティリティーを使用したオフライン・バックアップおよびリストアを参照してください。

---
# ............................................................................
# watsonx Orchestrate parameters
# ............................................................................
non_olm:
  watsonxOrchestrate:
    installMode: "agentic_assistant"  
    watsonxAI:
      watsonxaiifm: true

---
# ............................................................................
# watsonx Orchestrate parameters
# ............................................................................
non_olm:
  watsonxOrchestrate: 
    watsonxAI:
      watsonxaiifm: true

[SUCCESS]... The install-components command ran successfully

オンライン復元

IBM Software Hub デプロイメントのオンライン・バックアップを同じクラスターまたは異なるクラスターにリストアするには、オンライン・バックアップおよびリストアを参照してください。

重要: バックアップを別のクラスターにリストアする操作は、IBM Fusion および NetApp Trident protect を使用してのみサポートされます。

オフライン復元

• IBM Software Hub デプロイメントのオフライン・バックアップを同じクラスターにリストアするには、同じクラスターへの IBM Software Hubのリストアを参照してください。
• IBM Software Hub デプロイメントのオフライン・バックアップを別のクラスターにリストアするには、別のクラスターへの IBM Software Hubのリストアを参照してください。

-- ============================================================================
-- Migration: ATM Endpoint TLS Upgrade — ALL TOOLS (5.3.0 → 5.3.1)
-- ============================================================================

-- Endpoint config (edit if your namespace differs)
SET atm_migration.old_url = 'http://<SERVER_INTERNAL_HOSTNAME>:9044';
SET atm_migration.new_url = 'https://<SERVER_INTERNAL_HOSTNAME>:9045';

BEGIN;

-- ============================================================================
-- 0. Ensure migration_log table exists
-- ============================================================================
CREATE TABLE IF NOT EXISTS migration_log (
    id             SERIAL PRIMARY KEY,
    migration_name TEXT NOT NULL,
    applied_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    description    TEXT,
    details        JSONB,
    CONSTRAINT migration_log_name_unique UNIQUE (migration_name)
);

-- Idempotency guard
DO $$
BEGIN
    IF EXISTS (
        SELECT 1 FROM migration_log
        WHERE migration_name = 'atm_endpoint_tls_migration_5_3_1'
    ) THEN
        RAISE NOTICE '=== Migration atm_endpoint_tls_migration_5_3_1 already applied. Skipping. ===';
        RAISE NOTICE 'To re-run: DELETE FROM migration_log WHERE migration_name = ''atm_endpoint_tls_migration_5_3_1'';';
        RETURN;
    END IF;
END $$;

-- ============================================================================
-- 1. Pre-migration snapshot
-- ============================================================================
DO $$
DECLARE
    v_tools_count INT := 0;
    v_tv_count    INT := 0;
    v_total       INT := 0;
BEGIN
    SELECT COUNT(*) INTO v_tools_count FROM tools
    WHERE binding::text LIKE '%wo-agentic-task-manager%'
      AND binding::text LIKE '%:9044%';

    SELECT COUNT(*) INTO v_tv_count FROM tool_version
    WHERE binding::text LIKE '%wo-agentic-task-manager%'
      AND binding::text LIKE '%:9044%';

    v_total := v_tools_count + v_tv_count;

    RAISE NOTICE '=== Pre-migration affected rows ===';
    RAISE NOTICE '  tools:        %', v_tools_count;
    RAISE NOTICE '  tool_version: %', v_tv_count;
    RAISE NOTICE '  TOTAL:        %', v_total;

    IF v_total = 0 THEN
        RAISE NOTICE 'No rows require migration.';
    END IF;
END $$;

-- ============================================================================
-- 2. Migrate: tools.binding (draft — all tools)
-- ============================================================================
DO $$
DECLARE
    v_new_url TEXT := current_setting('atm_migration.new_url');
    v_count   INT := 0;
BEGIN
    UPDATE tools
    SET binding = REPLACE(
        REPLACE(
            regexp_replace(
                binding::text,
                'http://wo-agentic-task-manager[^"]*:9044',
                v_new_url,
                'g'
            ),
            '"SERVER_INTERNAL_PROTOCOL":"http"',
            '"SERVER_INTERNAL_PROTOCOL":"https"'
        ),
        '"SERVER_INTERNAL_PORT":"9044"',
        '"SERVER_INTERNAL_PORT":"9045"'
    )::jsonb
    WHERE binding::text LIKE '%wo-agentic-task-manager%'
      AND binding::text LIKE '%:9044%';
    GET DIAGNOSTICS v_count = ROW_COUNT;
    RAISE NOTICE 'tools.binding: % rows updated', v_count;
END $$;

-- ============================================================================
-- 3. Migrate: tools.binding — targeted jsonb_set for openapi.url
-- ============================================================================
DO $$
DECLARE
    v_count INT := 0;
BEGIN
    UPDATE tools
    SET binding = jsonb_set(
        binding,
        '{openapi,url}',
        to_jsonb(
            REPLACE(
                REPLACE(
                    binding->'openapi'->>'url',
                    ':9044', ':9045'
                ),
                'http://', 'https://'
            )
        )
    )
    WHERE binding->'openapi'->>'url' LIKE '%wo-agentic-task-manager%'
      AND binding->'openapi'->>'url' LIKE '%9044%';
    GET DIAGNOSTICS v_count = ROW_COUNT;
    IF v_count > 0 THEN
        RAISE NOTICE 'tools.binding (openapi.url targeted): % rows updated', v_count;
    END IF;
END $$;

-- ============================================================================
-- 4. Migrate: tool_version.binding (live/versioned — all versions)
-- ============================================================================
DO $$
DECLARE
    v_new_url TEXT := current_setting('atm_migration.new_url');
    v_count   INT := 0;
BEGIN
    UPDATE tool_version
    SET binding = REPLACE(
        REPLACE(
            regexp_replace(
                binding::text,
                'http://wo-agentic-task-manager[^"]*:9044',
                v_new_url,
                'g'
            ),
            '"SERVER_INTERNAL_PROTOCOL":"http"',
            '"SERVER_INTERNAL_PROTOCOL":"https"'
        ),
        '"SERVER_INTERNAL_PORT":"9044"',
        '"SERVER_INTERNAL_PORT":"9045"'
    )::jsonb
    WHERE binding::text LIKE '%wo-agentic-task-manager%'
      AND binding::text LIKE '%:9044%';
    GET DIAGNOSTICS v_count = ROW_COUNT;
    RAISE NOTICE 'tool_version.binding: % rows updated', v_count;
END $$;

-- ============================================================================
-- 5. Migrate: tool_version.binding — targeted jsonb_set for openapi.url
-- ============================================================================
DO $$
DECLARE
    v_count INT := 0;
BEGIN
    UPDATE tool_version
    SET binding = jsonb_set(
        binding,
        '{openapi,url}',
        to_jsonb(
            REPLACE(
                REPLACE(
                    binding->'openapi'->>'url',
                    ':9044', ':9045'
                ),
                'http://', 'https://'
            )
        )
    )
    WHERE binding->'openapi'->>'url' LIKE '%wo-agentic-task-manager%'
      AND binding->'openapi'->>'url' LIKE '%9044%';
    GET DIAGNOSTICS v_count = ROW_COUNT;
    IF v_count > 0 THEN
        RAISE NOTICE 'tool_version.binding (openapi.url targeted): % rows updated', v_count;
    END IF;
END $$;

-- ============================================================================
-- 6. Post-migration verification
-- ============================================================================
DO $$
DECLARE
    v_rem_tools INT := 0;
    v_rem_tv    INT := 0;
    v_total     INT := 0;
BEGIN
    SELECT COUNT(*) INTO v_rem_tools FROM tools
    WHERE binding::text LIKE '%wo-agentic-task-manager%'
      AND binding::text LIKE '%:9044%';

    SELECT COUNT(*) INTO v_rem_tv FROM tool_version
    WHERE binding::text LIKE '%wo-agentic-task-manager%'
      AND binding::text LIKE '%:9044%';

    v_total := v_rem_tools + v_rem_tv;

    RAISE NOTICE '=== Post-migration verification ===';
    RAISE NOTICE '  Remaining in tools:        %', v_rem_tools;
    RAISE NOTICE '  Remaining in tool_version: %', v_rem_tv;

    IF v_total > 0 THEN
        RAISE WARNING 'INCOMPLETE: % rows still have old endpoint.', v_total;
    ELSE
        RAISE NOTICE 'COMPLETE: All endpoints updated to TLS (9045) for both draft and live.';
    END IF;
END $$;

-- ============================================================================
-- 7. Record migration in audit log
-- ============================================================================
DO $$
DECLARE
    v_old_url TEXT := current_setting('atm_migration.old_url');
    v_new_url TEXT := current_setting('atm_migration.new_url');
BEGIN
    INSERT INTO migration_log (migration_name, applied_at, description, details)
    VALUES (
        'atm_endpoint_tls_migration_5_3_1',
        NOW(),
        'Upgraded ATM endpoint from non-TLS (http:9044) to TLS (https:9045) for cluster upgrade 5.3.0→5.3.1',
        jsonb_build_object(
            'old_url', v_old_url,
            'new_url', v_new_url,
            'tables', jsonb_build_array('tools', 'tool_version'),
            'column', 'binding'
        )
    )
    ON CONFLICT (migration_name) DO UPDATE
    SET applied_at = NOW(),
        description = EXCLUDED.description,
        details = EXCLUDED.details;

    RAISE NOTICE 'Migration recorded as: atm_endpoint_tls_migration_5_3_1';
END $$;

COMMIT;

1. ユーザーが watsonx Orchestrateにアクセスできるようにするには、watsonx Orchestrateインスタンスへのアクセス権限のユーザーへの付与を参照してください。
2. オプション: IFM モデルを構成したり、特定のモデルを使用可能にしたり、未使用のモデルを使用不可にしたりすることができます。 詳しくは、インストールまたはアップグレード後の IFM モデルの構成を参照してください。
3. オプション: 外部 AI ゲートウェイを使用して、外部モデルを追加、表示、変更、または削除できます。 詳しくは、[オプション] AI ゲートウェイを介した外部モデルの登録を参照してください。
4. 任意: 「エージェント知識」セクションでファイル・アップロード機能を使用するには、Intelligent Document Processing (IDP) を有効にする必要があります。 詳しくは、[オプション]Intelligent Document Processing の有効化をご参照ください。