アップグレード後のタスクの完了
Oracleは、最初にOracle Integration Generation 2開発インスタンスをアップグレードします。 アップグレード日から3日以内にすべてのアップグレード後タスクを完了して、問題をレポートできるようにします。 Oracleは、開発インスタンスの約3週間後に本番インスタンスをアップグレードします。
アップグレード後のタスクの完了は、ユーザーが新しいインスタンスにアクセスできるようにし、統合との間で送受信されるデータをファイアウォールを介して送信し、統合が期待どおりに機能するようにするために重要です。
アップグレード後に問題が発生した場合は、My Oracle Supportにサービス・リクエスト(SR)を入力するか、問題をトラブルシューティングします。 「アップグレードの問題のトラブルシューティング」を参照してください。
ノート:
アップグレード後、停止したOracle Integration Generation 2インスタンスがOracle Cloudコンソールに表示されます。 このインスタンスを更新、起動または削除しないでください。 不要になった場合は、Oracleによってユーザーのかわりに削除されます。アップグレード後のタスクのサマリー
| 影響 | 時期 | 完了するタスク |
|---|---|---|
|
インスタンスへのアクセスの保証 |
アップグレード直後 |
|
|
接続性を確保 |
アップグレード直後 |
|
|
統合作業の確保 |
アップグレード直後 |
|
|
無視された事前チェック失敗に対するアップグレード後のタスクの完了 |
アップグレード直後 |
無視された事前チェック失敗のアップグレード後のタスクの完了 |
|
アップグレード後のVisual Builderタスクの完了 |
アップグレード直後 |
Visual Builderのアップグレード後のタスクの完了 |
|
アップグレード後の「プロセス自動化」タスクの完了 |
アップグレード直後 |
プロセス自動化のアップグレード後のタスクの完了 |
| 統合インスタンスIDのアップグレード後更新の完了 | アップグレードから6か月以内 | 統合インスタンスIDの変更に必要な更新の実行 |
|
アップグレード後の検証の完了 |
2週間以内のアップグレード |
組織の検証手順に従う |
インスタンスへのアクセスの確認
| タスク | 作成者 | 時期 | 完了するタスク |
|---|---|---|---|
|
新しいOracle Integration 3インスタンスを確認 |
管理者 | アップグレード直後 | 既存の資格証明を使用してOracle Integration 3インスタンスにサインインします。 既存のOracle Integration Generation 2ブックマーク(新しいURLにリダイレクトされる)を使用するか、Oracle Integration 3インスタンスの新しいURLを使用します。 「Oracle Integrationインスタンスへのアクセス」を参照してください。
インタフェースが次のようになると、アップグレードが完了します: 次の場合は、アップグレードが進行中です:
|
|
新しいOCIDでIAMポリシーを更新 |
IAMポリシー管理者 |
アップグレード直後 | 組織がインスタンスのOracle Cloud ID (OCID)に基づいてOracle Integration Generation 2インスタンスへのアクセスを制限している場合は、IAMポリシーを更新して新しいOracle Integration 3インスタンスOCIDを指すようにします。
注意: IAMポリシーのOCIDを更新するまで、ユーザーはOracle Integration 3にサインインできません。
|
|
新しいインスタンスのURLを取得し、共有 |
管理者 | アップグレード直後 | 新しいOracle Integration 3インスタンスのURLを取得し、それを必要とするすべてのユーザーと共有します。 既存のブックマークも新しいURLにリダイレクトされますが、すべてのユーザーが新しいURLを持っていることを確認する必要があります。 これは、次の形式です:
新しいURLを取得するには:
|
接続性の確保
| タスク | 作成者 | 時期 | 完了するタスク |
|---|---|---|---|
|
完全なネットワーク・ルール構成 |
ネットワーク管理者 | アップグレード前またはアップグレード直後 | 統合接続のいずれかで、Oracle Cloud Infrastructureオブジェクト・ストレージやOracle Autonomous Databaseなどのネットワーク・ルールをサポートするOracle Cloud Infrastructureサービスをターゲットとし、それらのルールを有効にした場合は、Oracle IntegrationサービスVCNをルールに追加するなど、ネットワーク・ルールの構成を完了する必要があります。
|
|
接続用の新しいアイデンティティ証明書のアップロード |
アイデンティティ証明書を使用する接続を持つ開発者
これらのステップを実行する必要があるのは、組織の1人のユーザーのみです |
アップグレード直後 | アイデンティティ証明書は、双方向SSL通信中にクライアント・アイデンティティを確立します。 「AS2アダプタ」および「RESTアダプタ」に基づく接続では、アイデンティティ証明書を使用できます。
インスタンスにアイデンティティ証明書を使用する接続が含まれている場合、アイデンティティ証明書はアップグレード中に削除されるため、新しいアイデンティティ証明書を生成して新しいJKSを構成する必要があります。 次のステップを実行して、新しいアイデンティティ証明書をアップロードし、アイデンティティ証明書を使用する接続をテストし、接続を使用する統合をアクティブ化します:
|
|
アップグレードされていないエージェントとの接続を取り戻す |
アップグレードされていないエージェントを持つ開発者 | アップグレード直後 | アップグレード中に到達できなかったエージェント、またはアップグレード要件を満たさなかったエージェントはアップグレードされませんでした。 アップグレード後に、一部のエージェントがアップグレード適格を満たしておらず、アップグレードされなかったことを示すメッセージが表示された場合は、次のステップを実行します。
前提条件 接続エージェントからOracle Cloud Infrastructure Identity and Access Management (IAM)およびOracle Integration 3への接続を確認します:
エージェントを手動でアップグレードし、エージェントとの接続を再取得するには:
|
|
ファイル・サーバー: 内部ファイアウォール許可リストにファイル・サーバー IPアドレスを追加 |
「ファイル・サーバー」管理者および開発者 | アップグレードの1週間以内 | 組織で内部リソースがアクセスできるサイトが制限されている場合は、新しい「ファイル・サーバー」 IPアドレスを内部ファイアウォール許可リストに追加してください。
Oracle Integration Generation 2 IPアドレスは、アップグレード後4か月間機能し続け、その後Oracleによってリタイアされます。 ただし、Oracleでは、新しいIPアドレスを使用するようにファイアウォール許可リストを更新することをお薦めします。 これにより、将来許可リストを更新することを忘れるリスクはありません。 「ファイル・サーバー」 IPアドレスを取得するには:
|
|
ファイル・サーバー: 新しいIPおよびポート値を使用するように統合およびSFTPクライアントを更新 |
「ファイル・サーバー」管理者および開発者 | アップグレードの1週間以内 | 「ファイル・サーバー」を使用する場合は、新しいIPおよびポートの値を使用するように統合およびSFTPクライアントを更新します。
Oracle Integration Generation 2 IPおよびポートの値は、アップグレード後4か月間引き続き動作し、Oracleによってリタイアされます。 ただし、Oracleでは、新しい値を使用するように統合およびSFTPクライアントを更新することをお薦めします。 これによって、将来これらの値を更新することを忘れるリスクはありません。
|
統合作業の保証
| タスク | 作成者 | 時期 | 詳細 |
|---|---|---|---|
|
Developer API for Oracle Integration 3コールを基本認証からOAuthに変更します |
開発者 | アップグレード前またはアップグレード直後 | 前提条件またはアップグレード前のタスクの実行中にOAuthを使用するようにAPIコールをまだ更新していない場合は、アップグレード直後に実行します。
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で統合をアクティブ化できなかった場合やスケジュールを再起動できなかった場合でも、アップグレードを続行するには、「アップグレード設定を構成しました」で適切なステップを実行します:
|
|
アップグレード・ダウンタイム中に拒否されたリクエストを処理 |
指定されたチーム・メンバー | アップグレード直後 |
Oracle Integrationは、アップグレードの停止時間中に送信されたリクエストをすべて拒否しました。 必要に応じて、停止時間中にクライアントがOracle Integrationに送信したリクエストに対してアクションを実行します。 |
|
サービス・インスタンス名の変更 |
開発者 | アップグレード直後 |
Oracle Integration Generation 2からOracle Integration 3にアップグレードすると、サービス・インスタンス名(サービス・インスタンス表示名)の最後にテナンシ名が次の形式で追加されます: |
|
統合がサポートされている最新の形式に更新されていることを確認します |
開発者 | アップグレード直後 |
アップグレード前にOracle Integration Generation 2で構成された状態で統合があった場合は、アップグレード後に次のステップを完了して、これらの統合がサポートされている最新の形式であるOracle Integration 3に更新されていることを確認します:
前述のステップを実行せずに統合をアクティブ化すると、ランタイム・インスタンスで問題が発生する可能性があります。 |
無視された事前チェック失敗のアップグレード後のタスクの完了
事前チェックの失敗を無視するように選択した場合は、失敗した事前チェックに関連付けられたステップを実行します:
| 事前チェック | 接続タスク | 統合タスク | その他のタスク |
|---|---|---|---|
| 遅延(非同期)レスポンス | アップグレード後、次のいずれかのアダプタを使用して、遅延(非同期)レスポンスを使用した統合を再処理または再作成する必要があります:
アプリケーション主導の統合: アプリケーション主導の統合は、アップグレード中にドラフト状態に変更されます。 これらの統合は、次のステップを使用して再処理する必要があります:
基本的なルーティング統合: 基本的なルーティング統合はOracle Integration 3ではサポートされておらず、空白のキャンバスが表示されます。 これらの統合を削除し、アプリケーション主導の統合として再作成する必要があります。 |
||
| サポートされていないアダプタ | アップグレード中に、次のサポートされていないアダプタを使用した接続が削除されました:
RESTアダプタ接続を作成して、削除されたサポートされていないアダプタ接続を置き換える必要があります。 |
アップグレード中、サポートされていないアダプタを使用した統合はドラフト状態に変更され、スケジュールされた実行は取り消されます。
これらの統合は、次のステップを使用して再処理する必要があります:
|
|
| カスタム・アダプタ | アップグレード中に、カスタム・アダプタを使用した接続が削除されました。
削除されたカスタム・アダプタ接続を置き換えるには、同等のOracle Integration 3アダプタを使用して新しい接続を作成する必要があります。 |
アップグレード中、サポートされていないアダプタを使用した統合はドラフト状態に変更され、スケジュールされた実行は取り消されます。
これらの統合は、次のステップを使用して再処理する必要があります:
|
|
| 複数読取りファイル | アップグレード中に、複数ファイルの読取り操作を使用した統合がドラフト状態に変更されます。
これらの統合は、このパターンを使用しないように再処理する必要があります。 たとえば、listFile操作を使用してファイルをリストし、for-eachアクションを使用して各ファイルを個別に読み取ります。 |
||
| サポートされていないRESTタイプ | アップグレード中に、次のサポートされていないRESTタイプを使用した接続がドラフト状態に変更されました。
これらの接続は、次のいずれかのメソッドを使用して更新する必要があります:
「Oracle Integration 3でのRESTアダプタの使用」の「起動接続の接続プロパティの構成」を参照してください。 |
アップグレード中に、サポートされていないRESTタイプを使用した統合がドラフト状態に変更され、スケジュールされた実行が取り消されました。
これらの統合は、次のステップを使用して再処理する必要があります:
|
|
| 基本ルーティング重複アプリケーション名 | 基本的なルーティング統合はOracle Integration 3ではサポートされておらず、空白のキャンバスが表示されます。 これらの統合を削除し、アプリケーション主導の統合として再作成する必要があります。 | ||
| 公開/サブスクライブの統合 | メッセージの公開またはOracle Integrationからのメッセージのサブスクライブを行う統合は、イベント駆動型のオーケストレーションに変換する必要があります。 「パブリッシュ/サブスクライブ統合」の事前チェック手順に基づいて、統合を削除し、再作成する必要があります。 | ||
| カスタム・エンドポイントURL | アップグレード中にカスタム・エンドポイントが移行されませんでした。
カスタム・エンドポイントを再作成する必要があります。 |
Visual Builderのアップグレード後のタスクの完了
移行を完了するには、次のステップを実行します:
| タスク | 作成者 | 時期 | タスクの説明 |
|---|---|---|---|
| カスタム・エンドポイントのDNSレコードの更新 | 管理者 | アップグレード直後 |
Visual Builderを使用していて、インスタンスにWAF V2またはロード・バランサを使用するようにカスタム・エンドポイントが構成されている場合は、カスタム・エンドポイントDNSレコードのCNAMEをVisual Builderインスタンス・ホスト名またはVisual Builder Generation 2ロード・バランサのIPアドレスで更新します。 ロード・バランサを更新するには:
ノート: アップグレード後に、Visual BuilderとOracle Integrationの両方に同じカスタム・エンドポイントを使用することはできません。 同じカスタム・エンドポイントを使用すると、問題が発生する可能性があります。 |
|
アップグレード後の追加タスクの完了 |
開発運用チーム | アップグレード直後 | 「Oracle Integration 3でのOracle Visual Builderの管理」の「アップグレード後に完了するタスク」で説明されているタスクを実行します。 |
プロセス自動化のアップグレード後のタスクの完了
Oracle Integration 3の「プロセス自動化」への移行を完了するには、次のステップを実行します。
ノート:
「アクティブに使用されたプロセス・アプリケーションの手動移行」を実行した場合、これらのアップグレード後のタスクを実行する必要はありません。統合の再構成
インスタンスがアップグレードされると、プロセス・アクションはOracle Integration Generation 2プロセス・アクションからOracle Integration 3プロセス・アクションに変換され、統合はOracle Integration 3プロセス・アクションになりますが、非アクティブ化状態になります。 そのため、プロセス自動化コール・ウィザードを使用して統合を再構成する必要があります。
プロセス自動化のアプリケーション・レベルのアップグレード後タスク
プロセス・アプリケーションごとに次のタスクを実行します。
| タスク | 作成者 | 時期 | 詳細 |
|---|---|---|---|
|
ロール・マッピングの更新 |
開発者/管理者 | アップグレード直後 | Oracle Integration 3でロール割当てが変更されたため、既存のロールを新しいロールにマップする必要があります。 「Oracle Cloud Infrastructure Process Automationの使用」の「プロセス・アプリケーションのロールの構成」を参照してください。
プロセス所有者 次のロールを持つメンバーを、新しいアプリケーションの「プロセス所有者」ロールに追加します:
レビューアの処理
スイムレーン・ロールを持つメンバー
グループ 古いグループを新しいアプリケーションのロールに変更し、そのグループを新しいロールに追加するか、グループのメンバーを新しいロールに追加します。 ロール 新しいアプリケーションのロールに古いロールを変更し、新しいロールにメンバーを追加します。 プロセスを開始できるメンバー プロセス開始プロパティで、次のいずれかのオプションからプロセスを開始できるメンバーを選択します:
動的プロセス・ロール 動的プロセス・ロールを持つメンバーを、新しいアプリケーションの動的プロセス・ロールに追加します。 |
|
コネクタ資格証明の更新 |
開発者/管理者 | アップグレード直後 | 資格証明はOracle Integration 3に移行しないため、RESTコネクタの認証を再構成する必要があります。 同じサーバーに接続するアプリケーションが複数ある場合は、アプリケーション間で再利用できるグローバル資格証明を作成できます。 「Oracle Cloud Infrastructure Process Automationの使用」の「Basic認証セキュリティの構成」を参照してください。 |
|
エラーおよび警告の修正 |
開発者/管理者 | アップグレード直後 | Oracle Integration Generation 2とOracle Integration 3の間には「プロセス機能の違い」があるため、アプリケーションを検証し、エラーや警告を修正する必要があります。 「Oracle Cloud Infrastructure Process Automationの使用」の「アプリケーション一覧」にある「アプリケーションの検証方法」を参照してください。 |
|
申請のアクティブ化 |
開発者/管理者 | アップグレード直後 | すべての検証エラーを解決したら、アプリケーションをアクティブ化して、新しいインスタンスをトリガーして処理できるようにします。 「Oracle Cloud Infrastructure Process Automationの使用」の「アプリケーションのアクティブ化」を参照してください。 |
「プロセス自動化」のサービス・レベルのアップグレード後のタスク
プロセスの使用方法に応じて、Oracle Integration 3へのアップグレード後に異なるサービス・レベルのステップを実行します。 実装に適用するステップを実行します。
| タスク | 作成者 | 時期 | 詳細 |
|---|---|---|---|
|
新しい「プロセス自動化」 URLの許可リスト |
開発者 | アップグレード直後 |
新しい「プロセス自動化」 URLを許可リストに追加します。 新しいURLを検索するには、Oracle Integration 3メニューの「プロセス」をクリックします。 「プロセス自動化」 URLにリダイレクトされます。 |
|
統合を更新して「プロセス自動化」をコール |
開発者 | アップグレード直後 |
アップグレード後に、プロセス自動化およびデシジョン・アプリケーション用の開発者APIが変更されました。 プロセス自動化コール・ウィザードを使用して統合を再構成する必要があります。 「統合の再構成」を参照してください。 |
|
「プロセス自動化」をコールするようにVisual Builderアプリケーションを更新 |
開発者 | アップグレード直後 |
アップグレード後に、プロセス自動化およびデシジョン・アプリケーション用の開発者APIが変更されました。 その結果、Oracle Cloud Infrastructureプロセス自動化をコールするVisual Builderアプリケーションを更新し、非推奨の相互作用パターンを置き換える必要があります。 Visual Builder Studioを使用したレスポンシブ・アプリケーションの構築のプロセス自動化のための開発者APIへの接続を参照してください。 |
|
「プロセス自動化」をコールするように外部クライアントを更新 |
開発者 | アップグレード直後 |
外部アプリケーションでプロセスCCAコンポーネントを使用している場合、Oracle Integration 3へのアップグレード後は動作しません。 APIを利用するには、新しい「プロセス自動化」 CCAコンポーネントの使用に移行する必要があります。 Oracle Cloud Infrastructure Process Automationの開発者APIを参照してください。 |
|
新しい「プロセス自動化」 URLを共有 |
管理者 | アップグレード直後 |
「プロセス自動化」へのアクセスおよび操作に使用されるURLは、アップグレード後に変更されました。 新しいURLを、「プロセス自動化」の管理、新しいプロセスの開始、またはタスクの表示と操作を行う必要があるすべてのユーザーと共有します。 |
統合インスタンスIDの変更に必要な更新の実行
| タスク | 作成者 | 時期 | 詳細 |
|---|---|---|---|
|
統合インスタンスIDの英数字への変更に必要な完全な更新 |
開発者 | アップグレード後6か月以内 | 「アップグレード設定を構成しました」を「アップグレード後の数値としてのflowidの有効化」にすると、統合インスタンスIDに必要な更新を数値から英数字に変更するために、アップグレード後6か月かかります。
この変更は、整数である統合インスタンスIDに基づく統合フローに影響します(たとえば、数値データ型を持つデータベース列で統合インスタンスIDが解析される場合)。 アップグレード後、これらの統合を変更せずに実行した場合、アップグレード設定で「アップグレード後の数値としてのflowidの有効化」を選択せずに、変換例外エラーが発生します。
変更に対応するために、影響を受ける各統合のマッピングを更新するか、データベースに統合インスタンスIDを格納する列のデータ型を更新できます。 ノート:ここで説明する推奨方法は、Oracleデータベース・サービス(Oracle Autonomous AI Databaseなど)に基づいています。 その他のデータベース・タイプには、追加のステップが必要になる場合があります。 方法1: 影響を受ける各統合でのマッピングの更新 影響を受ける各統合で、統合インスタンスID値を含むターゲット属性を新しい数値UNIX時間にマップします。 UNIX時間は、1970年1月1日のUTC 00:00:00から始まるUNIXエポックからの経過秒数です。 この値は毎秒増分されます。 値は整数として解析できるため、データベースの変更は必要ありません。 アップグレードする前に、「インスタンスIDアクション事前チェック」の説明に従って、影響を受ける統合に注意してください。 影響を受ける統合ごとに次のステップを実行します:
方法2: データベース内の影響を受ける列のデータ型を更新 データベースで、統合インスタンスIDを保持する列のデータ型を ノート: 解決策は、操作SQL文の実行を使用して作成されたデータベース・アクションに限定されます。 データベース列はすでに移入されているため、列のデータ型を変更することはできません。 かわりに、次のステップを実行します。 SQL Developerで次のステップを実行します。
|
| (オプション)フローIDを数値に設定 | 管理者 | アップグレード後6か月以内 | 必要な更新が完了したら、オプションでフローIDを数値に設定できます。
|

