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

インスタンスへのアクセスの確認

アップグレード直後

1. 新しいOracle Integration 3インスタンスの確認
2. 新しいOCIDでIAMポリシーを更新します
3. 新しいインスタンスのURLを取得し、共有します

接続性の確保

アップグレード直後

1. 完全なネットワーク・ルール構成
2. 接続用の新しいアイデンティティ証明書のアップロード
3. アップグレードされなかったエージェントとの接続を再取得
4. ファイル・サーバー: 内部ファイアウォール許可リストにファイル・サーバーのIPアドレスを追加します

   このタスクは、アップグレード後1週間以内に完了してください。

5. ファイル・サーバー: 新しいIPおよびポート値を使用するように統合およびSFTPクライアントを更新します

   このタスクは、アップグレード後1週間以内に完了してください。

統合作業の保証

アップグレード直後

1. Oracle Integration 3コールの開発者APIを基本認証からOAuthに変更
2. 「アクティブ化の失敗を無視」または「開始スケジュールの失敗を無視」を選択した場合、統合をチェックします
3. アップグレードの停止時間中に拒否されたリクエストを処理します。
4. サービス・インスタンス名の変更
5. 統合がサポートされる最新の形式に更新されるようにします。

無視された事前チェックの失敗に対するアップグレード後のタスクの完了

アップグレード直後

Oracle Visual Builderのアップグレード後のタスクの完了

アップグレード直後

アップグレード後のプロセス自動化タスクの完了

アップグレード直後

アップグレード後の検証の完了

アップグレードから2週間以内

新しいOracle Integration 3インスタンスの確認

インタフェースが次のようになっている場合、アップグレードは完了しました。

新しいOCIDでIAMポリシーを更新します

IAMポリシー管理者

1. Oracle Cloudコンソールにサインインします。
2. Oracle Integration 3インスタンスのOCID値を取得する。インスタンスの詳細の表示を参照してください。
3. IAMポリシーのOCIDを更新します。既存のポリシーの文を更新する手順は、Oracle Cloud Infrastructureドキュメントのコンソールの使用を参照してください。

新しいインスタンスのURLを取得し、共有します

https://design.integration.region.ocp.oraclecloud.com/?integrationInstance=query_parameter_repersenting_instance

新しいURLを取得するには:

1. Oracle Cloudコンソールにサインオンします。
2. ナビゲーション・メニューを開き、「開発者サービス」をクリックします。
3. 「アプリケーション統合」で、「統合」をクリックします。
4. 新しいOracle Integration 3インスタンスの名前をクリックします。
5. 「サービス・コンソールURL」フィールドの右側にある「コピー」をクリックします。
6. URLを必要とする人と共有します。

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

1. Oracle Cloudコンソールにサインインします。
2. Oracle Integration 3インスタンスのOCID値を取得します。

   インスタンスの詳細の表示を参照してください。

3. ターゲット・サービスのルールに従います。たとえば、Oracle Autonomous AI Database Serverlessの場合は、Oracle Autonomous AI Database Serverlessの使用のインスタンスのプロビジョニングまたはクローニング時のアクセス制御リストの構成を参照してください。
4. アクセスしているOracle Cloud InfrastructureサービスがOracle Integrationインスタンスとは異なるリージョンにある場合は、アップグレード前に他の許可リストを更新したときに収集したOICアウトバウンドIP・アドレスを許可リストに登録します。

接続用の新しいアイデンティティ証明書のアップロード

これらのステップを実行する必要があるのは、組織の1人の個人のみです

インスタンスにアイデンティティ証明書を使用する接続が含まれている場合、アイデンティティ証明書はアップグレード中に削除されるため、新しいアイデンティティ証明書を生成して新しいJKSを構成する必要があります。

次のステップを実行して、新しいアイデンティティ証明書をアップロードし、アイデンティティ証明書を使用する接続をテストし、接続を使用する統合をアクティブ化します。

1. 新しいアイデンティティ証明書をアップロードします。

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

2. アイデンティティ証明書を使用する接続をテストして、ステータスが「ドラフト」から「構成済」に変更されるようにします。

   Oracle Integration 3での統合の使用の接続のテストを参照してください。

3. 接続を使用する統合をアクティブ化します。

   Oracle Integration 3での統合の使用の統合をアクティブ化を参照してください。

アップグレードされなかったエージェントとの接続を再取得

前提条件

接続エージェントからOracle Cloud Infrastructure Identity and Access Management (IAM)およびOracle Integration 3への接続を保証します:

• 許可リストの更新の説明に従って、アップグレード前にIAMおよびOracle Integration 3のIPアドレスを許可リストに追加しておく必要があります。
• Oracle Integration 3の設計時IPアドレスを許可リストに追加します。次のコマンドを使用して設計時IPアドレスを取得し、regionをOracle Integration 3 URLのリージョンに置き換えます:

  nslookup design.integration.region.ocp.oraclecloud.com

エージェントを手動でアップグレードし、エージェントとの接続を取り戻すには:

1. 接続エージェントを停止します。
2. エージェントの前提条件が満たされていることを確認します。
   1. 接続エージェントがJDK 17を使用していることを確認します。そうでない場合は、JAVA_HOMEおよびPATH環境変数をJDK17に設定します。
   2. エージェントがPKCS12キーストアを使用していることを確認します。そうでない場合は、次のステップを使用して変換します。
      1. 接続エージェントをホストするサーバーで、次のフォルダにあるkeystore.jksファイルのバックアップを作成します。

         Agent_Install_Location/agenthome/agent/cert

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

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

      4. 次の場所にあるkeystore.jksファイルを削除します。

         Agent_Install_Location/agenthome/agent/cert

3. Oracle Integration 3からエージェント・インストーラZIPファイルをダウンロードします。
   1. ナビゲーション・ペインで、「設計」、「エージェント」の順にクリックします。
   2. 「ダウンロード」、「接続エージェント」の順にクリックします。
4. 接続性エージェント・サーバー上の新しいディレクトリにoic_conn_agent_installer.zipを抽出します。
5. Agent_Install_Location/agenthome/の下の既存の接続性エージェントlibフォルダを削除し、ZIPファイルのlibフォルダに置き換えます。
6. Agent_Install_Location/agenthome/の下の既存のversionファイルを削除し、ZIPファイルのversionファイルに置き換えます。
7. Agent_Install_Locationの下の既存のconnectivityagent.jarファイルを削除し、ZIPファイルのconnectivityagent.jarファイルに置き換えます。
8. Agent_Install_Locationの下の既存のcpi_upgradeutility.jarファイルを削除し、ZIPファイルのcpi_upgradeutility.jarファイルに置き換えます。
9. Oracle Integration 3の「エージェント」ページで、エージェント・グループにマウス・ポインタを重ねて、「アクション」 をクリックし、「構成のダウンロード」を選択します。

   このステップでは、エージェント・グループの事前構成済のInstallerProfile.cfgファイルがダウンロードされます。

10. Agent_Install_Locationにある既存のInstallerProfile.cfgファイルを削除し、前のステップでダウンロードしたInstallerProfile.cfgファイルに置き換えます。
11. 次のコマンドを実行して、接続性エージェントを再起動します:

    java -jar connectivityagent.jar

12. アップグレードされたエージェント・グループ内の統合を再アクティブ化します。

ファイル・サーバー: 内部ファイアウォール許可リストにファイル・サーバーのIPアドレスを追加します

Oracle Integration Generation 2のIPアドレスは、アップグレード後4か月間動作を続け、Oracleによってリタイアされます。ただし、Oracleでは、新しいIPアドレスを使用するようにファイアウォール許可リストを更新することをお薦めします。これにより、将来許可リストを更新することを忘れるリスクはありません。

ファイル・サーバーのIPアドレスを取得するには:

1. Oracle Integration 3にサインインします。
2. ナビゲーション・ペインで、「設定」、「ファイル・サーバー」、「設定」の順にクリックします。
3. 「一般」で、ファイル・サーバーのSFTPサーバーのIPアドレスを取得します。

ファイル・サーバー: 新しいIPおよびポート値を使用するように統合およびSFTPクライアントを更新します

Oracle Integration Generation 2のIP値およびポート値は、アップグレード後4か月間動作し続け、Oracleによってリタイアされます。ただし、Oracleでは、今すぐ新しい値を使用するように統合およびSFTPクライアントを更新することをお薦めします。これにより、将来これらの値を更新することを忘れるリスクがなくなります。

1. Oracle Integration 3にサインインします。
2. ナビゲーション・ペインで、「設定」、「ファイル・サーバー」、「設定」の順にクリックします。
3. 「一般」で、ファイル・サーバーのSFTPサーバーのIPおよびポートの値を取得します。
4. ファイル・サーバーをコールするすべての統合を更新して、新しいIPおよびポートの値を使用するようにします。
5. 新しいIPおよびポートの値を使用するように、すべてのSFTPクライアントを更新します。

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のセキュリティ、認証および認可を参照してください。

「アクティブ化失敗の無視」または「開始スケジュール失敗の無視」を選択した場合、統合をチェックします

• 「アクティブ化の失敗を無視」を選択した場合は、すべての統合のステータスを確認し、必要に応じて統合をアクティブ化します。
• 「開始スケジュール失敗を無視」を選択した場合は、統合のスケジュールを確認し、必要に応じて手動で開始します。

アップグレードの停止時間中に拒否されたリクエストを処理します。

Oracle Integrationは、アップグレード・ダウンタイム中に送信されたすべてのリクエストを却下しました。必要に応じて、ダウンタイム中にクライアントがOracle Integrationに送信したリクエストに対するアクションを実行します。

サービス・インスタンス名の変更

Oracle Integration Generation 2からOracle Integration 3にアップグレードすると、テナンシ名がサービス・インスタンス名(サービス・インスタンス表示名)の最後に<service instance name>-<tenancy name>という形式で追加されます。たとえば、サービス・インスタンス名がmyinstanceで、テナンシ名がmytenancyの場合、Oracle Integration 3にアップグレードすると、myinstance-mytenancyに変更されます。そのため、統合でサービス・インスタンス名を使用する場合は、新しいサービス・インスタンス名を使用するように統合を更新してください。そうしないと、統合は失敗します。

統合がサポートされる最新の形式に更新されるようにします。

前述のステップを実行せずに統合をアクティブ化すると、ランタイム・インスタンスで問題が発生する可能性があります。

• Oracle CX SalesおよびB2Bサービス・アダプタ
• Oracle ERP Cloudアダプタ
• Oracle HCM Cloudアダプタ
• Oracle Fusion Field Serviceアダプタ
• Salesforceアダプタ
• ServiceNowアダプタ

基本的なルーティング統合:基本ルーティング統合は、Oracle Integration 3ではサポートされておらず、空白のキャンバスが表示されます。これらの統合を削除し、アプリケーション駆動の統合として再作成する必要があります。

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

削除されたサポートされていないアダプタ接続を置き換えるには、RESTアダプタ接続を作成する必要があります。

これらの統合は、次のステップを使用して再処理する必要があります。

1. サポートされていないアダプタ接続に対応する呼出しを削除し、新しいRESTアダプタ接続に置き換えます。
2. 統合を構成してアクティブ化した後、スケジュールを開始します。

削除したカスタム・アダプタ接続を置き換えるには、同等のOracle Integration 3アダプタを使用して新しい接続を作成する必要があります。

これらの統合は、次のステップを使用して再処理する必要があります。

1. カスタム・アダプタ接続に対応する呼出しを削除し、作成した新しい接続に置き換えます。
2. 統合を構成してアクティブ化した後、スケジュールを開始します。

これらの統合は、このパターンを使用しないように修正する必要があります。たとえば、listFile操作を使用してファイルをリストし、for-eachアクションを使用して各ファイルを個別に読み取ります。

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

これらの接続は、次のいずれかの方法を使用して更新する必要があります。

• RAMLまたはOracleメタデータ・カタログを使用している場合は、Swagger定義をRESTサービス・プロバイダに問い合せることができます(使用可能な場合)。これはすべてのOracle Fusion Applicationsのガイドラインであるため、Oracle Fusion ApplicationsにはSwaggerオプションが必要です。

  代替仕様が使用できない場合は、接続URLとしてREST APIベースURLを選択し、アダプタ・エンドポイント構成ウィザードを使用してターゲットAPIリクエストを定義することで、RESTアダプタの基本テンプレートを使用します。

• RAMLを使用する場合の別のオプションは、RAMLをOpenAPI仕様に変換することです。
• Swagger定義URLを使用していた場合は、RESTアダプタの新しい統合オプションを使用して、すべてのOpenAPI仕様を1つのフィールドに指定できます。このオプションは、Swagger/OpenAPI仕様をより堅牢かつ完全にサポートします。

Oracle Integration 3におけるRESTアダプタの使用の接続呼出しのための接続プロパティの構成を参照してください。

これらの統合は、次のステップを使用して再処理する必要があります。

1. 統合をアクティブ化します
2. 統合がアクティブ化された後、スケジュールを開始します。

カスタム・エンドポイントを再作成する必要があります。

ノート:アップグレード後に、Oracle Visual BuilderとOracle Integrationの両方に同じカスタム・エンドポイントを使用することはできません。同じカスタム・エンドポイントを使用する場合、問題が発生する可能性があります。

追加のアップグレード後のタスクの完了

統合インスタンスIDを英数字に変更するには、完全な更新が必要です

この変更は、整数である統合インスタンスIDに基づく統合フローに影響します(たとえば、統合インスタンスIDが数値データ型のデータベース列で解析される場合)。アップグレード後に、アップグレード設定で「数値アップグレード後フローIDの有効化」を選択せずにこれらの統合を変更せずに実行すると、変換例外エラーが発生します。

Conversion Exception Description: The object […], of class [class java.lang.String], could not be converted to [class java.math.BigDecimal].

変更に対応するには、影響を受ける各統合でマッピングを更新するか、データベースに統合インスタンスIDを格納する列のデータ型を更新できます。

ノート:ここで説明する推奨方法は、Oracleデータベース・サービス(Oracle Autonomous AI Databaseなど)に基づいています。他のデータベース・タイプには、追加のステップが必要になる場合があります。

方法1: 影響を受ける各統合でマッピングを更新する

影響を受ける各統合で、統合インスタンスID値を含むターゲット属性を新しい数値UNIX時間にマップします。UNIX時間とは、1970年1月1日の00:00:00 UTCから開始して、UNIXエポックから経過した秒数を示します。この値は毎秒増分されます。値は整数として解析できるため、データベースの変更は必要ありません。

アップグレードの前に、インスタンスIDアクションの事前チェックの説明に従って、影響を受ける統合を確認しておく必要があります。

影響を受ける各統合に対して次のステップを実行します。

1. アクティブな統合は編集できないため、統合がアクティブな場合は非アクティブ化してください。
2. 統合を開きます。
3. 統合インスタンスIDを含むマップをダブルクリックします。
4. 統合インスタンスID値を含むターゲット属性を検索し、それをクリックします。
5. 「式ビルダー」で、をクリックします。
6. 次の式を入力します。

   floor (((fn:current-dateTime() - xsd:dateTime ("1970-01-01T00:00:00" )) div xsd:dayTimeDuration ("PT1S" )) ) 

7. クリック
   
   
   
   式を保存する。
8. 統合キャンバスに戻り、変更を保存します。

方法2: データベース内の影響を受ける列のデータ型を更新する

データベースで、統合インスタンスIDを保持する列のデータ型をstring (CHAR/VARCHAR)に変更します。このアプローチには、統合の変更は含まれません。

ノート: 解決策は、操作「SQL文の実行」を使用して作成されたデータベース・アクションに制限されます。

データベース列はすでに移入されているため、列のデータ型のみを変更することはできません。かわりに、次のステップを実行します。SQL Developerで次のステップを実行します。

1. 「インスタンスID」列名をノートにとります。
2. VARCHAR型の一時列(TEMPなど)を追加します。

   SQL構文:

   ALTER TABLE table-name ADD temporary-column VARCHAR2(50);

   例:

   ALTER TABLE FLOW_MANAGEMENT ADD TEMP VARCHAR2(50);

3. ソース列(インスタンスIDを含む列)から一時列に値をコピーします。

   SQL構文:

   UPDATE table-name SET temporary-column-name = source-column-name

   例:

   UPDATE FLOW_MANAGEMENT SET TEMP = FLOWID;

4. ソース列の値をNULLに設定します。

   SQL構文:

   UPDATE table-name SET source-column-name = NULL;

   例:

   UPDATE FLOW_MANAGEMENT SET FLOWID = NULL;

5. ソース列タイプをNUMBERからVARCHARに更新します。

   SQL構文:

   ALTER TABLE table-name MODIFY source-column-name VARCHAR2(50);

   例:

   ALTER TABLE FLOW_MANAGEMENT MODIFY FLOWID VARCHAR2(50);

6. 一時列からソース列にインスタンスID値をコピーして戻します。

   SQL構文:

   UPDATE TABLE table-name SET source-column-name = temporary-column-name

   例:

   UPDATE FLOW_MANAGEMENT SET FLOWID = TEMP;

7. 一時列を削除します。

   SQL構文:

   ALTER TABLE table-name DROP COLUMN temporary-column-name;

   例:

   ALTER TABLE FLOW_MANAGEMENT DROP COLUMN TEMP;

1. Oracle Integrationに管理者としてサインインしてください。
2. 「Settings」、「Miscellaneous」の順にクリックします。
3. フローIDタイプを「英数字」に変更し、「保存」をクリックします。

アップグレード後の検証タスクの完了

回帰テストの実行など、組織のアップグレード後の検証タスクを完了します。

統合を本番インスタンスに移動する前に、開発/ステージ・インスタンスで統合負荷テストを実行します。