非OCIインスタンスの登録

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

重要

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

開始前に

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

「開始」セクションに入力します。
管理ステーションの登録
プロファイルを作成して、ソフトウェア・ソース、グループまたはライフサイクル環境に関連付けられたコンテンツにインスタンスを登録します。
ホスト・システムで管理エージェント・ソフトウェアをダウンロードします。
インスタンスを配置するコンパートメントにManagement Agent Cloud Service (MACS)インストール・キーを作成します。

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

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

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

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

ノート

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

JDK8またはJRE8の最新バージョン(バージョン1.8u281以降)をインストールします。
管理エージェント・ソフトウェアをインストールする前に、Java Development Kit (JDK)またはJava Runtime Environment (JRE)をインストールする必要があります。管理エージェントには、JDK8のみが必要です。
Oracle Linux 8または9
sudo dnf install -y java-1.8.0-openjdk
Oracle Linux 7
sudo yum install -y java-1.8.0-openjdk
ダウンロードした管理エージェント・ソフトウェアRPMファイルを含むディレクトリに移動し、次のコマンドを実行してRPMファイルをインストールします:
Oracle Linux 8または9
sudo dnf install -y <rpm_file_name>.rpm
Oracle Linux 7
sudo yum install -y <rpm_file_name>.rpm

管理エージェントの設定

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

管理エージェント・プラグインを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
EOF

ファイルの権限を440に設定します。
```
sudo chmod 440 /etc/sudoers.d/mgmt_agent
```
コンソールで、インスタンスの登録に使用する管理エージェントのインストール・キーをコピーします。
1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「管理エージェント」で、「ダウンロードとキー」をクリックします。
2. 「インストール・キー」で、インスタンスの登録に使用するキーを見つけます。
3. キーの「Actions」メニューをクリックし、「Copy key to clipboard」を選択します。
テキスト・エディタでレスポンス(input.rsp)ファイルを手動で作成し、前のステップでコピーしたインストール・キーで<MACS_KEY>を置き換えます。
たとえば:
```
cat >/tmp/input.rsp <<EOF
ManagementAgentInstallKey = <MACS_KEY>
Service.plugin.osmh.download = true
GatewayServerHost = <MANAGEMENT_STATION_HOST_NAME>
GatewayServerPort = <MANAGEMENT_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ファイルで使用するホスト名およびプロキシ・リスニング・ポート値を記録します。
レスポンス・ファイルを使用して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管理ハブに登録されているインスタンスを確認します。

ナビゲーション・メニューを開き、「監視および管理」をクリックします。「OS管理ハブ」で、「インスタンス」をクリックします。
「リスト・スコープ」で、インスタンスを含むコンパートメントを選択します。
インスタンスが表に表示されていることを確認し、ステータスが「アクティブ」であることを確認します。

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

インスタンス名がUNKNOWNと表示されている場合は、既知の問題を参照してください: インスタンス名はUNKNOWNと表示されます。
詳細を表示するインスタンスの名前をクリックします。

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

ノート

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

Oracle Cloud Infrastructureドキュメント