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

Oracleでは、アップグレードが円滑に実行されるように、いくつかの事前チェックを定期的に実行してアップグレードの準備状況を確認します。事前チェックに合格しない場合は、問題を修正するためにタスクの実行が必要になる場合があります。

事前チェックの問題を修正したら、アップグレード設定を構成します。

事前チェック・ステータスの表示

事前チェック・ステータスを確認するか、チェックを再度実行するには、次のステップを実行します。

  1. ナビゲーション・ペインで、「設定」「アップグレード」の順にクリックします。

    最後に完了した事前チェックが準備状況チェック表の上に表示されるのはいつですか。

    準備状況チェック表には、事前チェック項目のステータスに関する次の情報が表示されます。

    説明
    適格性条件 アップグレードの準備が整うために満たす必要がある条件。一部の条件には、関連するドキュメントへのリンクが含まれています。
    所有者 条件の管理を担当するユーザー。
    終了予定日 条件を満たす日付。
    適格ステータス 満たされていない条件の説明を含む、条件のステータス。「詳細...」を展開して、条件失敗に関する追加情報を表示します。詳細をクリップボードにコピーするには、「コピー」アイコンをクリックします。
  2. 合格しなかった事前チェックがある場合は、関連するタスクを実行して問題を修正します。
  3. 事前チェックを再実行するには、「再チェック」をクリックします。

    事前チェックが完了するまでに約1時間かかります。

ノート

Oracleがインスタンスをアップグレードしようとすると、その試行の詳細は、準備状況チェック表のすぐ下にある「アップグレード・サマリー」に表示されます。

接続性エージェント事前チェック

適格性条件 一般的な所有者 政府リージョンに適用可能 完了するタスク

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

開発運用チーム はい 接続エージェントがJDK 17およびPKCS12 KeyStoreを使用していることを確認します。「詳細」を展開して、レビューが必要な接続エージェントを表示します。詳細をクリップボードにコピーするには、「コピー」アイコンをクリックします。「接続エージェント・ステータス」セクションを表示して、インスタンス内のすべての接続エージェントのステータスを確認することもできます。
  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識別子

開発運用チーム はい エージェント・グループの識別子に領域がある場合、それらはOracle Integration 3に移行されません。エージェント・グループが必要な場合は、アップグレード後に再作成する必要があります。

インスタンス事前チェック

適格性条件 一般的な所有者 政府リージョンに適用可能 完了するタスク

カスタム・エンドポイント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が、Oracle Integration 3の数値から英数字の値に変更されました。値のデータ型は変更されず、文字列データ型のままです。英数字の値を変更すると、インスタンスIDが数値であることに依存するシステムに影響を与える可能性があります。たとえば、REST APIからインスタンスIDを解析し、インスタンスIDを数値フィールドとしてデータベースに格納する場合は、データベース・フィールドを更新する必要があります。アップグレード設定を構成するときに、インスタンスIDを数値として保持するように選択できます。FlowId Conversion Supportを参照してください。

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

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

日次電子メール制限

アドミニストレータ はい Oracle Integration 3では、サービス制限で説明されているように、24時間ローリング・ウィンドウで10,000通の電子メールを送信できます。デプロイメントでそれ以上の送信が必要な場合は、かわりに顧客テナンシを使用できます。通知電子メールの構成を参照してください。

IDCSのカスタム・スコープ

アドミニストレータ いいえ Oracle Integration 3では、インスタンスの作成時にOracle Identity Cloud Service (IDCS)にデフォルトのスコープ(/ic/api/ , urn:opc:resource:consumer::all)が追加されます。IDCSに追加された他のカスタム・スコープはサポートされていません。IDCSでカスタム・スコープを作成した場合は、それらを削除する必要があります。

その他の失敗

異なる はい 特定の事前チェックがないアップグレードをブロックする他の問題がある場合は、他の障害に含まれます。「詳細」を展開して、アクションが必要な問題を確認します。詳細をクリップボードにコピーするには、「コピー」アイコンをクリックします。

B2B (Oracle Integrationの事前チェックの場合)

適格性条件 一般的な所有者 政府リージョンに適用可能 完了するタスク

B2B保存期間

アドミニストレータ いいえ この事前チェック・ステータスを修正するために何もする必要はありませんが、Oracle Integration 3 StandardおよびEnterpriseエディションでは、デフォルトで32日間のデータ保持がサポートされることに注意してください。アップグレード中は、最新の32日間の保持データのみが移行されます。「詳細」を展開して、現在保持されているデータの日数を確認します。詳細をクリップボードにコピーするには、「コピー」アイコンをクリックします。

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

統合事前チェック

適格性条件 一般的な所有者 政府リージョンに適用可能 完了するタスク

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

開発チーム はい 遅延(非同期)レスポンス・パターンは、以前、次のアダプタでサポートされていました。
  • Oracle CX Sales and B2B Serviceアダプタ
  • Oracle ERP Cloudアダプタ
  • Oracle HCM Cloudアダプタ
  • Oracle Field Service Cloudアダプタ
  • Salesforceアダプタ
  • ServiceNowアダプタ
これらのアダプタのいずれかとの遅延(非同期)レスポンスを使用した統合がある場合は、2つの呼出し接続を作成して再処理し、同様の機能を実現します。
  1. 成功コールバックの単純な起動を作成します。
  2. フォルト・ハンドラの下に失敗コールバックの追加起動を作成して、正しいフォルトを捕捉します。

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

アイデンティティ証明書

開発チーム はい アイデンティティ証明書は、双方向SSL通信中にクライアント・アイデンティティを確立します。AS2アダプタおよびRESTアダプタに基づく接続では、アイデンティティ証明書を使用できます。

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

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

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

開発チーム はい ソース・エンドポイント名とターゲット・エンドポイント名が同じ基本ルーティング統合がインスタンスに含まれている場合は、次のステップを実行します。
  1. 基本的なルーティング統合を編集し、ターゲット・エンドポイントを削除して、別の名前で再度追加します。
  2. 統合を保存します。

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

複数読取りファイル

開発チーム はい 複数ファイルの読取り操作は、Oracle Integration Generation 2で非推奨になりました。

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

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

開発チーム はい

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

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

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

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

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

開発チーム はい インスタンスに、基本認証によるREST接続を使用してDT (設計時)組込みAPIにアクセスする統合が含まれている場合は、OAuthを使用するようにそれらを変更する必要があります。

Oracle Integration Generation 2では、基本認証を使用してOracle Integration REST APIおよびファイル・サーバーREST APIを使用できます。Oracle Integration 3では、OAuthを使用する必要があります。OAuthを使用して接続するには、Oracle Integration REST APIまたはファイル・サーバー REST APIを使用するクライアント、スクリプト、統合およびコマンドを更新する必要があります。認証方法のサポートの詳細は、「Oracle Integration 3で基本認証がサポートされるタイミング」を参照してください。Oracle Integration REST APIでのOAuthの使用の詳細は、セキュリティ、認証および認可、またはファイル・サーバーREST APIでの使用の詳細は、セキュリティ、認証および認可を参照してください。

アダプタの事前チェック

適格性条件 一般的な所有者 政府リージョンに適用可能 完了するタスク

カスタム・アダプタ

開発チーム いいえ カスタム・アダプタを使用する統合がインスタンスに含まれている場合、インスタンスをまだアップグレードできません。Oracleがこの機能のアップグレードを開始するまで待機します。「詳細」を展開して、使用しているカスタム・アダプタを表示します。詳細をクリップボードにコピーするには、「コピー」アイコンをクリックします。

Oracle Utilitiesアダプタ

開発チーム はい Swagger 2.0は、Oracle Utilitiesアダプタでサポートされなくなりました。Swagger 2.0 RESTカタログを使用する既存の統合がある場合、ランタイムは影響を受けません。ただし、設計時接続の編集、接続の再テスト、メタデータのリフレッシュ、アーティファクトのリフレッシュまたは再アクティブ化を試行すると、統合は失敗します。OpenAPI 3.x定義を使用するようにカタログを更新する必要があります。「詳細」を展開して、レビューが必要な統合を表示します。詳細をクリップボードにコピーするには、「コピー」アイコンをクリックします。Oracle Utilities Adapterバージョン24.04.0以上でのSwagger 2.0 RESTカタログの使用を参照してください。

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

開発チーム はい Oracle Integration 3でサポートされていない次のアダプタを使用する統合がインスタンスに含まれている場合は、アダプタをRESTアダプタに置き換えます:
  • Automation Anywhereアダプタ
  • Evernoteアダプタ
  • Oracle Messaging Cloud Serviceアダプタ
  • Oracle Monetization Cloudアダプタ
  • Oracle Taleo Business Edition (TBE)アダプタ
  • UiPathロボティック・プロセス・オートメーション・アダプタ

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

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

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

開発チーム はい 次の接続タイプは非推奨であり、RESTアダプタ接続ではサポートされていません。これらの接続タイプを異なる接続タイプに置き換えます。Oracle Integration 3でのRESTアダプタの使用接続の起動のための接続プロパティの構成を参照してください。
  • メタデータ・カタログURL
  • Swagger定義URL
  • RAML定義URL

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

RAMLまたはOracleメタデータ・カタログを使用して記述されたREST APIを使用する開発者は、次のアクションを実行する必要があります。
  1. RESTサービス・プロバイダに問い合せて、Swagger定義を要求します(使用可能な場合)。Oracle Fusion Applicationsには、使用可能なSwaggerオプションが必要です。これは、すべてのOracle Fusion Applicationsのガイドラインです。
  2. 代替仕様を使用できない場合は、接続URLとしてREST APIベースURLを選択し、アダプタ・エンドポイント構成ウィザードを使用してターゲットAPIリクエストを定義することで、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の準備で説明されている追加のタスクを完了してください。

プロセス自動化の事前チェック

適格性条件 一般的な所有者 政府リージョンに適用可能 完了するタスク

プロセス自動化

アドミニストレータ いいえ

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

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

プロセス処理

アドミニストレータ いいえ

統合で「プロセス」処理を使用している場合は、アップグレード前に「プロセス」処理を置換または削除する必要があります。状況に応じた「アップグレード・オプションの処理」で説明されている方法を使用します。

準備状況チェックに失敗したインスタンスの修正

アップグレードがスケジュールされていて、インスタンスをアップグレードする準備ができていない場合は、結果に対処して、アップグレードが正常に完了します。

  1. Oracle Integrationで、次のいずれかのステップを使用して「アップグレード」ページを開きます:
    • ナビゲーション・ペインで、「設定」「アップグレード」の順にクリックします。
    • 「お知らせ」 「お知らせ」アイコンをクリックし、通知のリンクをクリックします。
    「アップグレード」ページが表示されます。

    スクリーンショットは、準備状況チェックが失敗したことを示すメッセージが表示された「アップグレード」ページと、適格性条件とそのステータスのリストを示しています。準備状況チェックを再実行するための「再確認」ボタンがあります。

  2. 合格しなかった条件をレビューし、適切な処置を実行します。実行するステップは、アップグレード準備状況の確認および事前チェックの問題の修正を参照してください。
  3. すべての問題に対処したら、インスタンスを再度確認してください。
    1. 「再チェック」をクリックします。
      チェックが完了するまでに約1時間かかります。最後に完了したチェックが準備状況チェック表の上に表示されるのはいつですか。
    2. チェックに合格するまで、修正を引き続き行います。
      問題の修正方法が不明な場合は、My Oracle Supportでサービス・リクエスト(SR)を入力します。