Oracle Cloud Infrastructureドキュメント

非OCIインスタンスの登録

必要なパッケージのインストール、登録プロファイルの追加および管理エージェントのインストールによって、オンプレミスまたはサポートされているサードパーティ・クラウド・インスタンスを登録します。

重要

OS管理ハブにすでに登録されているVMのクローニングはサポートされていません。

開始前

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

インスタンスへの登録プロファイルの追加

  1. コンソールで、ソフトウェア・ソース、グループまたはライフサイクル・プロファイルの内容をコピーします。
    1. 「OS管理ハブ」で、「プロファイル」を選択します。
    2. プロファイルの名前を選択します。
    3. プロファイル情報が管理ステーションであることを確認します。これにより、プロファイルがオンプレミス・インスタンスまたはサードパーティ・クラウド・インスタンス用であることが確認されます。
    4. プロファイルが正しいタイプである場合は、「表示」を選択します。
    5. プロファイルの内容をコピーします。
  2. sudo権限を持つユーザーとしてインスタンスにサインインします。
  3. テキスト・エディタを使用して、/etc/osmh-profileファイル(ファイル名にファイル拡張子なし)を作成します。例: 
    sudo vi /etc/osmh-profile
  4. コンソールからコピーしたプロファイル・コンテンツを貼り付け、ファイルを保存します。

管理エージェントをインストールします

インスタンスに管理エージェント・ソフトウェアをインストールします。管理エージェントは、OS管理ハブ・プラグインを使用して、インスタンスをOS管理ハブ・サービスに登録します。

ノート

管理エージェント・ソフトウェアのインストールの詳細は、管理エージェントのインストールを参照してください。

これらのステップは、管理エージェント・バージョン260828.3213以降に適用されます。エージェントにはプライベートJava 21ランタイムが含まれているため、個別のJavaインストールは必要ありません。OCIコンソールにバージョンがリストされ、ダウンロードしたRPMファイル名に含められます。oracle.mgmt_agent.rpmという名前のOCI CLIダウンロードの場合は、rpm -qp oracle.mgmt_agent.rpmを実行して、インストール前にパッケージのバージョンを確認します。

260828.3213より前のバージョンの管理エージェントの場合、エージェントをインストールする前にインスタンスにJava 8をインストールします。

  1. /etc/sudoersに/etc/sudoers.dが含まれていることを確認します。 
    sudo visudo

    次の行が存在することを確認します。そうでない場合は、ファイルを追加して保存します。

    ## Read drop-in files from /etc/sudoers.d (the # here does not mean a comment)
#includedir /etc/sudoers.d
  2. ダウンロードした管理エージェント・ソフトウェアのRPMファイルが格納されているディレクトリに移動し、次のコマンドを実行してRPMファイルをインストールします:
    Oracle Linux 8、9または10
    sudo dnf install -y <rpm_file_name>.rpm
    Oracle Linux 7
    sudo yum install -y <rpm_file_name>.rpm

管理エージェントの設定

OS管理ハブ・プラグインを使用して管理エージェントをアクティブ化します。アクティブ化すると、インスタンスはインストール・キーで指定されたコンパートメント内のOS管理ハブ・サービス、およびプロファイルに関連付けられたコンテンツに登録されます。

  1. rootとして実行するように管理エージェント・プラグインを構成します。OS管理ハブ・プラグインは、インスタンスにパッチを適用するためにrootとして実行する必要があります。例: 
    sudo tee /etc/sudoers.d/mgmt_agent <<EOF
## Allows Management Agent to change ownership of deployed External Plugin
mgmt_agent ALL=(ALL) NOPASSWD:/opt/oracle/mgmt_agent/agent_inst/bin/chown_recursive_ep.sh
## Allows Management Agent to run External Plugin under root user
mgmt_agent ALL=(root) NOPASSWD:SETENV: /opt/oracle/mgmt_agent/plugins/osmh/*/osmh
## Disable requiretty for Management Agent
Defaults:mgmt_agent !requiretty
EOF
  2. ファイルの権限を440に設定します。 
    sudo chmod 440 /etc/sudoers.d/mgmt_agent
  3. コンソールで、インスタンスの登録に使用する管理エージェントのインストール・キーをコピーします。
    1. ナビゲーション・メニューを開き、「監視および管理」を選択します。「管理エージェント」で、「ダウンロードとキー」を選択します。
    2. 「インストール・キー」で、インスタンスの登録に使用するキーを検索します。
    3. キーの「アクション」メニューを選択し、「キーをクリップボードにコピー」を選択します。
  4. テキスト・エディタでレスポンス(input.rsp)ファイルを手動で作成し、<MACS_KEY>を前のステップでコピーしたインストール・キーに置き換えます。

    たとえば:

    cat >/tmp/input.rsp <<EOF
ManagementAgentInstallKey = <MACS_KEY>
Service.plugin.osmh.download = true
GatewayServerHost = <STATION_OR_LOAD_BALANCER_HOSTNAME>
GatewayServerPort = <STATION_PROXY_PORT>
EOF

    input.rspファイルには、次の必須パラメータが必要です。

    • ManagementAgentInstallKey: ドメインのアイデンティティとインストールの信頼性を検証するために必要なインストール・キー。
    • Service.plugin.osmh.download = true: エージェントのインストール中にOS管理ハブ(osmh)プラグインをデプロイします。

    インスタンスとのすべてのOS管理ハブ通信のプロキシとして管理ステーションを使用するには、input.rspファイルに次のパラメータを追加します。

    • GatewayServerHost: 管理ステーションのホスト名またはIPアドレス(または高可用性を構成する場合はロード・バランサ、「管理ステーションの高可用性の構成」を参照)。
    • GatewayServerPort: 管理ステーションのプロキシ・ポート番号。

    管理ステーションのホスト名およびプロキシ・ポートを識別するには、コンソールで次のステップを実行します。

    1. 「OS管理ハブ」で、「プロファイル」を選択します。
    2. インスタンスに関連付けられているプロファイルを選択します。
    3. 「プロファイル情報」セクションで、「管理ステーション」の名前を選択します。
    4. 「構成」タブをクリックします。
    5. input.rspファイルで使用するホスト名およびプロキシ・リスニング・ポートの値を記録します。
  5. 管理エージェントを構成するには、レスポンス・ファイルを使用してsetup.shスクリプトを実行します。 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/input.rsp

    設定に成功すると、Agent setup completed and the agent is runningというメッセージが返されます。OS管理ハブ・プラグインの設定には、バックグラウンドでさらに数分かかる場合があります。

インスタンス登録および詳細の検証

OS管理ハブに登録されているインスタンスを確認します。

  1. 「OS管理ハブ」で、「インスタンス」を選択します。
  2. 「適用済フィルタ」で、インスタンスを含むコンパートメントをクリックします。
  3. インスタンスが表に表示されていることを確認し、ステータスが「アクティブ」であることを確認します。
    ヒント

    登録の問題をトラブルシューティングするには、インスタンス・ステーションまたは管理ステーションの登録に失敗しましたを参照してください。

  4. 詳細を表示するインスタンスの名前を選択します。

    「インスタンス情報」では、サービスへの登録に使用した登録プロファイルや、それがグループまたはライフサイクル環境のメンバーかどうか(該当する場合)など、インスタンスに関する詳細を表示できます。

    ノート

    インスタンスは、初期パッケージおよびモジュール・インベントリをサービスにレポートするのに数分かかる場合があります。