アップグレード前のタスクの完了

OAuth 2.0への変換を準備します

ただし、アップグレードの前に、許可リストの更新の説明に従って、エージェント・ネットワークからOracle Integrationの設計時およびランタイム、およびOracle Identity Cloud Serviceまたはアイデンティティ・ドメインへのエグレスを許可することで、この変換の準備をしておく必要があります。

また、アップグレード後に、新しい認証方法の結果として、ファイアウォールへの追加のトラフィックが表示されます。この追加のトラフィックが発生するのは、接続性エージェントが新しいトークンを取得するためにサーバーと通信する必要があるためです。

Oracle Integration 3でのOAuth 2.0サポートの詳細は、「Oracle Integration 3でBasic認証がサポートされるタイミング」を参照してください。

許可リスト設定の更新

アップグレード・ウィンドウが近づいたら、「許可リストの更新」で説明されているタスクを実行します。

アップグレード中にオフラインになっているか、アップグレード要件を満たしていないエージェントはアップグレードされません。その場合、アップグレード後のステップを実行して接続を取り戻す必要があります。

プロキシ・サーバーのキャッシュ・プロパティを設定します。

たとえば、プロキシ・サーバーでCache-ExpiresDefaultプロパティを使用する場合は、nowに設定します。

Oracle Cloudコンソールでアクティビティ・ストリームの取得を開始します

理由は、アクティビティ・ストリームが移行されないためです。ただし、Oracle Cloudコンソールでこのデータを取得しても、履歴データにアクセスできます。Oracle Cloudコンソールでのアクティビティ・ストリームの取得を参照してください。

完全なネットワーク・ルール構成

統合接続のいずれかが、Oracle Cloud Infrastructure Object StorageやOracle Autonomous Databaseなどのネットワーク・ルールをサポートするOracle Cloud Infrastructureサービスをターゲットとし、それらのルールを有効にした場合は、Oracle Integration Service VCNをルールに追加するなど、すべてのネットワーク・ルール構成を完了する必要があります。

Ensure Connectivityを参照してください。

キーストアのすべてのB2Bパスワードが一致することを確認します

最後にアップロードされたキーストア・ファイルがない場合は、ファイルを再作成します。

証明書をアップロードする場合:

• 「タイプ」で、「X.509 (SSLトランスポート)」を選択します。
• 「カテゴリ」で、「アイデンティティ」を選択します。

『Oracle Integration Generation 2での統合の使用』のSSL証明書のアップロードを参照してください。

失敗したインスタンスに対する処理を決定します

• 失敗した非同期インスタンス- リカバリ可能

  失敗したインスタンスを再送信し、キューをクリアします。失敗したメッセージの再送信を参照してください。

  インスタンスのアップグレード時に失敗した非同期インスタンスがある場合、Oracle Integration 3では失敗したインスタンスを再送信できません(少なくともすぐにはできません)。エラーやすべてのアクティビティ・ストリーム・データなどのランタイム・データがアップグレードの一部としてOracle Integration 3に移行されていないため、再送信できません。ただし、アップグレードの完了後、Oracle Integration 3で統合を実行し、エラー・データを収集してから再送信できます。

• 失敗した同期インスタンス- リカバリ不可

  同期統合インスタンスは再送信されないため、リカバリできません。

非同期メッセージの処理の決定

理由は、ダウンタイム中に、Oracle Integrationによってすべての受信リクエストが拒否されるためです。準備するには、次のオプションがあります:

• アップグレードを開始する前に、クライアント側のすべての非同期メッセージを一時停止します。

  このアプローチでは、クライアントはメッセージを送信せず、Oracle Integrationはそれらを拒否しません。

  このオプションを選択する場合は、アップグレードの開始時間と終了時間がわかっていることを確認してください。

• アップグレードが終了したら、拒否されたメッセージに対して適切な次のステップを決定します。

Oracle Integration 3コールの開発者APIを基本認証からOAuthに変更

Oracle Integration Generation 2では、Basic認証を使用してOracle Integration REST APIおよびファイル・サーバーREST APIを使用できます。Oracle Integration 3では、OAuthを使用する必要があります。OAuthを使用して接続するには、Developer API for Oracle Integration 3またはDeveloper API for File Serverを使用するクライアント、スクリプト、統合およびコマンドを更新する必要があります。認証方法のサポートの詳細は、『Oracle Integration 3のプロビジョニングと管理』のOracle Integration 3でサポートされているBasic認証のタイミングに関する項を参照してください。OAuthの使用の詳細は、Developer API for Oracle Integration 3のセキュリティ、認証および認可またはDeveloper API for File Server in Oracle Integration 3のセキュリティ、認証および認可を参照してください。

廃止されたMicrosoftアダプタの使用を停止

• Microsoft Office 365 Calendarアダプタ

  Oracle Integration 3でのMicrosoft Office 365 Calendarアダプタの使用の「操作の起動ページ」を参照してください。

• Microsoft Office 365 Peopleアダプタ

  Oracle Integration 3でのMicrosoft Office 365 Peopleアダプタの使用の「操作の起動ページ」を参照してください。

• Microsoft Office 365 Outlookアダプタ

  Oracle Integration 3でのMicrosoft Office 365 Outlookアダプタの使用の「操作の起動ページ」を参照してください。

1. アップグレード用のSSL証明書シークレットへのアクセスを許可するには、MySecretCompartmentをSSL証明書シークレットを含むコンパートメントに置換して、次のポリシーを追加します:

   allow service vb-vbprod to manage secrets in compartment MySecretCompartment
   allow service vb-vbprod to manage keys in compartment MySecretCompartment
   allow service vb-vbprod to manage vaults in compartment MySecretCompartment
   allow service vb-vbprod to read secret-bundle in compartment MySecretCompartment

2. カスタム・エンドポイントではなく元のOracle Integration Generation 2 URLを指すように、Visual Builderのテナントおよびアプリケーション設定および任意の統合アプリケーションを更新します。アップグレード中、カスタム・エンドポイントはVisual Builderで構成されるため、アップグレード後はカスタム・エンドポイントを介してVisual Builderアプリケーションのみにアクセスできます。

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