Oracle Integration Generation 2からOracle Integration 3へのアップグレード

3 Oracle Integration Generation 2からOracle Integration 3へのアップグレード

Oracleでは、Oracle Integration Generation 2をOracle Integration 3にアップグレードしています。アップグレードは追加コストなしで利用できます。

Oracle Integrationインスタンスを第3世代にアップグレードする前後に実行する必要があるVisual Builderタスクがいくつかあります。 Oracle Integrationのアップグレードの詳細は、「Oracle Integration 3のプロビジョニングと管理」の「Oracle Integration Generation 2からOracle Integration 3へのアップグレード」を参照してください。

Oracleは、適格なVisual Builderインスタンスのアップグレードを含め、Oracle Integration Generation 2インスタンスのアップグレード作業の大部分を実行します。

Oracle Integrationインスタンスを第3世代にアップグレードした後のVisual Builderの既知の問題のリストは、「Oracle Integration 3の既知の問題」の「Oracle Integration 3へのアップグレード後のライブ/ステージング・アプリケーションの既知の問題」を参照してください。

アップグレード準備状況チェック

Oracleは、アップグレードの準備状況を判断するために、いくつかの事前チェックを定期的に実行し、アップグレードを円滑に実行します。事前チェックに合格しない場合は、問題を修正するためにタスクの実行が必要になる場合があります。インスタンスの「設定」ページで、Oracle Integration Generation 2インスタンスの事前チェック・ステータスを確認するか、事前チェックを再度実行できます。詳細は、「Oracle Integration 3のプロビジョニングと管理」の「アップグレード準備状況の確認および事前チェックの問題の修正」を参照してください。

Oracle Integration Generation 2のVisual Builderインスタンスに対して、次の事前チェックが実行されます:

カスタム・エンドポイントはVisual Builderインスタンスで定義されていますか。
Visual Builderインスタンスでカスタム・エンドポイントが定義されている場合、インスタンスをOracle Integration 3にアップグレードできません。インスタンスをアップグレードするには、Oracleがカスタム・エンドポイントのアップグレードを開始するまで待機するか、今すぐアップグレードを進める場合は、Visual Builderインスタンスからカスタム・エンドポイントを削除します。

インスタンスをOracle Integration 3にアップグレードした後、「Visual Builderインスタンスで新しいカスタム・エンドポイントを定義」を実行できます。

ノート:
Visual Builderインスタンスで定義されたカスタム・エンドポイントは、Oracle Integrationで作成されたカスタム・エンドポイントと同じではありません。アップグレード中、Oracle Integrationで作成したカスタム・エンドポイントはVisual Builderで構成されるため、アップグレード後はカスタム・エンドポイントを介してVisual Builderアプリケーションのみにアクセスできます。アップグレード後に、Visual BuilderとOracle Integrationの両方に同じカスタム・エンドポイントを使用することはできません。同じカスタム・エンドポイントを使用すると、問題が発生する可能性があります。
Visual BuilderはOracleデータベース・インスタンスを使用しますか。
Visual Builderインスタンスで独自のOracleデータベース・インスタンス(BYODB)を使用している場合は、インスタンスをOracle Integration 3にアップグレードできます。ただし、アップグレード中にAutonomous Transaction Processing (ATP)が稼働している必要があります。後述の「アップグレードのためのVisual Builderの準備」で説明されている追加のタスクを完了してください。

アップグレードのためのVisual Builderの準備

アプリケーション(特にライブおよびステージングされたアプリケーション)を調べて、「Oracle Integration 3へのアップグレード後のライブ/ステージング・アプリケーションの既知の問題」のいずれかが原因でアプリケーションが正常に動作しないかどうかを確認します。このような場合は、次の「アップグレード後に完了するタスク」の関連する手順に従ってください。

サポートされているVBランタイムおよびJETバージョンにアプリケーションをアップグレードしたことを確認し、アプリケーションが正しく動作することを確認します。このステップを省略すると、アップグレード後にステージングまたはライブ・アプリケーションが動作しなくなる可能性があります。詳細は、「Oracle Integration 3の既知の問題」の「廃止されたVBランタイム・バージョンのVisual Builderアプリケーション」を参照してください。
サービス接続またはバックエンドで「委任認証」認証タイプを使用する場合は、認証タイプを「Oracle Cloudアカウント」に切り替える必要があります。「委任認証」認証タイプは非推奨です。認証タイプを変更したら、サービス接続とアプリをテストして、それらが正しく動作することを確認します。
Visual Builderを独自のOracleデータベース・インスタンス(BYODB)とともに使用する場合は、アップグレードの準備のために実行する必要があるステップがいくつかあります。
1. アップグレード中にAutonomous Transaction Processing (ATP)を稼働させておきます。
2. ATPに許可リスト(ACLとも呼ばれる)が構成されている場合は、Visual Builder VCN OCIDをATP許可リストに追加します。
3. ATPインスタンスのユーザー名とパスワードがVisual Builderで正しく構成されていることを確認します。
4. ATPへの接続に使用される期限切れのパスワードまたはウォレットをリセットします。
  1. 最新のウォレットをダウンロードします。 Oracle Autonomous Database Serverlessの使用のデータベース接続情報のダウンロードを参照してください。
  2. インスタンスの「テナント設定」ページでウォレットをアップロードします。「ATP Walletの更新と期限切れパスワードのリセット」を参照してください。

アップグレード後に完了するタスク

Oracle Integration 3でVisual BuilderのIAMポリシーを構成します。「Visual Builderインスタンスを管理するためのIAMポリシーの設定」を参照してください。
許可リストおよびネットワーク・アクセス・ルールを更新して、Oracle Integration 3にVisual BuilderサービスVCN OCIDを追加します。「インスタンスによるサービスへのアクセスの許可」を参照してください。
カスタム・エンドポイントのDNSレコードを更新します。
- WAF V2またはロード・バランサを使用するように構成されたプライマリ・カスタム・エンドポイントがインスタンスにある場合は、カスタム・エンドポイントDNSレコードのCNAMEを、Visual Builderインスタンス・ホスト名またはVB Generation 2ロード・バランサのIPアドレスで更新する必要があります。ロード・バランサを更新するには:
  - ロード・バランサを使用したバックエンドの追加
  - パブリック・ロード・バランサCIDR (IP/32)のVCN (NAT Gateway)のルート表に新しいルールを追加
- インスタンスの代替カスタム・エンドポイントの場合、移行後、代替エンドポイントはプライマリ・エンドポイントと同じロード・バランサに配置されないため、DNS CNAMEの更新は代替エンドポイントでは機能しません。代替エンドポイントの場合、DNSレコードを更新するために必要なエンドポイント詳細を取得するために、サービス・リクエスト(SR)を申請する必要があります。
バックエンドおよびサービス接続を更新します。
- Oracle Integration 3は基本認証を受け入れず、OAuthを推奨します。詳細は、「Oracle Integration 3でBasic認証がサポートされるのはいつですか。」を参照してください
  
  移行後、Basic Authを使用するOracle Integration REST APIへのバックエンドおよびサービス接続を更新して、適切なOAuthメカニズムを使用するように変更する必要があります(OAuth 2.0リソース所有者パスワードはBasic認証に最も類似しています)。 Oracle Cloudアカウント認証を使用してOracle Integration REST APIに接続するバックエンドおよびサービス接続の場合、認証を変更する必要はありません。
- バックエンド(またはサービス接続)の接続タイプが「動的、サービスはCORSをサポートしています」に設定されている場合は、これが「常にプロキシを使用」に設定されていることを確認します。これは、Oracle Integration REST APIのリダイレクトによって発生する可能性のあるChrome 119の問題を回避するためです。
- 統合REST APIへのサービス接続がカタログから作成された場合、それらは移行後も引き続き機能します(Basic認証が適切なOAuthメカニズムに置き換えられ、接続タイプが「常にプロキシを使用」に更新されている場合)。
- カタログにリストされていないVisual Builderのエンドポイント・フローを使用して作成されたOracle Integration設計時(またはファクトリ) APIへのサービス接続は、移行後に機能せず、更新する必要があります。
  
  このようなエンドポイントの例は、ルックアップ・エンドポイントです(Oracle Integration 3のDeveloper APIのルックアップRESTエンドポイントを参照)。サービス接続の「テスト」タブでテストすると、これらのエンドポイントには通常、エラー・コードHTTP 403が表示され、「許可されたリストに対してURLを検証できません」というエラーが表示されます。設計時URLおよびファクトリAPIの詳細は、Oracle Integration 3のDeveloper APIのSendRequestを参照してください。
  
  カスタム・バックエンドを使用してこれらのサービス接続を再調整するには:
  1. icsFactoryApiというカスタム・バックエンドを作成します(たとえば)。 URLの場合は、設計時URL ( https://design.integration.region.ocp.oraclecloud.comなど)を使用し、OAuth認証(通常はOAuth 2.0リソース所有者パスワード)を使用します。接続タイプを「常にプロキシを使用」(推奨)に設定します。
  2. 設計時APIに基づく既存のサービス接続の場合:
    1. URLをvb-catalog://backends/icsからvb-catalog://backends/icsFactoryAPIへ変更します。 (URLがhttps://<integration_base_url>の場合は、<integration_base_url>をvb-catalog://backends/icsFactoryAPIに置き換えます)。
    2. 「リクエスト」タブに移動し、"integrationInstance"の静的問合せパラメータを追加して、適切な値を追加します。
  3. このように導入された静的問合せパラメータは、ビジュアル・アプリケーション・コードの一部になります。このパラメータは、統合インスタンスごとに異なるため、アプリケーションを別のインスタンス(たとえば、prodインスタンス)にインポートする場合は、パラメータを更新する必要があります。ビルド・パイプラインを使用する場合は、パッケージング・ジョブでパラメータを変更する必要があります。
- (オプションですが推奨)認証タイプ、接続タイプおよび資格証明の詳細をバックエンドに設定および格納し、バックエンドに基づいてすべてのサービス接続を保持します。バックエンドでのみ詳細を定義すると、詳細を管理できるため、重複する必要がありません。詳細は、ブログ記事「バックエンドを使用するためのサービス接続の合理化」を参照してください。
Visual BuilderインスタンスがOracle Integration Gen 2からOracle Integration 3にアップグレードされると、ユーザー・デバイスにインストールされたPWAアプリケーションは自動更新の受信を停止します。

アップグレード後:
1. PWAを再発行します。
2. 新しいURLをユーザーに提供します。古いアプリケーションをアンインストールし、Oracle Integration 3の新しいVisual Builderのロケーションから新しいアプリケーションをインストールする必要があることをユーザーに指示する必要があります。
アプリケーションは、再インストール後に自動更新を受信します。詳細は、「Oracle Integration 3の既知の問題」の「PWAアプリケーションは、OIC 3への移行後に自動的に更新を受信しなくなりました」を参照してください。
アプリケーション・コードにOracle Integration Gen 2 Visual Builder URLへの参照がある場合、アプリケーションを正しく動作させるには、アップグレード後に新しいOracle Integration 3 VB URLに更新する必要があります。詳細は、「Oracle Integration 3の既知の問題」の「ライブ・アプリのサービス接続からVBビジネス・オブジェクトURLにアクセスできません」および「アップグレード前のVisual Builder URLにアクセスするカスタム・コードが失敗」を参照してください。