Falha no Registro da Instância

Uma instância pode falhar ao se registrar no Autonomous Linux por vários motivos.

Mensagens de erro comum do osmh-agent.log

Para solucionar problemas de registro, comece examinando o arquivo osmh-agent.log das mensagens de erro a seguir. Consulte Examinando Arquivos de Log em uma Instância para identificar a localização do arquivo de log.


Código e Mensagem	Possível causa e solução
`Http Status Code: 400. Error Code: MissingParameter.` `Message: Registration profile is required for on-boarding instances, but none was provided.`	Causa: Não havia um perfil padrão compatível no registro. Resolução: Identifique e use um perfil compatível. Consulte Perfil inválido usado.
`Http Status Code: 404. Error Code: NotAuthorizedOrNotFound.` `Message: Authorization failed or requested resource not found.`	Causa: As políticas atuais não permitem que o serviço acesse a instância. Geralmente, o grupo dinâmico não inclui regras de correspondência para o compartimento que contém a instância. Ou há uma instrução de política ausente ou incorreta. Resolução: Verifique se as políticas estão corretas. Consulte Instrução de política incorreta ou regra de grupo dinâmico ausente.
`Http Status Code: 409. Error Code: Conflict.` `Message: Invalid Managed Instance osFamily ORACLE_LINUX_8 does not match Profile osFamily: ORACLE_LINUX_7`	Causa: O perfil tem o sistema operacional errado. Por exemplo, a instância é o Oracle Linux 8, mas o perfil é o Oracle Linux 7. Resolução: Identifique e use um perfil compatível. Consulte Perfil inválido usado.

Mensagens Comuns de Erro do Agente do Oracle Cloud

Para instâncias do OCI, use o status de plug-in do OS Management Hub Agent para solucionar problemas de registro. Na Console, na guia Oracle Cloud Agent da página de detalhes da instância do serviço Compute, você poderá ver uma das mensagens de erro a seguir.


Mensagem de Erro	Possível causa e solução
`O Agente do Hub de Gerenciamento do SO de Plug-in não está presente para a instância ocid1.instance.oc1.iad.<ocid>`	Causa: O agente do OS Management Hub não está instalado na instância. Isso geralmente ocorre quando o serviço não pode acessar a instância por causa de um problema de política. Resolução: Verifique se as suas instruções de política estão corretas e se a instância está incluída no grupo dinâmico. Consulte Instrução de política incorreta ou regra de grupo dinâmico ausente.
`falha ao iniciar osmh-agent com [falha na imagem de pesquisa]. A instância não pôde se registrar no OS Management Hub.`	Causa: O agente do OS Management Hub não pode ser iniciado na instância. Isso geralmente ocorre quando o serviço não pode acessar a instância por causa de um problema de política. Resolução: Verifique se as suas instruções de política estão corretas e se a instância está incluída no grupo dinâmico. Se não estiver usando o domínio de identidades padrão, verifique se você especificou o domínio de identidades nas instruções de política. Consulte Instrução de política incorreta ou regra de grupo dinâmico ausente.

O perfil inválido foi usado

Verifique o arquivo osmh-agent.log e identifique o perfil correto

Determinar a localização do arquivo osmh-agent.log.
Examine o arquivo de log, procurando a palavra-chave "Error Code" para determinar se existe um erro de perfil. Consulte Mensagens de Erro Common osmh-agent.log.
Por exemplo:
```
sudo grep -i "error code" /var/lib/oracle-cloud-agent/plugins/oci-osmh/osmh-agent/stateDir/log/osmh-agent.log
```
Identifique (ou crie) um perfil que corresponda à versão, à arquitetura e ao local do sistema operacional da instância que você está registrando.

Para atualizar o perfil

Abra o menu de navegação e selecione Observabilidade e Gerenciamento.
Em Autonomous Linux, selecione Instâncias.
Selecione o compartimento que contém a instância que você está interessado.
Selecione o nome da instância.
Selecione Definir perfil.
Selecione o compartimento e o perfil correto a ser usado para registro.
Selecione Definir.

Pode levar alguns minutos para que o status da instância seja atualizado.

Instrução de política incorreta ou regra de grupo dinâmico ausente

Se você encontrar os erros a seguir ao registrar uma instância, isso poderá indicar que as instruções de política ou as regras de grupo dinâmico não estão definidas corretamente.

O osmh-agent.log contém:

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>

Ou a guia Oracle Cloud Agent na página de detalhes da instância do serviço Compute mostra uma das seguintes mensagens:

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.

Para resolver o problema, verifique se você configurou corretamente as instruções de política e as regras de grupo dinâmico. Geralmente, o grupo dinâmico não inclui a instância.

Verifique o seguinte:

Certifique-se de ter incluído uma regra de grupo dinâmico para cada compartimento e compartimento filho que contém instâncias que você deseja gerenciar pelo serviço. Os grupos dinâmicos não suportam herança de compartimento.
Se não estiver usando o domínio de identidades default, certifique-se de que cada instrução de política tenha o domínio de identidades antes do nome do grupo ou do grupo dinâmico (por exemplo, <identity_domain_name>/<dynamic_group_name>).

A instância não foi registrada anteriormente

O novo registro de uma instância que não foi registrada falhará até que você remova o arquivo de cancelamento de registro na instância. Esse arquivo impede que a instância se registre no serviço. Quando você tenta registrar uma instância que contém esse arquivo, o plug-in do agente exibe o seguinte erro: started oci-osmh under unregistered mode.

Remova o seguinte arquivo antes de registrar a instância:

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