Oracle Cloud Infrastructureドキュメント

OS管理インスタンスのOS管理ハブへの移行

使用中のOS管理リソースを検出し、OS管理ハブで同等のリソースを作成し、インスタンスを移行して、OS管理インスタンスをOS管理ハブに移行します。

OS管理ハブには、移行の各ステージを正常に実行するのに役立つ移行アシスタントが用意されています。移行アシスタントは、OS管理ハブへの移動を合理化するために、一括検出、作成および移行操作をサポートします。移行は、インスタンスごとにOCIコンソールを使用して手動で行うこともできます。

ノート

2025年4月23日より、Oracle OS管理サービスが終了(EOL)に達しました。OS管理はOS管理ハブに置き換えられ、ライフサイクル・ステージを介したパッチ・デプロイメント、拡張されたジョブ・スケジューリングおよびレポート機能などの新機能によりユーザー・エクスペリエンスが向上します。

EOL日より前に、管理対象インスタンスをOS管理からOS管理ハブに移行することをお薦めします。

移行のステージ

OS管理からOS管理ハブへの移行は、3段階のプロセスです。

  • 検出: OS管理インスタンスを調べて、管理対象インスタンスに必要なソフトウェア・ソース、管理対象インスタンス・グループおよびスケジュール済ジョブを決定し、非互換の問題を解決します。
  • 作成: 検出で決定した情報を使用して、OS管理ハブに必要なリソースを作成します。ベンダー・ソフトウェア・ソースを追加し、カスタム・ソフトウェア・ソースを作成し、グループを作成して、登録プロファイルを作成します。
  • 移行: OS管理からインスタンスを登録解除し、プロファイルを使用してOS管理ハブに登録します。

開始する前に

OS管理インスタンスをOS管理ハブに移行する前に、次を実行する必要があります:

重要

OS管理ハブにインスタンスを登録すると、移行アシスタントにもアクセスできます。

必須IAMポリシー

インスタンスを正常に移行するには、OS管理とOS管理ハブの両方に対するテナンシ権限が必要です。詳細は、OS管理のIAMポリシーの設定およびOS管理ハブに必要なIAMポリシーを参照してください。

移行アシスタントには追加のポリシー要件があります。移行アシスタントを使用するには、次のポリシーが必要です。

allow group group-name to inspect compartments in tenancy
allow group group-name to use tag-namespaces in tenancy
allow group group-name to use instances in tenancy
allow group group-name to inspect work-requests in tenancy
  • 最初の行では、ユーザー・グループがテナンシ内のコンパートメントをリストできます。
  • 2行目で、ユーザー・グループはテナンシ内のリソースのタグ・ネームスペースを更新できます。移行アシスタントはタグを使用して、OS管理ハブに移行されたリソースを追跡します。
  • 3行目で、ユーザー・グループはインスタンスをリストし、タグを更新して移行ステータスを追跡できます。
  • 4行目で、ユーザー・グループはOS管理およびOS管理ハブのOracle Cloud Agentプラグインのステータスを監視できます。移行アシスタントはこの情報を使用して、インスタンスの移行が成功したことを確認します。

移行ワークフロー

ユース・ケースに応じて、OS管理インスタンスをOS管理ハブに移行するには、次のワークフローを使用します:

コンソールを使用した単一インスタンスの移行
  1. OS管理ハブに必要なIAMポリシー、動的グループおよびユーザー・グループを設定します。
  2. (Oracle Linuxのみ)インスタンスで使用されているすべてのベンダー・ソフトウェア・ソースを識別し、ベンダー・ソフトウェア・ソースをOS管理ハブに追加します。
  3. (Oracle Linuxのみ)インスタンスで使用されているすべてのカスタム・ソフトウェア・ソースを識別し、OS管理ハブで作成します。
  4. インスタンスを登録するプロファイルを選択します。必要に応じて、OS管理ハブにプロファイルを作成します。
  5. コンソールを使用してインスタンスを移行します。
移行アシスタントを使用したインスタンスの一括移行
  1. OS管理ハブに必要なIAMポリシー、動的グループおよびユーザー・グループを設定します。
  2. OS管理ハブにインスタンスを登録し、サービス、および登録プロファイルの仕組みと移行アシスタントへのアクセスについて理解します。
  3. 移行に必要なタスクに役立つように、移行アシスタント・ユーティリティにアクセスしてインストールします。
  4. (Oracle Linuxのみ) OS管理管理対象インスタンスで使用されているすべてのベンダー・ソフトウェア・ソースを識別し、ベンダー・ソフトウェア・ソースをOS管理ハブに追加します。
  5. (Oracle Linuxのみ) OS管理管理対象インスタンスで使用されているすべてのカスタム・ソフトウェア・ソースの識別、非互換性の問題の解決およびOS管理ハブでの作成。
  6. OS管理におけるすべての管理対象インスタンス・グループの識別、非互換性の問題の解決およびOS管理ハブでのグループ・リソースの作成。
  7. 管理対象インスタンスの識別、非互換性の問題の解決およびプロファイルの作成を行い、インスタンスをOS管理ハブ・サービスに登録します。
  8. 適切なプロファイルを使用して、OS管理ハブにインスタンスを移行します。

移行アシスタント

移行アシスタントには、OS管理からOS管理ハブへのインスタンスの移行の各段階を支援する一連のユーティリティが用意されています。移行アシスタントをインストールするには、移行アシスタントのインストールを参照してください。

ステージング 移行アシスタント・ユーティリティ
検出

使用中のOS管理リソースを識別し、互換性のないソフトウェア・ソースや管理対象インスタンス・グループなどの潜在的な移行の問題を強調します。ユーティリティは、リソースで検出された非互換の問題を修正する方法を提案します。

使用中のOS管理リソースを識別するために、次の移行アシスタント・ユーティリティを使用できます:
作成

ソフトウェア・ソース、グループ、スケジュール済ジョブ、登録プロファイルなど、管理対象インスタンスをサポートするために必要なOS管理ハブ・リソースを作成します。

OS管理ハブ・リソースを作成するために、次の移行アシスタント・ユーティリティを使用できます:
移行

適切な登録プロファイルを使用して、OS管理からOS管理ハブにインスタンスを移行します。移行アシスタントでは、インスタンスの一括移行もサポートされます。

インスタンスの移行には、次の移行アシスタント・ユーティリティを使用できます:
ロールバック

必要に応じて、管理対象インスタンスをOS管理に戻します。

インスタンスをロールバックするには、次の移行アシスタント・ユーティリティを使用できます:

移行アシスタントのインストール

移行アシスタントは、Oracle Cloud Infrastructure (OCI) Cloud ShellまたはOracle Cloud Infrastructure (OCI) SDKを使用してシステムにインストールできます。

移行アシスタントをインストールする前に:

次のいずれかの方法を使用して、移行アシスタントをインストールします。

ヒント

簡単にするために、Cloud Shellを使用して移行アシスタントを実行することをお薦めします。

移行アシスタントへのアクセス

  1. OS管理ハブにインスタンスを登録します。
  2. SSHを使用してインスタンスに接続します。
  3. 適切なディレクトリに移動し、osms_to_osmh-<version>-py3-none-any.whlファイルをコピーします。
    • Oracle Linux: /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent/stateDir/osms_to_osmh-<version>-py3-none-any.whl
    • Windows 2016: C:\Users\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent\stateDir\osms_to_osmh-<version>-py3-none-any.whl
    • Windows 2019/2022: C:\Windows\ServiceProfiles\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent\stateDir\osms_to_osmh-<version>-py3-none-any.whl
    ノート

    移行アシスタントのバージョン1.0.155以降を使用して、OS管理ハブの最新の更新と互換性があります。
  4. クラウド・シェルを使用またはOCI SDKを使用して移行をインストールします。

Cloud Shellの使用

クラウド・シェルを使用して移行アシスタントをインストールする前に、クラウド・シェルおよびクラウド・シェルのパブリック・ネットワーキングを使用するために必要なIAMポリシーが設定されていることを確認します:

  • クラウド・シェルを使用するには必要なIAMポリシー。
  • クラウド・シェル管理パブリック・ネットワークで移行アシスタント・ユーティリティをインストールするための必要なIAMポリシー。
  1. osms_to_osmh-<version>-py3-none-any.whlファイルをクラウド・シェルにアップロードします。
  2. クラウド・シェル・ネットワークが「パブリック」に設定されていることを確認します。
  3. 移行アシスタントをクラウド・シェルにインストールします。 
    /home/oci/lib/oracle-cli/bin/python3 -m pip install osms_to_osmh-<version>-py3-none-any.whl
  4. クラウド・シェルのホーム・ディレクトリからコマンドを実行するために必要なシンボリック・リンクを作成します。 
    ln -s /home/oci/lib/oracle-cli/bin/osms-to-osmh /home/oci/bin/osms-to-osmh

OCI SDKの使用

  1. OCI SDKおよび開発者ツールキットと連携するために必要なSSHキーを設定し、SDKを構成します。
    Oracle Cloud Infrastructure開発者ガイドの設定と前提条件を参照してください。
  2. osms_to_osmh-<version>-py3-none-any.whlファイルをシステムにアップロードします。
  3. 移行アシスタントをシステムにインストールします。 
    python -m pip install osms_to_osmh-<version>-py3-none-any.whl