インスタンスの登録解除
OS管理ハブからインスタンスを登録解除すると、サービスによって管理されなくなります。
コンソールの使用
- インスタンスを登録解除するとどうなりますか。
- OCIインスタンスの場合、登録を解除する前に、必要なポリシーが設定されていることを確認します。
- 「リスト・スコープ」で、インスタンスを含むコンパートメントを選択します。
- インスタンスの名前を選択します。
- (オプション)インスタンスのジョブ履歴およびレポートを確認します。この情報は、インスタンスの登録解除後には使用できません。以下を参照してください。
- 「登録解除」を選択します。
- (オプション)オンプレミスまたはサードパーティ・クラウド・インスタンスで、管理エージェント・サービスを使用する必要がなくなった場合は、
mgmt_agent
パッケージを削除します。- Oracle Linux 8または9
-
sudo dnf remove oracle.mgmt_agent
- Oracle Linux 7
-
sudo yum remove oracle.mgmt_agent
OCIの管理エージェントCloud Service (MACS)から対応する管理エージェント・リソースを削除するには、管理エージェントの削除を参照してください。
インスタンスが登録解除されると、どうなりますか。
Oracle Linuxインスタンスの場合、登録解除すると、インスタンスがサービスに登録される前の状態にyumまたはdnfリポジトリ・ファイルがリストアされます。
必要なポリシーを設定せずにOCIインスタンスを登録解除すると、ブロッカ・ファイル(osmh-agent-unregister
)が作成され、インスタンスがサービスに自動的に再登録されないようになります。インスタンスを再登録する場合は、このファイルを削除する必要があります。トラブルシューティング: インスタンスは以前に登録解除されましたを参照してください。
ブロッカ・ファイルは次のとおりです。
-
Oracle Linux
/var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent-unregister
-
Windows 2019および2022
C:\Windows\ServiceProfiles\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent-unregister
-
Windows 2016
C:\Users\OCAOSMH\AppData\Local\OracleCloudAgent\plugins\oci-osmh\osmh-agent-unregister
非OCIインスタンスを登録解除すると、インスタンスからOS管理ハブ・エージェント・プラグインが削除されます。オプションで、管理エージェント・ソフトウェアをシステムから削除することもできます。管理エージェントを削除せず、インスタンスを再登録する場合は、OS管理ハブ・プラグインを手動でデプロイする必要があります。トラブルシューティング: インスタンスは以前に登録解除されましたを参照してください。
OCIインスタンスの登録を解除するためのポリシー要件
OCIインスタンスの登録を解除する前に、次のポリシー・ステートメントのいずれかが設定されていることを確認してください。次のポリシーがないと、OS管理ハブによってブロッキング・ファイル(osmh-agent-unregister
)が作成され、インスタンスがサービスに自動的に再登録されないようになります。
allow dynamic-group <dynamic-group> to use instance in compartment <compartment>
または
allow dynamic-group <dynamic-group> to {INSTANCE_UPDATE} in compartment <compartment>
- ポリシー:
-
- OS管理ハブOCAプラグインが無効です。
- 登録ブロッカ・ファイルは作成されません。
- OS管理ハブOCAプラグインを再度有効にすることで、インスタンスを再登録できます。
- ポリシーなし:
-
- OS管理ハブOCAプラグインは有効なままです。
- エージェントがサービスでチェックインしないように、登録ブロッカ・ファイル(
osmh-agent-unregister
)が作成されます。 - インスタンスを再登録するには、ブロッカ・ファイルを手動で削除する必要があります。トラブルシューティング: インスタンスは以前に登録解除されましたを参照してください
OCAプラグインの登録解除と無効化の違いは何ですか。
OCIインスタンスの場合、コンピュート・サービス内のOS管理ハブOCAプラグインの無効化は、インスタンスの登録解除と同じではありません。同様の効果がありますが、登録解除するとサービスからインスタンスが削除されます。プラグインを無効にすると、インスタンスはサービス内に残りますが、チェックインは停止します。
インスタンスを登録解除する場合(コンソールを使用するか、DeleteManagedInstance API操作を使用):
-
osmh-agentは、サービスをチェックインしなくなりました。
-
インスタンスがOS管理ハブから削除されます。
-
必要なポリシーが設定されている場合、OS管理ハブOCAプラグインは無効になります。
-
OS管理ハブを再度使用するには、インスタンスを再登録する必要があります。
コンピュート・サービス内でOS管理ハブOCAプラグインを無効にする場合:
-
osmh-agentは、サービスをチェックインしなくなりました。
-
インスタンスはOS管理ハブに残ります。「非アクティブ」状態になり、「オフライン」状態になります。
- オフライン・インスタンスが再利用される場合については、保持ポリシーを参照してください。
-
プラグインを再有効化すると、インスタンスはOS管理ハブでチェックインできます。OS Management Hubを再度使用するために再登録する必要はありません。