管理ステーションの登録

管理ステーションのプロファイルを使用し、管理エージェントをインストールして、管理ステーションをOS管理ハブに登録します。

登録時に、OS管理ハブはステーション・インスタンス(Oracle Linux 8 BaseOSおよびOracle Linux 8 Appstream)に必要な最小限のソフトウェア・ソースをアタッチします。これにより、OS管理ハブは、ステーションとして機能するインスタンスにアップデートを提供できます。

ヒント

何かお困りですか?インスタンス・ステーションまたは管理ステーションの登録に失敗しましたを参照してください。

開始前

管理ステーションをOS管理ハブ・サービスに正常に登録するには、次の手順を実行します。

「管理ステーションの理解」を確認します。
OS管理ハブで管理ステーションを作成します。
ホスト・システムで管理エージェント・ソフトウェアをダウンロードします。
管理ステーションおよびインスタンス用の管理エージェントCloud Service (MACS)インストール・キーを作成します。
インスタンスがタイム・サーバー(NTP)と同期されていることを確認します。たとえば、Chronyを構成します。
インスタンスがポートtcp/443でOCIに到達できることを確認します。

必要なパッケージのインストール

管理ステーションは、Apacheサーバー・アプリケーションとして、OS管理ハブ・サービスのネットワーク・プロキシおよびローカルyumミラーとしての役割で実行されます。必要なApache Webサーバーをインストールし、httpdサービスを起動および有効化する必要があります。

管理ステーションでSELinuxを使用している場合は、SELinuxの管理に必要なユーティリティを提供するpolicycoreutils-python-utilsパッケージもインストールする必要があります。

sudo権限を持つユーザーとしてインスタンスにログインします。
必要な Apacheパッケージをインストールします。
```
sudo dnf install -y httpd mod_ssl openssl
```
httpdサービスを起動および有効化します。
```
sudo systemctl start httpd
sudo systemctl enable httpd
```
必要なSELinuxパッケージおよび依存関係をインストールします。
```
sudo dnf install -y policycoreutils-python-utils
```

インスタンスへのステーション・プロファイルの追加

ステーションプロファイルをインスタンスに追加します。プロファイルは、インスタンスを管理ステーションとして識別します。プロファイルは、単一の管理ステーションのみを登録するために使用できます。管理ステーションのプロファイルは再利用できません。

コンソールで、管理ステーション・プロファイルの内容をコピーします。
1. ナビゲーション・メニューを開き、「監視および管理」を選択します。「OS管理ハブ」で、「管理ステーション」を選択します。
2. プロファイルを使用する管理ステーションの名前を選択します。
3. 「プロファイルの表示」を選択します。
4. プロファイルの内容をコピーします。
sudo権限を持つユーザーとしてインスタンスにログインします。
テキスト・エディタを使用して、/etc/osmh-profileファイル(ファイル名にファイル拡張子なし)を作成します。例:
```
sudo vi /etc/osmh-profile
```
コンソールからコピーしたプロファイル・コンテンツを貼り付け、ファイルを保存します。

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

管理ステーション・インスタンスに管理エージェント・ソフトウェアをインストールします。OS管理ハブでは、管理エージェントをインスタンスにインストールし、管理エージェント・サービスにサービス・プラグインを提供する必要があります。

ノート

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

/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
```
必要なパッケージをインストールします。これには、Java 8 (最小1.8u281またはそれ以降の1.8バージョン)が含まれます。
管理エージェント・ソフトウェアをインストールする前に、インスタンスにJava 8をインストールする必要があります。
```
sudo dnf install -y java-1.8.0-openjdk
```
Java 8を使用するようにJAVA_HOME環境変数を設定します。変数を設定すると、新しいバージョンがシステム上にあるときに、MACSが正しいJavaバージョンを使用するようになります。
```
JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk ; export JAVA_HOME
```
ダウンロードした管理エージェント・ソフトウェアのRPMファイルを含むディレクトリに移動し、次のコマンドを実行してRPMファイルをインストールします:
```
sudo --preserve-env=JAVA_HOME dnf 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
## Disable requiretty for Management Agent
Defaults:mgmt_agent !requiretty
EOF

ファイルの権限を440に設定します。
```
sudo chmod 440 /etc/sudoers.d/mgmt_agent
```
管理エージェントのインストール・キーを作成したことを確認します。
コンソールで、インスタンスの登録に使用する管理エージェントのインストール・キーをコピーします。
1. ナビゲーション・メニューを開き、「監視および管理」を選択します。「管理エージェント」で、「ダウンロードとキー」を選択します。
2. 「インストール・キー」で、インスタンスの登録に使用するキーを検索します。
3. キーの「アクション」メニューを選択し、「キーをクリップボードにコピー」を選択します。
テキスト・エディタでレスポンス(input.rsp)ファイルを手動で作成し、<MACS_KEY>を前のステップでコピーしたインストール・キーに置き換えます。
たとえば:
```
cat >/tmp/input.rsp <<EOF
ManagementAgentInstallKey = <MACS_KEY>
Service.plugin.osmh.download = true
EOF
```
input.rspファイルには、次の必須パラメータが必要です。
- ManagementAgentInstallKey: ドメインのアイデンティティとインストールの信頼性を検証するために必要なインストール・キー。
- Service.plugin.osmh.download = true: エージェントのインストール中にOS管理ハブ(osmh)プラグインをデプロイします。
管理エージェントを構成するには、レスポンス・ファイルを使用して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管理ハブ・プラグインの設定には、バックグラウンドでさらに数分かかる場合があります。
トラフィックおよびアクセスを許可するようにファイアウォールおよびSELinux設定を構成します。
管理ステーションでは、設定時に定義されたポートを使用して、yumミラーを同期し、プロキシ・トラフィックをOCIに管理します。

ファイアウォール・ルールおよびSELinux設定を手動で更新するか、station-setup.shスクリプトを使用できます。

station-setup.shスクリプトは、ファイアウォールおよびSELinux設定を構成して、管理ステーションおよびApache HTTP Webサーバー上のプロキシ構成で指定したポートのトラフィックがミラー構成のパスからのパッケージを提供できるようにします。このスクリプトは、xfs、ext4、btrfsまたはnfsファイル・システムを使用して、ミラーのファイアウォールおよびSELinux構成を処理します。

重要

便宜上、station-setup.shスクリプトを使用してファイアウォールおよびSELinux設定を構成できます。本番環境でスクリプトを実行する前に、必ずスクリプトを確認し、スクリプトがファイアウォールおよびSELinux設定に加える変更を理解してください。
```
sudo /opt/oracle/mgmt_agent/plugins/osmh/stateDir/station-setup.sh
```
ノート

command not foundまたはNo such fileエラー・メッセージが表示された場合は、OS管理ハブ・プラグインの設定が完了し、station-setup.shスクリプトが使用可能になるまで数分待ちます。問題が解決しない場合は、登録が失敗している可能性があります。インスタンス・ステーションまたは管理ステーションの登録に失敗しましたを参照してください。
station-setup.shスクリプトを実行していない場合は、Apache HTTP Webサーバーを再起動します。
```
sudo systemctl restart httpd
```