OIC integrationの一括移行 (2022/08/29)

OIC integrationの一括移行 (2022/08/29)

https://blogs.oracle.com/cloud-infrastructure/post/migrate-oic-integrations

投稿者：Gaurav Aneja


この投稿では、OIC REST APIを使用して、すべてのOracle Integration Cloud（OIC）Integrationをある環境から別の環境に移行する方法を説明します。移行プロセスを監視し、移行プロセス中に発生した問題を特定することができます。


クローンユーティリティのREST APIを使用することで、以下の例のように移行することができます。


  •     Integration
  •     コネクション
  •     パッケージ
  •     ライブラリ
  •     証明書
  •     ルックアップ


オンプレミスシステムに接続するための接続エージェントがある場合、ターゲットインスタンス上で手動で設定する必要があります。



前提条件


  •     両方のインスタンスで管理者権限を持つOICサービス
  •     作成と更新のアクセス権限を持つ認証局（CA）クラウドストレージコンテナ
  •     PostmanのようなAPIコールを実行するツール



移行の手順


このブログ記事では、次のステップを説明します。


  1.     OCIソース環境にOracle Cloud Infrastructure (OCI) Object Storageバケットを作成
  2.     REST API を使用してストレージ・コンテナにアクセスするための認証トークンを生成
  3.     エクスポートアーカイブ API を実行し、統合アーカイブをソース OIC インスタンスからストレージコンテナにエクスポート
  4.     統合アーカイブのエクスポートを検証
  5.     インポートアーカイブAPIを実行して、IntegrationアーカイブをターゲットOICインスタンスにインポート
  6.     ターゲット環境でインポートされたアーティファクトを検証


次の図は、移行プロセスを示しています。




Object Storageのバケットを作成


ストレージバケットを作成するには、Oracle Cloudテナンシーに移動します。メニューの[Storage]で、[Buckets]を選択します。




[バケットの作成]ボタンをクリックし、バケット名などの詳細を入力し、デフォルトのストレージ階層に[標準]を選択します。




新しく作成したストレージバケットのバケット名とnamespaceを保存し、後でストレージURLを作成する際に使用します。





認証トークンを生成


ストレージバケットにAPIでアクセスする場合、セキュリティトークンが必要です。Oracle Integrationでは、OCI Object StorageサービスのAPIを使用して、Bucketへのファイルの読み書きを行います。そこで、このプロセスで使用するトークンを作成する必要があります。


Auth トークンを作成するには、Oracle Cloud Console で自分のプロファイルをクリックし、[My Profile] を選択します。[Auth tokens] タブを選択し、[Generate Token] ボタンをクリックします。



この認証トークンは、後で取り出すことができないので、安全な場所に保管してください。



エクスポートアーカイブAPIを実行


次のステップを実行するために、OCIにAPIコールを行えるようにする必要があります。最も簡単な方法は、Postmanのようなツールを使用することですが、お好みのツールを使用することができます。


ソース OIC インスタンスから統合アーティファクトをエクスポートするには、POST API 呼び出しを行い、以下のサーバーおよびポート参照をソースインスタンスの詳細情報に置き換えます。また、ストレージの詳細を参照するために、POSTのボディを調整する必要があります。

Request

URL:

https://OIC Server:port/ic/api/common/v1/exportServiceInstanceArchive

HTTP Verb: POST

Header:

Authorization: Basic <oicusername:password>

Body

{"storageInfo":

       {

             "storageUrl":"https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/axdvjzox0ixb/TestMigrateBucket",

             "storageUser":"oracleidentitycloudservice/gaurav.aneja@oracle.com",

             "storagePassword":"XXXXXXXXXXXXXXX"

            }

}


ストレージのURLは、先ほど作成したバケット名を付加して作成します。ストレージのパスワードは、先ほど生成した認証トークンです。そのため、urlは以下の例のようになります。


  •     https://Storage-<unique_identifier>.us.storage.oraclecloud.com/v1/Storage-<unique_identifier namespace>/bucket-name（バケット名）
  •     https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/axdvjzoxxxxxx/TestMigrateBucket


次の例は、API呼び出しに成功した場合の期待される応答です。

{

    "jobId": "310144",

    "location": "https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/axdvjzox0ixb/TestMigrateBucket",

    "status": "NOT_STARTED"
 

}





Integrationアーカイブのエクスポートを確認


前の応答で提供された JOBID を使用して GET API 呼び出しでエクスポート アーカイブの状態を監視することができます。API 呼び出しの URL は、https://<instagrationserver>/ic/api/common/v1/exportServiceInstanceArchive/<jobid> です。



API の GET 呼び出しによるフルレスポンスは、次の例のようになります。

RESPONSE-

{

    "jobId": "310144",

    "jobType": "EXPORT",

    "archiveName": "Local_Suite_Instance-310144.zip",

    "includeSecurityArtifacts": true,

    "overallStatus": "COMPLETED",

    "startTime": "Wed May 18 09:58:33 UTC 2022",

    "endTime": "Wed May 18 10:04:13 UTC 2022",

    "components": [

        {

            "name": "Integration",

            "status": "COMPLETED",

            "percentage": 100

        },

        {

            "name": "Process",

            "status": "COMPLETED",

            "percentage": 100

        }

    ]

}


または、Object Storage バケットで確認し、統合エクスポートが利用可能かどうかを確認することもできます。


次のステップのために .zip ファイル名をコピーし、アーカイブファイルをターゲット OIC インスタンスにインポートするために、ストレージバケットにアクセスする必要があります。次の図は、私たちのバケット内のファイルを示しています。




import archive API を実行して、統合アーカイブをターゲット OIC インスタンスにインポート


アーカイブファイルがバケットに格納された後、OICターゲットインスタンスエンドポイントを使用してインポートAPIを実行し、Integrationアーティファクトをインポートすることができます。リクエストのペイロードには、ストレージバケットに作成されたアーカイブファイル名を使用します。




リクエスト


以下の内容で、ターゲットサーバーのアドレスと認証情報を代入して、リクエストを作成してください。


  •     URL: https://OICSserver/ic/api/common/v1/importServiceInstanceArchive
        例：https://integrationtestinstance1-axdvjzox0ixb-px.integration.ocp.oraclecloud.com/ic/api/common/v1/importServiceInstanceArchive

  •     HTTP動詞：POST
  •     ヘッダ：
  •     Authorization: Basic <OIC username:password>
  •     ボディ：

{

        "archiveFile":"Local_Suite_Instance-310144.zip",

        "importActivateMode":"importOnly",

         "storageInfo":

                {

                                "storageUrl":"https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/axdvjzox0ixb/TestMigrateBucket",

                                "storageUser":"oracleidentitycloudservice/gaurav.aneja@oracle.com",

                                "storagePassword":"XXXXXXXXXXXXXXXXX"

                }

}


REST APIを呼び出した結果、以下のようなレスポンスが返ってきました。

Response
{

                “jobId”:”5123″,

                “status”:”NOT_STARTED”

}


ターゲットOICインスタンスでインポートされた成果物を検証


以下のGET APIを使用して、インポート状況を監視することができます。ジョブが完了したことを報告した後、ターゲットインスタンスにログインし、すべてのIntegrationアーティファクトが完了としてインポートされていることを確認します。


APIコールのステータス確認は、GETコールです。今回は、対象のOICインスタンスサーバとインポートジョブIDを使用します。




完全なレスポンスペイロードは、次の例のようになります。

RESPONSE-

{

    "jobId": "310164",

    "jobType": "IMPORT",

    "includeSecurityArtifacts": true,

    "overallStatus": "COMPLETED",

    "startTime": "Wed May 18 10:22:53 UTC 2022",

    "endTime": "Wed May 18 10:28:14 UTC 2022",

    "mode": "ImportOnly",

    "importScheduleParams": false,

    "startSchedules": false,

    "components": [

        {

            "name": "Integration",

            "status": "COMPLETED",

            "percentage": 100

        },

        {

            "name": "Process",

            "status": "COMPLETED",

            "percentage": 100

        }

    ]

}


インポートの問題やエラーを確認するには、ストレージバケットにアクセスし、インポート処理中に問題が発生した場合、ログファイルとしてインポートの状況を記録しています。



まとめ


この記事では、REST API を使用して、ある OIC インスタンスから別の OIC インスタンスに統合アーティファクトを移行する方法を示しました。このプロセスは、すべての統合をシームレスに移行する簡単な方法を提供します。


コメント

コメントを投稿

このブログの人気の投稿

Oracle Database 19cサポート・タイムラインの重要な更新 (2024/11/20)

イメージ
Oracle Database 19cサポート・タイムラインの重要な更新 (2024/11/20) https://mikedietrichde.com/2024/11/20/important-update-to-oracle-database-19c-support-timelines/ 長い沈黙は、私が隠れているという意味ではありません。つまり、今はとても忙しいということです。そして、より少ない旅行で、私はあなたのコメントにもブログと返信するより多くの時間を持っていることを願っています。それでも、Oracle Database 19cサポート・タイムラインの非常に重要な更新について説明します。 * 更新された内容 2024年11月19日現在、Oracle Database 19cのサポート・タイムラインが調整されています。 MOSノート: 742060.1 – 現在のデータベース・リリースのリリース・スケジュールを見ると、新しい日付が表示されます。 Premier Support、2029年12月31日まで 2030年1月1日から2032年12月31日までの拡張サポート 2033年1月1日から2034年12月31日までのアップグレード・サポート これは知ることがとても大切です。 他のリリースの更新はありますか。 MOSノートの終わりにある変更ログ: 742060.1 – 現在のデータベース・リリースのリリース・スケジュールでは、Oracle Database 21cの最新の更新も確認できます。このリリースのPremier Support期間は、2027年7月31日まで延長されました。 また、Oracle Database 23aiのパッチ適用終了日は2032年12月31日に設定されています。 Lifetime Support Policy 更新は、Oracle Technology Productsの Oracle Lifetime Support Policy (6ページ)でも確認できます。 From: Oracle Lifetime Support Policy for Oracle Technology Product s – page 6 – Nov 19, 2024 特に、次の表に示す制限事項に注意してください。 Oracle Database 1...
続きを読む

ミリ秒の問題: BCCグループとOCIが市場データ・パフォーマンスを再定義する方法(AWSに対するベンチマークを使用) (2025/11/13)

イメージ
ミリ秒の問題: BCCグループとOCIが市場データ・パフォーマンスを再定義する方法(AWSに対するベンチマークを使用) (2025/11/13) https://blogs.oracle.com/cloud-infrastructure/post/milliseconds-matter-bcc-group-and-oci-vs-aws 投稿者： Steven Riley | Senior Cloud Architect William Bierds | Business Analyst and Systems Engineer - BCC Group International Travis Liles | Master Principal Cloud Architect Puru Patel | Cloud Architect - FSI これは、BCC グループと Oracle Cloud Infrastructure (OCI) 間の市場データ パートナーシップを紹介するブログ シリーズの第 2 部です。   はじめに 金融市場データアプリケーションは、トレーダー、金融機関、そして市場参加者が情報に基づいた意思決定を行えるよう、リアルタイムデータを提供することで、取引エコシステムにおいて重要な役割を果たしています。 前回のブログ で述べたように、取引環境において最適なパフォーマンスを確保するには、市場データを超低レイテンシかつ高い信頼性で配信する必要があります。 今日の急速に変化する金融市場において、クラウドは市場データ・アプリケーションにとって強力な推進力として台頭しています。適切なネットワークとインフラストラクチャがあれば、企業は実行時間の短縮、可用性の向上、そして堅牢なセキュリティを実現できます。しかし、企業によるクラウド導入は遅れており、ワークロードのクラウド移行計画を中止しているケースもあります。そこで、BCCグループとOracle Cloud Infrastructure（OCI）のパートナーシップが注目されています。 BCCグループは、主力市場データアプリケーションであるONE PlatformをOCI上に導入しました。このブログでは、以下の点について説明します。 このパートナーシップがなぜこれほど相乗効果をもたらすのかを探る OC...
続きを読む

Oracle Enterprise Manager 24aiの概要 (2024/12/18)

イメージ
Oracle Enterprise Manager 24aiの概要 (2024/12/18) https://blogs.oracle.com/observability/post/oracle-enterprise-manager-24 投稿者： David Le Roy | Senior Director of Product Management 本日、Oracle Enterprise Manager 24ai(EM 24ai)を発表します。これは、最新のAIを活用した管理テクノロジのパワーを活用して、データ・センターとクラウド全体にOracle Databaseとエンジニアド・システムをさらに充実させる画期的なリリースです。ソフトウェアの ダウンロード が可能になりました。この新しいリリースについてさらに学習するには、2024年12月17日から19日に開催されるOracle Enterprise Manager Technology Forumの年次開催にご 参加 ください。 図1: Oracle Enterprise Manager 24aiの概要 この新しいリリースについてさらに学習するには、2024年12月17日から19日に開催されるOracle Enterprise Manager Technology Forumの年次開催にご参加ください。12月17日午前9時に、エンジニアリング担当エグゼクティブ・バイスプレジデントのWim Coekaerts氏と製品管理担当シニア・バイスプレジデントのMughees Minhas氏が率いるイベント基調講演をご覧ください。基調講演に続き、データベース・パフォーマンス、エンジニアド・システム管理、可用性、セキュリティ、コンプライアンスなどに関するベストプラクティスと新製品機能をカバーする25のテクニカル・セッションが追加されました。オラクルのセッションでは、Oracle製品のエキスパートがお客様の技術的な質問にお答えできるよう、Oracle製品マネージャーや主要なお客様が主導しています。 本日 登録 ! Oracle Enterprise Manager 24aiの新機能 EM 24aiリリースは、お客様がオンプレミスおよびクラウドにデプロイされたOracle DatabaseおよびOracle Exadataフ...
続きを読む