アップグレード準備状況の確認および事前チェックの問題の修正

エージェントJavaバージョン

1. JDK 17をまだ使用していない接続エージェントの場合は、エージェントをホストするサーバーにJDK 17をインストールします。
2. まだJKS KeyStoreを使用しているエージェントの場合は、KeyStoreをPKCS12 KeyStoreに変換します。変換は、次のいずれかの方法で実行できます。
   • アップグレード中に自動的に: JKS KeyStoreは、アップグレード中に自動的にPKCS12 KeyStoreに変換されます。
   • アップグレード前に手動で: 次のステップに従って、アップグレード前にJKS KeyStoreをPKCS12 KeyStoreに手動で変換できます。
   ノート
   
   JKS KeyStoreをPKCS12 KeyStoreに変換しても、Oracle Integration Generation 2接続エージェントには影響せず、Oracle Integration 3にアップグレードした後にのみ有効になります。

   JKS KeyStoreをPKCS12 KeyStoreに手動で変換する場合は、アップグレード前に次のステップを実行します。これらのタスクでは、接続エージェントを一時的に停止してから再起動する必要があるため、接続エージェントが使用されていない時間を選択します。

   1. 接続エージェントをホストするサーバーで、次のフォルダにあるkeystore.jksファイルのバックアップを作成します。

      Agent_Install_Location/agenthome/agent/cert

   2. バックアップ・ファイルを別のフォルダに移動します。
   3. コマンドラインから次のコマンドを実行して、JKS KeyStoreをPKCS12 KeyStoreに変換します。

      keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.p12 -srcstoretype JKS -deststoretype PKCS12 -deststorepass changeit -srcstorepass changeit

   4. 接続性エージェントを停止します。
   5. 次の場所のkeystore.jksファイルを削除します。

      Agent_Install_Location/agenthome/agent/cert

   6. 接続性エージェントを起動します。

Oracle Integration 3のエージェント接続- 接続性エージェントが実行されている必要があります

アップグレード中に到達できないエージェント、またはアップグレード要件を満たさないエージェントはアップグレードされません。その場合は、アップグレード後のステップを実行して接続を再取得する必要があります。

Oracle Integration 3のエージェント接続- 許可リスト設定の更新

アップグレード・ウィンドウが近づいたら、次のアップグレード前タスクを実行します:

• Oracle Cloud Infrastructure Identity and Access Management (IAM)のIPアドレスを許可リストに追加します。
• Oracle Integrationの設計時およびランタイムIPアドレスを許可リストに追加します。
• Oracle Integration URLのプロキシ・サーバーの「キャッシュ」プロパティを、できるだけ頻繁にリフレッシュするように設定します。

アップグレード中に到達できないエージェント、またはアップグレード要件を満たさないエージェントはアップグレードされません。その場合は、アップグレード後のステップを実行して接続を再取得する必要があります。

サポートされていないAgentGroup識別子

カスタム・エンドポイントURL

• Visual Builderを使用している場合:
  1. アップグレードを続行するには、Visual Builderのアップグレード前タスクを完了します。
  2. アップグレード中に、アップグレード・プロセスによって、カスタム・エンドポイントおよびVisual Builder内の代替カスタム・エンドポイントが構成されます。
• ビジュアル・ビルダーを使用せず、代替カスタム・エンドポイントがある場合は、Oracle Integration Generation 2インスタンスから削除します。Oracle Integration 3では、現在、代替カスタム・エンドポイントはサポートされていません。
• Visual Builderを使用せず、カスタム・エンドポイントでSSLを使用する場合:
  1. アップグレードを続行するには、Oracle Integration Generation 2インスタンスの前にロード・バランサを設定し、SSL証明書を削除します。
  2. アップグレード中に、アップグレード・プロセスによってOracle Integration 3でカスタム・エンドポイントが構成されます。
  3. アップグレード後、統合へのランタイム・アクセスは、Oracle Integration Generation 2の場合と同様に引き続き機能します。設計時やプロセス自動化など、他のすべてのアクセス・ポイントについては、カスタム・エンドポイントには引き続きアクセスしますが、カスタム・エンドポイントは適切なURLにリダイレクトされます。
• これらの状況のいずれも該当せず、この事前チェックに合格した場合、アップグレード・プロセスによってOracle Integration 3でカスタム・エンドポイントが構成され、カスタム・エンドポイントはSSLシナリオの前の箇条書きで説明したとおりに動作します。

インスタンスIDアクション

インテグレーション インスタンスIDを使用するインテグレーションがある場合は、事前チェックで警告が表示されます。「詳細」を展開して、レビューが必要な統合を表示します。詳細をクリップ・ボードにコピーするには、をクリックします。

この変更に必要な更新に追加の時間が必要な場合は、統合インスタンスIDを一時的に数値として保持できます(アップグレード後6か月)。FlowId Conversion Supportを参照してください。前述の詳細をコピーすることで影響を受ける統合に注意してください。

ノート:この事前チェックでは、インスタンスIDを使用する統合が存在するかどうかをチェックするだけで、インスタンスIDの正確さはチェックされません。統合の更新後も警告は残りますが、アップグレードには影響しません。

日次電子メール制限

IDCSのカスタム・スコープ

その他の失敗

B2B保存期間

Oracle Integration 3にアップグレードした後、必要に応じてデータ保持期間を増やす、または184日間のデータ保持をサポートするHealthcareエディションにアップグレードできます。

遅延(非同期)レスポンス

• Oracle CX Sales and B2B Serviceアダプタ
• Oracle ERP Cloudアダプタ
• Oracle HCM Cloudアダプタ
• Oracle Fusion Field Serviceアダプタ
• Salesforceアダプタ
• ServiceNowアダプタ

「詳細」を展開して、レビューが必要な統合を確認します。詳細をクリップボードにコピーするには、をクリックします。

アイデンティティ証明書

「詳細」を展開して、アイデンティティ証明書の名前およびそれらを使用する接続を表示します。詳細をクリップボードにコピーするには、をクリックします。

アイデンティティ証明書がある場合は、アップグレード後に、「接続の保証」の説明に従って新しいアイデンティティ証明書をアップロードする必要があります:

基本ルーティング重複アプリケーション名

1. 基本的なルーティング統合を編集し、ターゲット・エンドポイントを削除して、別の名前で再度追加します。
2. 統合を保存します。

「詳細」を展開して、レビューが必要な統合を表示します。詳細をクリップボードにコピーするには、をクリックします。

複数読取りファイル

複数のファイルを読み取る操作を含む統合がある場合は、このパターンを使用しないように統合を再処理します。たとえば、listFile操作を使用してファイルをリストし、for-eachアクションを使用して各ファイルを個別に読み取ります。「詳細」を展開して、レビューが必要な統合を表示します。詳細をクリップボードにコピーするには、をクリックします。

公開/サブスクライブの統合

インスタンスにメッセージを公開する統合や、Oracle Integrationからのメッセージをサブスクライブする統合が含まれている場合は、パブリッシュ/サブスクライブ(またはパブリッシュ/サブスクライブ)統合をイベント主導のオーケストレーションに変換する必要があることに注意してください。統合は、構成に応じて異なる方法で処理されます。

• 添付を使用する公開/サブスクライブ統合は、現時点では自動変換できません。アップグレードを続行する場合は、これらの統合を削除するか、事前チェックの失敗を無視できます。アップグレード後、それらを再作成し、テナンシのFTPサーバーまたはオブジェクト・ストレージにアタッチメントをプッシュして、参照をサブスクライバ・フローに渡すことができます。Oracle Integration 3での統合の使用のヘッダーベースのサブスクリプション・フィルタリングの定義を参照してください。
• 他のすべてのアクティブなpub/sub統合は、アップグレード中に自動的に変換されます。ドラフト状態のパブリッシュ/サブスクライブ統合は移行できず、アップグレード後に空白になります。
• サブスクライバ・フローでデータをマップした場合、マッピングは可能なかぎり正確に変換されます。ただし、アップグレード後は、マッピングを確認し、必要に応じて修正する必要があります。
• 「サブスクライバのみが存在し、パブリッシャはありません」というエラーが表示された場合は、アップグレード前に削除する必要がある孤立サブスクライバがあります。

「詳細」を展開すると、自動的に変換できない統合が表示されます。詳細をクリップボードにコピーするには、をクリックします。

ノート:この商談では、ドラフト公開フローを削除できます。

DT API基本認証からOAuthアクション

Oracle Integration Generation 2では、基本認証を使用して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での基本認証のサポート時期」を参照してください。OAuthの使用方法の詳細は、Oracle Integration 3のDeveloper APIのセキュリティ、認証および認可またはOracle Integration 3のDeveloper APIのセキュリティ、認証および認可を参照してください。

カスタム・アダプタ

Oracle Utilitiesアダプタ

サポートされていないアダプタ

• Automation Anywhereアダプタ
• Evernoteアダプタ
• Oracle Messaging Cloud Serviceアダプタ
• Oracle Monetization Cloudアダプタ
• Oracle Taleo Business Edition (TBE)アダプタ
• UiPathロボティック・プロセス・オートメーション・アダプタ

  ノート:ロボット・プロセス自動化(RPA)機能は、Oracle Integration 3で入手できます。ロボットについて学習およびロボットの構築(Oracle Integration 3でのロボットの使用)を参照してください。

「詳細」を展開して、使用しているサポートされていないアダプタを確認します。詳細をクリップボードにコピーするには、をクリックします。

サポートされていないRESTタイプ

• メタデータ・カタログURL
• Swagger定義URL
• RAML定義URL

「詳細」を展開して、使用しているサポートされていないRESTタイプを確認します。詳細をクリップボードにコピーするには、をクリックします。

もう1つのオプションは、RESTアダプタ接続で使用するRAMLをOpenAPI仕様に変換することです。

Swagger/OpenAPI仕様に対するより堅牢で完全なサポートを提供するために、RESTアダプタには、すべてのOpenAPI仕様を1つのフィールドに指定する統合オプションが含まれています。このオプションは、使用できなくなったSwagger定義URLを指定するためのオプションも置き換えます。

カスタム・エンドポイントURL

カスタム・エンドポイントがあり、Visual Builderを使用している場合:

1. アップグレードを続行するには、Visual Builderのアップグレード前タスクを完了します。
2. アップグレード中に、アップグレード・プロセスによって、カスタム・エンドポイントおよびVisual Builder内の代替カスタム・エンドポイントが構成されます。

VBCS

Visual Builderを独自のOracleデータベース・インスタンス(BYODB)とともに使用する場合、アップグレード中にAutonomous Transaction Processing (ATP)が稼働している必要があります。

スムーズなアップグレードの場合は、Oracle Integration 3でのOracle Visual Builderの管理のアップグレードのためのVisual Builderの準備で説明されているタスクを完了します。

アップグレード前に指定したタスクを完了しないと、アップグレード後に即時停止および接続の問題が発生する可能性があります。アップグレード後にこれらの問題を解決するには、追加のタスクを実行し、My Oracle Supportでサービス・リクエスト(SR)を送信する必要がある場合があります。

プロセス自動化

機能の相違点

Oracle Integration Generation 2のProcessとOracle Integration 3のProcess Automationにはいくつかの違いがあります。プロセスに関するFAQを参照してください。

Oracle Integration Generation 2でのプロセスの使用方法に応じて、別のオプションを使用してアップグレードまたは移行します。アップグレード・オプションの処理を参照してください。

Oracle Content Management

プロセスがOracle Content Management (OCM)と統合されている場合は、新しいホスト名を使用するようにOCMの統合設定を更新する必要があります。そうしないと、問題が発生します。「詳細...」を展開して、新しいホスト名を取得します。

Visual Builder

プロセスを呼び出すVisual Builderアプリケーションがある場合は、段階的なアップグレードのアップグレード前のステップを完了して、Visual Builderアプリケーションを更新します。

OAuthセキュリティ・ポリシーまたはBasic Authセキュリティ・ポリシーのみで構成されたRESTトリガーとの統合をコールするプロセスがある場合、アップグレード後の失敗を回避するために、OAuthおよびBasic Authを使用するように更新する必要があります。

統合アクティビティを使用した動的プロセス・コールは、フェーズ・アップグレード後は機能しません。そのため、サービス・アクティビティ接続を使用して統合をコールするように、動的プロセスを更新する必要があります。フェーズ・アップグレードの前にこれを行わないと、アップグレード後にサービスの中断が発生する可能性があります。

SOAP接続(WSDL URL)またはREST接続を使用してOracle Integration Generation 2プロセスを呼び出す統合がある場合は、基本認証セキュリティ・ポリシーを使用するように統合を更新して、段階的なアップグレード後にアップグレード後の失敗を回避する必要があります。