インスタンスの登録に失敗しました

インスタンスは、いくつかの理由でAutonomous Linuxへの登録に失敗する可能性があります。

共通のosmh-agent.logエラー・メッセージ

登録の問題をトラブルシューティングするには、まずosmh-agent.logファイルで次のエラー・メッセージを調べます。ログ・ファイルの場所を特定するには、インスタンス上のログ・ファイルの調査を参照してください。

コードとメッセージ 考えられる原因と解決策

Http Status Code: 400. Error Code: MissingParameter.

Message: Registration profile is required for on-boarding instances, but none was provided.

原因: 登録時に互換性のあるデフォルト・プロファイルがありませんでした。

解決策: 互換性のあるプロファイルを識別して使用します。Invalid profile was usedを参照してください。

Http Status Code: 404. Error Code: NotAuthorizedOrNotFound.

Message: Authorization failed or requested resource not found.

原因: 現在のポリシーでは、サービスがインスタンスにアクセスできません。ほとんどの場合、動的グループには、インスタンスを含むコンパートメントの一致ルールが含まれていません。または、ポリシー・ステートメントが欠落しているか正しくありません。

解決策: ポリシーが正しいことを確認します。ポリシー・ステートメントが正しくないか、動的グループ・ルールがありませんを参照してください。

Http Status Code: 409. Error Code: Conflict.

Message: Invalid Managed Instance osFamily ORACLE_LINUX_8 does not match Profile osFamily: ORACLE_LINUX_7

原因: プロファイルに間違ったオペレーティング・システムがあります。たとえば、インスタンスはOracle Linux 8ですが、プロファイルはOracle Linux 7です。

解決策: 互換性のあるプロファイルを識別して使用します。Invalid profile was usedを参照してください。

Oracle Cloud Agentの一般的なエラー・メッセージ

OCIインスタンスの場合、OS管理ハブ・エージェントのプラグイン・ステータスを使用して登録の問題をトラブルシューティングします。コンソールの「コンピュート・インスタンスの詳細」ページの「Oracle Cloud Agent」タブに、次のいずれかのエラー・メッセージが表示される場合があります。

Error Message 考えられる原因と解決策

プラグインOS管理ハブ・エージェントがインスタンスocid1.instance.oc1.iadに存在しません。<ocid>

原因: OS管理ハブ・エージェントがインスタンスにインストールされていません。これは通常、ポリシーの問題のためにサービスがインスタンスにアクセスできない場合に発生します。

解決策: ポリシー・ステートメントが正しいこと、およびインスタンスが動的グループに含まれていることを確認します。ポリシー・ステートメントが正しくないか、動的グループ・ルールがありませんを参照してください。

[lookup image]を使用してosmh-agentを起動できませんでした。インスタンスをOS管理ハブに登録できませんでした。

原因: OS管理ハブ・エージェントをインスタンスで起動できません。これは通常、ポリシーの問題のためにサービスがインスタンスにアクセスできない場合に発生します。

解決策: ポリシー・ステートメントが正しいこと、およびインスタンスが動的グループに含まれていることを確認します。デフォルトのアイデンティティ・ドメインを使用しない場合は、ポリシー・ステートメントでアイデンティティ・ドメインを指定したことを確認します。ポリシー・ステートメントが正しくないか、動的グループ・ルールがありませんを参照してください。

rpcエラー: code = Unavailable desc = 接続エラー: desc = "transport: error while dialing: dial unix /var/lib/oracle-cloud-agent/tmp/plugin162329539: connect: connection refused"

原因: 複数のOCAプラグインが実行されています。OS管理ハブとOS管理プラグインは同時に実行できません。

解決策: OS管理プラグインを無効にします。複数のプラグインの実行を参照してください。

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

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

  1. osmh-agent.logファイルの場所を決定します
  2. ログ・ファイルを調べて、「エラー・コード」というキーワードをスキャンし、プロファイル・エラーが存在するかどうかを確認します。「一般的なosmh-agent.logエラー・メッセージ」を参照してください。

    たとえば、次のとおりです:

    sudo grep -i "error code" /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent/stateDir/log/osmh-agent.log
  3. 登録するインスタンスのOSバージョン、アーキテクチャおよび場所と一致するプロファイルを識別(または作成)します。

プロファイルを更新するには

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

    インスタンスのステータスの更新には数分かかる場合があります。

ポリシー・ステートメントが正しくないか、動的グループ・ルールがありません

インスタンスの登録時に次のエラーが発生した場合、ポリシー・ステートメントまたは動的グループ・ルールが正しく設定されていないことを示している可能性があります。

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>

または、「コンピュート・インスタンスの詳細」ページの「Oracle Cloud Agent」タブに、次のいずれかのメッセージが表示されます。

Plugin OS Management Hub Agent not present for instance ocid1.instance.oc1.iad.<ocid>
failed to start osmh-agent with [lookup image failed. The instance could not register with OS Management Hub.

この問題を解決するには、ポリシー・ステートメントおよび動的グループ・ルールが正しく構成されていることを確認してください。通常、動的グループにはインスタンスが含まれません。

次を確認します。

  • サービスで管理するインスタンスを含む各コンパートメントおよびサブコンパートメントの動的グループ・ルールが含まれていることを確認します。動的グループはコンパートメントの継承をサポートしていません。
  • defaultアイデンティティ・ドメインを使用しない場合は、各ポリシー・ステートメントに、グループまたは動的グループ名の前にアイデンティティ・ドメインがあることを確認します(たとえば、<identity_domain_name>/<dynamic_group_name>)。

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

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

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

  • /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent-unregister

複数のプラグインが実行されています

Oracle Cloud AgentのOS管理プラグインとOS管理ハブ・プラグインを同時に実行することはできません。コンソールのコンピュート・インスタンスの詳細の「Oracle Cloud Agent」タブに、次のエラーが表示される場合があります:

rpc error: code = Unavailable desc = connection error: 
desc = "transport: error while dialing: dial unix /var/lib/oracle-cloud-agent/tmp/plugin162329539: connect: connection refused"

OS管理プラグインを無効にします。

  1. ナビゲーション・メニューを開き、「コンピュート」「インスタンス」の順に選択します。
  2. インスタンスの名前を選択します。
  3. Oracle Cloudエージェント」タブを選択します。
  4. OS Management Service Agentプラグインを無効にします。