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

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

アップグレード直後

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

接続性の確保

アップグレード直後

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

   アップグレード後1週間以内にこのタスクを完了します。

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

   アップグレード後1週間以内にこのタスクを完了します。

統合作業を保証

アップグレード直後

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

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

アップグレード直後

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

アップグレード直後

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

アップグレード直後

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

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

新しいOracle Integration 3インスタンスを確認します

インタフェースが次のようになると、アップグレードが完了します。

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

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 Database Serverlessの場合は、Oracle Autonomous 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 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. 次の場所のkeystore.jksファイルを削除します。

         Agent_Install_Location/agenthome/agent/cert

3. エージェント・インストーラのZIPファイルをOracle Integration 3からダウンロードします。
   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コールのDeveloper 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 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. 統合がアクティブ化された後、スケジュールを開始します。

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

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

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

統合インスタンスIDの英数字への変更に必要な完全な更新

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

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

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

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

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

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

アップグレードする前に、インスタンス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. 「設定」、「その他」の順にクリックします。
3. フローIDタイプを「英数字」に変更し、「保存」をクリックします。

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

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

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