アップグレード後タスクの完了
Oracleは、最初にOracle Integration Generation 2開発インスタンスをアップグレードします。アップグレード日から3日以内にすべてのアップグレード後タスクを完了し、問題をレポートできるようにします。Oracleは、開発インスタンスの約2週間後に本番インスタンスをアップグレードします。
アップグレード後のタスクを完了することは、ユーザーが新しいインスタンスにアクセスできること、統合との間でやり取りされるデータをファイアウォールを介して送信できること、および統合が期待どおりに機能するために重要です。
アップグレード後に問題が発生した場合は、My Oracle Supportでサービス・リクエスト(SR)を入力するか、問題のトラブルシューティングを行うこと。アップグレードの問題のトラブルシューティングを参照してください。
アップグレード後、停止したOracle Integration Generation 2インスタンスがOracle Cloud Infrastructure Consoleに一定期間表示されます。このインスタンスを更新、起動または削除しないでください。不要になった場合は、Oracleがユーザーのかわりに削除します。
アップグレード後のタスクのサマリー
| 影響 | 時間 | 完了するタスク |
|---|---|---|
|
インスタンスへのアクセスの確認 |
アップグレード直後 |
|
|
接続性の確保 |
アップグレード直後 |
|
|
統合作業を保証 |
アップグレード直後 |
|
|
無視された事前チェック失敗に対するアップグレード後のタスクの完了 |
アップグレード直後 |
無視された事前チェック失敗のアップグレード後のタスクの完了 |
|
アップグレード後のVisual Builderタスクの完了 |
アップグレード直後 |
Visual Builderのアップグレード後のタスクの完了 |
|
プロセス自動化のアップグレード後タスクの完了 |
アップグレード直後 |
プロセス自動化のためのアップグレード後タスクの完了 |
|
アップグレード後検証の完了 |
アップグレードの2週間以内 |
組織の検証手順に従う |
インスタンスへのアクセスの確認
| タスク | ユーザー | 時間 | 完了するタスク |
|---|---|---|---|
|
新しいOracle Integration 3インスタンスを確認します |
アドミニストレータ | アップグレード直後 | 既存の資格証明を使用してOracle Integration 3インスタンスにサインインします。既存のOracle Integration Generation 2ブックマーク(新しいURLにリダイレクトされる)を使用するか、Oracle Integration 3インスタンスの新しいURLを使用します。Oracle Integrationインスタンスへのアクセスを参照してください。
インタフェースが次のようになると、アップグレードが完了します。 次の場合、アップグレードはまだ進行中です。
|
|
IAMポリシーを新しいOCIDで更新します |
IAMポリシー管理者 |
アップグレード直後 | 組織がインスタンスのOracle Cloud ID (OCID)に基づいてOracle Integration Generation 2インスタンスへのアクセスを制限している場合は、新しいOracle Integration 3インスタンスOCIDを指すようにIAMポリシーを更新します。
注意: IAMポリシーでOCIDを更新するまで、ユーザーはOracle Integration 3にサインインできません。
|
|
新しいインスタンスのURLを取得して共有します |
アドミニストレータ | アップグレード直後 | 新しいOracle Integration 3インスタンスのURLを取得し、必要なすべてのインスタンスと共有します。既存のブックマークも新しいURLにリダイレクトされますが、すべてのユーザーが新しいURLを持っていることを確認する必要があります。形式は次のとおりです。
新しいURLを取得するには:
|
接続性の確保
| タスク | ユーザー | 時間 | 完了するタスク |
|---|---|---|---|
|
完全なネットワーク・ルール構成 |
ネットワーク管理者 | アップグレード前またはアップグレード直後 | いずれかの統合接続で、Oracle Cloud Infrastructure Object StorageやOracle Autonomous Databaseなど、ネットワーク・ルールをサポートするOracle Cloud Infrastructureサービスをターゲットとしていて、それらのルールを有効にしている場合は、Oracle Integration Service 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クライアントを更新することをお薦めします。これにより、将来これらの値を更新することを忘れるリスクがなくなります。
|
をクリックし、統合作業の保証
| タスク | ユーザー | 時間 | 詳細 |
|---|---|---|---|
|
Oracle Integration組込みAPIコールを基本認証からOAuthに変更します |
開発者 | アップグレード前またはアップグレード直後 | 前提条件またはアップグレード前のタスクの実行中にOAuthを使用するようにAPIコールをまだ更新していない場合は、アップグレード直後に実行します。
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 Integrationは、アップグレード・ダウンタイム中に送信されたすべてのリクエストを却下しました。必要に応じて、ダウンタイム中にクライアントがOracle Integrationに送信したリクエストに対してアクションを実行します。 |
|
サービス・インスタンス名の変更 |
開発者 | アップグレード直後 |
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を使用しており、カスタム・エンドポイントまたは代替カスタム・エンドポイントがある場合は、カスタム・エンドポイントDNSレコードのCNAMEをVisual Builderインスタンスのホスト名で更新します。 ノート:アップグレード後にVisual BuilderとOracle Integrationの両方に同じカスタム・エンドポイントを使用することはできません。同じカスタム・エンドポイントを使用する場合は、問題が発生する可能性があります。 |
|
アップグレード後の追加タスクの完了 |
開発運用チーム | アップグレード直後 | Oracle Integration 3でのOracle Visual Builderの管理のアップグレード後に完了するタスクで説明されているタスクを完了します。 |
プロセス自動化のアップグレード後タスクの完了
Oracle Integration 3のプロセス自動化への移行を完了するには、次のステップを実行します。
統合の再構成
インスタンスがアップグレードされると、プロセス・アクションはOracle Integration Generation 2プロセス・アクションからOracle Integration 3プロセス・アクションに変換され、統合はOracle Integration 3プロセス・アクション上にありますが、非アクティブ化状態になります。そのため、プロセス自動化コール・ウィザードを使用して統合を再構成する必要があります。
プロセス自動化のアップグレード後のマッピング・タスクへのアクセス
一部のアクセス・マッピング・タスクはアップグレード中に自動的に完了し、一部はユーザーの責任です。
アップグレード中に、マッピングに役立つ新しいOracle Cloudサービスが追加されます。
次のサービス・ロールは、アップグレード中にOracle Integration Generation 2からOracle Integration 3に自動的にマップされます。
| Oracle Integration 第2世代 | Oracle Integration 3 |
|---|---|
| ServiceDeveloper | ServiceDeveloper |
| ServiceAdministrator | ServiceAdministrator |
| ServiceUser | 該当なし |
| ServiceMonitor | 該当なし |
| ServiceDeployer | ServiceDeployer |
| ServiceViewer | 該当なし |
| ServiceInvoker | 該当なし |
| ServiceEndUser | 該当なし |
プロセス自動化のアプリケーション・レベルのアップグレード後タスク
プロセス・アプリケーションごとに次のタスクを実行します。
| タスク | ユーザー | 時間 | 詳細 |
|---|---|---|---|
|
ロール・マッピングの更新 |
開発者/管理者 | アップグレード直後 | Oracle Integration 3でロール割当てが変更されたため、既存のロールを新しいロールにマップする必要があります。Oracle Cloud Infrastructure Process Automationの使用のプロセス・アプリケーションのロールの構成を参照してください。
プロセス所有者 次のロールを持つメンバーを、新しいアプリケーションのプロセス所有者ロールに追加します:
プロセス・レビューア
スイムレーン・ロールを持つメンバー
グループ 古いグループを新しいアプリケーションのロールに変更し、そのグループを新しいロールに追加するか、グループのメンバーを新しいロールに追加します。 ロール 古いロールを新しいアプリケーションのロールに変更し、新しいロールにメンバーを追加します。 プロセスを開始できるメンバー プロセス開始プロパティで、次のいずれかのオプションからプロセスを開始できるメンバーを選択します。
動的プロセス・ロール 新しいアプリケーションの動的プロセス・ロールに、動的プロセス・ロールを持つメンバーを追加します。 |
|
コネクタ資格証明の更新 |
開発者/管理者 | アップグレード直後 | 資格証明はOracle Integration 3に移行されないため、RESTコネクタの認証を再構成する必要があります。同じサーバーに接続するアプリケーションが複数ある場合は、アプリケーション間で再利用できるグローバル資格証明を作成できます。Oracle Cloud Infrastructure Process Automationの使用の基本認証セキュリティの構成を参照してください。 |
|
エラーおよび警告の修正 |
開発者/管理者 | アップグレード直後 | 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およびエンドポイントが変更されました。その結果、非推奨の相互作用パターンを置換して、ProcessをコールするVisual Builderアプリケーションを更新する必要があります。Visual Builder Studioを使用したレスポンシブ・アプリケーションの構築のOracle Process Automation APIへの接続を参照してください。 |
|
プロセス自動化をコールするように外部クライアントを更新します |
開発者 | アップグレード直後 |
外部アプリケーションでプロセスCCAコンポーネントを使用している場合、Oracle Integration 3へのアップグレード後は動作しません。APIを活用するには、新しいプロセス自動化CCAコンポーネントの使用に移行する必要があります。Oracle Cloud Infrastructure Process AutomationのREST APIを参照してください。 |
|
新しいプロセス自動化URLを共有 |
アドミニストレータ | アップグレード直後 |
アップグレード後に、プロセス自動化にアクセスして操作するために使用されるURLが変更されました。新しいURLを、プロセス自動化の管理、新しいプロセスの開始、またはタスクの表示と操作を必要とするすべてのユーザーと共有します。 |