Oracle Cloud Infrastructureドキュメント

インスタンスまたは管理ステーションの登録に失敗しました

インスタンスまたは管理ステーションは、無効なプロファイルが使用された場合、OS時間が正しく設定されていない、動的グループ・ルールがない、またはインスタンスが以前に登録解除された場合に、OS管理ハブへの登録に失敗することがあります。

既知の問題も参照してください: 古いプラットフォーム・イメージまたは独自のイメージの持込みは登録されません。

無効なプロファイルが使用されました

次の条件は、インスタンスが無効なプロファイルに登録しようとしたことを示しています。

  • OS管理ハブのインスタンスのステータスはRegistration failedです。
  • osmh-agent.logファイルには、次のようなメッセージが表示されます。

    Message: Invalid Managed Instance osFamily ORACLE_LINUX_8 does not match Profile osFamily: ORACLE_LINUX_9。プロファイルのOSバージョンが間違っていることを示します。

    Message: Managed Instance location ON_PREMISE is not compatible with a Profile registration type of: OCI_LINUX。プロファイルのインスタンス・タイプが間違っていることを示します。

osmh-agent.logファイルを確認し、正しいプロファイルを特定します

  1. osmh-agent.logファイルの場所を決定します。
  2. ログ・ファイルを調べて、「Invalid」、「osFamily」、「compatible」などのキーワードをスキャンし、プロファイル・エラーがあるかどうかを判断します。

    たとえば、オンプレミス・インスタンスの場合:

    sudo grep -i -E "invalid|osfamily|compatible" /opt/oracle/mgmt_agent/plugins/osmh/stateDir/log/osmh-agent.log
  3. 現在のプロファイルに関する問題を特定します。

    • OSバージョンが正しくありません: Message: Invalid Managed Instance osFamily ORACLE_LINUX_8 does not match Profile osFamily: ORACLE_LINUX_9

      この例では、インスタンスは Oracle Linux 8ですが、プロファイルは Oracle Linux 9用でした。

    • 不正なインスタンス・タイプ: Message: Managed Instance location ON_PREMISE is not compatible with a Profile registration type of: OCI_LINUX

      この例では、インスタンスはオンプレミスまたはサードパーティ・クラウドに配置されていますが、プロファイルはOCIインスタンス・タイプ用でした。

  4. 登録するインスタンスのOSバージョン、アーキテクチャおよび場所に一致するプロファイルを識別(または作成)します。

    プロファイルを作成する場合:

    • オンプレミスまたはサードパーティ・クラウドの場合は、インスタンス・タイプとして「その他」を選択します。

    • OCIインスタンスの場合は、インスタンス・タイプとして「Oracle Cloud Infrastructure」を選択します。

OCIインスタンスの問題を解決するには

  1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「OS管理ハブ」で、「インスタンス」をクリックします。
  2. 「リスト・スコープ」で、インスタンスを含むコンパートメントを選択します。
  3. インスタンスの名前をクリックします。
  4. 「プロファイルの設定」をクリックします。
  5. 登録に使用するコンパートメントと正しいプロファイルを選択します。
  6. 「設定」をクリックします。

OCI以外のインスタンスの問題を解決するには:

  1. プロファイル詳細の表示。
  2. /etc/osmh-profileコンテンツをコピーします。
  3. sudo権限を持つユーザーとしてインスタンスにログインします。
  4. /etc/osmh-profileを正しいプロファイルに置き換えます。インスタンスは、次回OS管理ハブ・プラグインがサービスにチェックインしたときに登録されます。

OSが現在時刻に設定されていません

登録時のタイムアウト・エラーは、インスタンスの時間がOS管理ハブ・サービスで使用されている時間と異なる場合に発生する可能性があります。5分を超えるクロック・スキューを使用すると、これらのタイプのエラーが発生する可能性があります。

管理ステーションまたはインスタンスの登録時に、 /opt/oracle/mgmt_agent/agent_inst/bin/setup.shスクリプトの実行時に次のエラーが報告されます。
Starting plugin deployment for: [osmh]
Deploying service plugin(s)..............................Timed out.
        Agent is unable to check if it deployed requested service plugin(s) successfully or not. Please check back later on the console.
  1. 次のコマンドを使用して、managementagentサービス・エンドポイントの日付をインスタンスまたは管理ステーションと照合して、クロック・スキューが存在するかどうかを確認します。 
    curl -s --head https://managementagent.<region>.oci.oraclecloud.com | grep Date
    date -u

    たとえば:

    $ curl -s --head https://managementagent.us-phoenix-1.oci.oraclecloud.com | grep Date
Date: Tue, 13 Jun 2023 15:42:17 GMT
$ date -u
Tue Jun 13 15:42:19 UTC 2023
  2. インスタンスまたは管理ステーションの日時がサービスによってレポートされた時刻と異なる場合は、サービスと一致するようにOS時刻を更新します。
    Chronyや Network Time Protocol (NTP)などの時間同期機能を使用する場合は、設定と操作を確認します。

動的グループ・ルールがありません

osmh-agent.logに次のエラーが含まれている場合は、動的グループ・ルールが正しく設定されていない可能性があります。

ERROR: failed to update managed instance: Error returned by  Service. Http Status Code: 404.
                    Error Code: NotAuthorizedOrNotFound. Opc request id: <requestID>. Message: Authorization failed or requested resource not found.
                    ...
                    Request Endpoint: PUT https://osmh.<region>.oci.oraclecloud.com/20220901/agent/managedInstances/ocid1.managementagent.oc1.iad.<ocid>
問題を解決するには、動的グループ・ルールに、インスタンスが存在するコンパートメントが含まれていることを確認します。動的グループはコンパートメントの継承をサポートしていないため、サブコンパートメントを明示的に含める必要がある場合があります。「必要な動的グループ」を参照してください。

インスタンスは以前に登録解除されています

以前にOS管理ハブからインスタンスを登録解除した場合は、サービスに再登録するための追加のステップがあります。このプロセスは、インスタンスの位置によって異なります。

OCIインスタンス

登録解除されたOCIインスタンスの再登録は、インスタンス上の登録解除ファイルを削除するまで失敗します。このファイルにより、インスタンスがサービスに登録されなくなります。このファイルを含むインスタンスを登録しようとすると、エージェント・プラグインに次のエラーが表示されます: started oci-osmh under unregistered mode。

インスタンスを登録する前に、次のファイルを削除します。

  • 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管理ハブ・エージェント・プラグインの手動デプロイメントが必要になる場合があります。

インスタンスを再登録するには:

  1. sudo権限を持つユーザーとしてインスタンスにログインします。

  2. 管理エージェントのステータスを確認します。

    sudo systemctl status mgmt_agent
  3. mgmt_agentが見つからない場合は、インスタンスを新しいものとして登録します。OCI以外のインスタンスの登録を参照してください。この手順の残りのステップはスキップします。
  4. mgmt_agentが存在する場合は、エージェントを起動し、/etc/osmh-profileファイルを作成します。

    1. mgmt_agentを起動します。

      sudo systemctl start mgmt_agent

    2. テキスト・エディタを使用して、/etc/osmh-profileファイルを作成します。ファイル名にファイル拡張子がないことを確認してください。

      sudo vi /etc/osmh-profile

  5. コンソールで、OS管理ハブ・エージェント・プラグインをインスタンスにデプロイします。

    1. コンソールで、「監視および管理」に移動します。「管理エージェント」で、「エージェント」をクリックします。
    2. 「スコープ」で、コンパートメントを選択します。
    3. 「名前」列でホスト名を検索して、正しいエージェントを見つけます。リスト内のエージェントの名前をクリックします。
    4. 「プラグインのデプロイ」をクリックします。
    5. 「OS管理ハブ」を選択し、「更新」をクリックします。
    6. 数分待ってから、インスタンスが登録されていることを確認します。