• Solução de problemas: desinstale o agente e remova o arquivo de serviço antes de instalar o novo agente!
• Solução de problemas: o Java não é uma JVM de 64 bits! Defina o caminho de uma JVM de 64 bits na variável de ambiente JAVA_HOME, ou o Java não foi encontrado. Defina o caminho de sua preferência em JAVA_HOME.
• Solução de problemas: Falha na instalação do agente com a mensagem: useradd: Não é possível obter GID exclusivo (não há mais GIDs disponíveis).
• Solução de problemas: useradd: não é possível criar o diretório /usr/share/mgmt_agent
• Solução de problemas: Windows: O sistema não pode localizar o caminho especificado. Falha na instalação do agente.
• Solução de Problemas: o status do Management Agent é "Não Disponível" na Console após a instalação inicial
• Solução de Problemas: Após a configuração, o Agente de Gerenciamento não fica visível na console ou por meio da API
• Solução de problemas: As métricas do Prometheus ou do Kubernetes monitoradas usando o Management Agent não estão disponíveis
• Solução de problemas: O agente é executado em OutOfMemoryException
• Solução de problemas: o OCI Management Agent não está sendo iniciado no host do Windows
• Solução de problemas: o upgrade automático do Management Agent não está funcionando ou ignorou alguns Agentes
• Solução de problemas: o endereço IP que está sendo exibido na coluna do host quando o Management Agent está instalado no host do Windows
• Solução de problemas: falha na instalação do Management Agent em SELinux ao usar o volume externo
• Solução de problemas: falha na instalação do Management Agent no Red Hat Enterprise Linux 9.x
• Solucionar Problemas: Falha na Instalação do Agente - JavaHome não está definido abortando a instalação do agente
• Solução de Problemas: Falha ao Instalar o Management Agent no valor RUN_AGENT_AS_USER esperado do Linux como raiz
• Solução de problemas: Falha ao acessar o script usando um caminho absoluto. Permissões insuficientes
• Solução de problemas: Falha na tentativa de registro na nuvem com o Status HTTP 407, Credenciais incorretas do Gateway Server
• Solução de Problemas: Não é Possível Exibir Namespace e Métricas do Prometheus no Serviço Monitoring
• Solução de problemas: Flag fornecido, mas não definido
• Solução de problemas: Falha ao adicionar credenciais SSH com erro: caractere sem aspas ilegal
• Solução de problemas: erro de caminho do certificado
• Solução de Problemas: Não é Possível Instalar o Oracle Management Agent na Instância do Windows
• Solução de problemas: quando você instala o agente de gerenciamento e vê mensagens de tempo limite de conexão de rede
• Solução de problemas: CloudRegistrationStep: Falha na tentativa de registro com o Status 401 do HTTP (As informações necessárias para concluir a autenticação não foram fornecidas ou estavam incorretas)
• Solução de problemas: "code": "NotAuthenticated","message": "As informações necessárias para concluir a autenticação não foram fornecidas ou estavam incorretas.

Diagnosticar e Solucionar Problemas: Desinstale o agente e remova o arquivo de serviço antes de instalar o novo agente!

Causa: Já existe um agente instalado no seu host. Um processo de desinstalação anterior não removeu o arquivo de serviço do agente com sucesso.

Solução de problemas: o Java não é uma JVM de 64 bits. Defina o caminho de uma JVM de 64 bits na variável de ambiente JAVA_HOME ou Java não encontrado. Defina o caminho de sua preferência em JAVA_HOME.

Causa: A variável de ambiente JAVA_HOME não está definida ou não está apontando para uma localização do JDK de 64 bits.

Ação: Defina a variável de ambiente JAVA_HOME para a versão correta do JDK e tente instalar o agente novamente. Atualmente, só há suporte para JDK de 64 bits.

Solução de problemas: Falha na Instalação do Agente com a mensagem: useradd: Não é possível obter GID exclusivo (não há mais GIDs disponíveis)

Causa: O script de instalação não pode adicionar um usuário e um grupo durante o processo de instalação do agente de gerenciamento porque os IDs de grupo disponíveis no sistema Linux já estão em uso.

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent) 
useradd: Can't get unique GID (no more available GIDs) 
useradd: can't create group 
Agent installation failed, please check log file

Ação: Consulte o administrador do sistema antes de prosseguir com o seguinte:

1. Edite o arquivo /etc/login.defs. Você precisa de privilégios sudo para editar o arquivo.

   Procure as seguintes entradas:

   SYS_GID_MIN               nnnn
   SYS_GID_MAX               mmmm
   SYS_UID_MIN               pppp
   SYS_UID_MAX               qqqq

   Em que nnnn e pppp são o valor mínimo e mmmm e qqqq são o valor máximo.

   Se não existirem as entradas acima no arquivo, adicione-as.

2. Atualize o valor da entrada SYS_GID_MAX com base na recomendação do administrador do sistema e salve o arquivo.

3. Remova a instalação do agente com falha executando: sudo rpm -e oracle.mgmt_agent.

4. Efetue log-out do shell seguido de login.

5. Repita a instalação do agente.

Solução de problemas: useradd: não é possível criar o diretório /usr/share/mgmt_agent

Durante a instalação do Management Agent, o usuário mgmt_agent é criado com a localização padrão do diretório home em /usr/share/mgmt_agent.

Causa: Não há permissões de arquivo suficientes em /usr/share ou o sistema de arquivos é somente para leitura.

Ações Possíveis:

• Defina permissões de arquivo para conceder ao usuário mgmt_agent acesso ao local padrão do diretório home do usuário: /usr/share.

• Defina outro local do diretório home usando a variável de ambiente USER_HOME_DIR_ROOT se quiser usar outro local.

  Defina a variável de ambiente USER_HOME_DIR_ROOT com o caminho que você deseja usar como diretório home para o usuário mgmt_agent e certifique-se de que o usuário do agente de gerenciamento tenha as permissões de arquivo corretas nesse diretório de sua preferência.

Solução de problemas: Windows: o sistema não pode encontrar o caminho especificado. Falha na instalação do agente.

ERRORLEVEL=9009

Possível Causa: As variáveis de ambiente não foram definidas corretamente devido a espaços no nome do diretório/pasta.

Os ambientes Windows permitem o uso de espaços em um nome de diretório/pasta, o que causa um problema com a instalação do Management Agent, uma vez que aspas são adicionadas ao nome automaticamente pelo Windows. Por exemplo, há um diretório/pasta chamado: Program Files. Nesse caso, o Windows insere cotações automaticamente, pois há um espaço dentro do nome da pasta e agora diz: "Program Files".

As aspas extras podem causar um problema, pois o instalador do Management Agent não permite cotações para variáveis de ambiente, como JAVA_HOME e AGENT_INSTALL_BASEDIR.

Ação:

Diagnosticar e Solucionar Problemas: O status do Management Agent é "Não Disponível" na Console após a instalação inicial

Possível Causa 1: Timestamp do sistema incorreto

Ação: Verifique o horário do sistema do host do agente e, em seguida, você poderá corrigir o horário, se necessário.

Possível Causa 2: Se você usar o arquivo de resposta input.rsp para o Management Agent, defina as tags para o compartimento do Management Agent.

Se as tags não estiverem definidas, você poderá ver um erro como este:

Attempts:
<--> Endpoint:       management-agent.us-ashburn-1.oci.oraclecloud.com
     opc-request-id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXJ8
     StartTime:      2024-09-18 03:45:12,662 GMT
     Status:         400 Bad Request
     Headers:        Strict-Transport-Security=max-age=31536000; includeSubDomains;
                     Connection=close
                     Content-Length=63
                     opc-request-id=XXXXXXXXXXXXXXXXXXXXXXXX..................B25ADA8E
                     Date=Wed, 18 Sep 2024 03:45:12 GMT
                     Content-Type=application/json
     ErrorBody:      
{
  "code" : "InvalidParameter",
  "message" : "Invalid tags"
}

Ação: Para definir as tags específicas do seu ambiente, no arquivo de resposta input.rsp, adicione os parâmetros a seguir e especifique os pares de chave/valor do seu ambiente. Para obter mais informações, consulte Criar um arquivo de Resposta .

DefinedTags = [{"namespace1":{"<key1>":"<value1>"}},
      {"namespace2":{"<key2>":"<value2>"}}]

Diagnosticar e Solucionar Problemas: Após a configuração, o Agente de Gerenciamento não fica visível na console ou por meio da API

Possível Causa: Se, depois de configurar o agente de gerenciamento ou o agente do gateway de gerenciamento, o agente não for exibido na console do Oracle Cloud ou por meio da API, as políticas corretas poderão não ser configuradas para o usuário ou o grupo de usuários.

Ação: Verifique se o usuário ou o grupo de usuários tem as políticas necessárias configuradas para o agente de gerenciamento ou o agente de gateway. Para configurar políticas, consulte Criar políticas para o grupo de usuários.

Solução de problemas: As métricas do Prometheus ou do Kubernetes monitoradas usando o Management Agent não estão disponíveis

Diagnosticar e Solucionar Problemas: O agente é executado em OutOfMemoryException

Possível Causa: O agente pode ficar sem memória heap se não estiver ajustado corretamente para suportar a carga que foi atribuída a ele.

Ação: Atualize as definições de memória heap para o Agente de Gerenciamento.

Diagnosticar e Solucionar Problemas: o OCI Management Agent não está sendo iniciado em um host do Windows

Diagnosticar e Solucionar Problemas: O upgrade automático do Management Agent não está funcionando ou ignorou alguns Agentes

Possível Causa: Se o upgrade automático do OCI Management Agent não estiver funcionando para alguns dos Management Agents, é possível que o upgrade automático do Management Agent tenha parado de funcionar porque alguns dos arquivos ou diretórios eram de propriedade de proprietários inválidos no sistema de arquivos do Agente.

Por exemplo, se alguns arquivos ou diretórios no local a seguir não tiverem as permissões corretas, o upgrade automático do agente não funcionará: /opt/oracle/mgmt_agent/agent_inst.

Neste arquivo de log, você pode encontrar o seguinte erro: /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log

ERROR - Following files are owned by invalid owners: [/opt/oracle/mgmt_agent/db00_cred.json,
/opt/oracle/mgmt_agent/agent_inst/config/emd.properties.backup]
(ManagedAgent upgrade checker)-32] WARN - Files with invalid owners were found, skipping auto-upgrade

Ação: No host do Agente de Gerenciamento, confirme no sistema de arquivos do Agente que todos os arquivos e diretórios pertencem ao proprietário mgmt_agent e ao grupo mgmt_agent:mgmt_agent para que o upgrade automático do Agente de Gerenciamento possa ser concluído.

Diagnosticar e Solucionar Problemas: O endereço IP que está sendo exibido na coluna do host quando o Management Agent está instalado no host do Windows

Problema: O Management Agent está instalado em um host do Windows e a console do Management Agent exibe o endereço IP do host do Windows na Console do Oracle Cloud, em vez de exibir um nome de domínio totalmente qualificado ou um nome de host do Windows.

A instalação do Management Agent deve ser bem-sucedida e, na página Agente, o FQDN do host do Windows seria exibido na coluna do host.

Solução de problemas: Falha na instalação do Management Agent em SELinux ao usar o volume externo

systemctl start mgmt_agent
Job for mgmt_agent.service failed because the control process exited with error code.
See "systemctl status mgmt_agent.service"and "journalctl -xeu mgmt_agent.service" for details.

journalctl -xeu mgmt_agent.service
...
Dec 08 15:48:19 ol9-arm systemd[1261408]: mgmt_agent.service: Failed to execute /dir1/oracle/managementagent/agent_inst/bin/agentcore: Permission denied
Dec 08 15:48:19ol9-arm systemd[1261408]: mgmt_agent.service: Failed at step EXEC spawning /dir1/oracle/managementagent/agent_inst/bin/agentcore: Permission denied

$ ausearch -ts recent -m avc -i
...
type=AVC msg=audit(12/08/202315:49:26.991:51338) : avc:  denied  { read open } for  pid=1261576comm=(gentcore) path=/dir1/oracle/managementagent/agent_inst/bin/agentcore dev="dm-0"ino=915154scontext=system_u:system_r:init_t:s0           tcontext=unconfined_u:object_r:default_t:s0 tclass=file permissive=0

Todas as mensagens de erro acima indicam que o SELinux não permite executar comandos na pasta escolhida.

Ação: Entre em contato com o administrador do sistema e crie as políticas necessárias que permitem instalar e executar o Management Agent.

Solução de problemas: Falha na instalação do Management Agent no Red Hat Enterprise Linux 9.x

A instalação do Management Agent falha e a seguinte mensagem de erro pode ser exibida: mgmt_agent service creation failed. Reason: Detected Linux .

Além disso, as mensagens de log de falha de instalação podem confirmar o erro e indicar que as tentativas de configuração usam um gerenciador de serviços incorreto para instalar o agente.

Causa: A Red Hat removeu o pacote chkconfig na distribuição do Red Hat Enterprise Linux (RHEL) 9. Para obter mais detalhes, consulte a Base de Conhecimento da Red Hat.

Ação:

Solução 1 - Instale o pacote chkconfig

1. Instale o pacote ausente executando o seguinte comando:

   $ dnf install chkconfig

2. Verifique se o pacote existe no ambiente executando o seguinte comando:

   $ rpm -qa | grep chkconfig

3. Instale o Management Agent novamente.

Solução 2 - Sem instalar o pacote chkconfig

Se a instalação do pacote chkconfig não for uma opção, conforme descrito na seção Solução 1 acima, conclua as etapas a seguir como uma solução alternativa para instalar o software Management Agent.

$ sudo /bin/bash

$ export DIST_LINUX_FAMILY_OVERRIDE="Red Hat"

# RPM install
$ rpm -ivh <rpm_file_name.rpm>

# ZIP install
$ ./installer.sh <full_path_of_response_file>

Solução de Problemas: Falha ao Instalar o Management Agent no valor RUN_AGENT_AS_USER esperado do Linux como raiz

Se você instalar o agente e ver o erro a seguir, altere as permissões para o usuário que está instalando o agente.

rpm -ivh oracle.mgmt_agent.240229.1733.Linux-x86_64.rpm
Preparing...################################# [100%]
Checking pre-requisites
Checking available disk space for agent upgrade
Current agent run-as-user is root
Current user group is rootroot is not the default user, checking if required environment variables are set
RUN_AGENT_AS_USER=mgmt_agent contains an unexpected value
Expected RUN_AGENT_AS_USER value to be root, exiting
error: %pre(oracle.mgmt_agent-240229.1733-1.x86_64) scriptlet failed, exit status 1
error: oracle.mgmt_agent-240229.1733-1.x86_64: install failed

Solução:

Solução de problemas: Falha ao acessar o script usando um caminho absoluto. Permissões insuficientes

Se você encontrar o erro a seguir, poderá alterar as permissões para corrigir esses problemas.

Copying files to destination dir (/opt/oracle/mgmt_agent)Initializing software from templateChecking if JavaScript engine is available to useCreating mgmt_agent daemonmgmt_agent service creation failed. Reason: Failed to access the script using an
        absolute path. Insufficient permissions may prevent the user "mgmt_agent" from traversing
        one of the folders. Please check the following permissions

Solução: Você pode configurar o diretório /opt/oralce com 755 permissões para permitir o acesso do instalador do agente.

Solução de problemas: Falha na tentativa de registro na nuvem com o Status HTTP 407, Credenciais incorretas do Gateway Server

Se você instalar o Management Agent e o CloudRegistrationStep falhar com o erro HTTP Status 407 a seguir, poderá ser resultado de credenciais GatewayServerUser ou GatewayServerPassword incorretas.

CloudRegistrationStep: The registration attempt failed with HTTP Status 407
Additional details are available in the configure logs at /opt/oracle/mgmt_agent/configure-logs 

Diagnosticar e Solucionar Problemas: Falha na Instalação do Agente JAVA_HOME não está definido abortando a instalação do agente

rpm -ivh oracle.mgmt_agent.240229.1733.Linux-x86_64.rpmPreparing...################################# [100%]
Checking pre-requisites
Checking available disk space for agent upgrade
Current agent run-as-user is rootCurrent user group is rootroot is not the default user, checking if required environment variables are set
Checking agent version
Updating / installing...
1:oracle.mgmt_agent-240229.xxxx-1################################# [100%]
Failed to get unit file state for mgmt_agent.service: No such file or directory
Executing install
JavaHome is not set aborting agent install
warning:%post(oracle.mgmt_agent-240229.1733-1.x86_64) scriptlet failed, exit status 1

Solução de Problemas: Não é Possível Exibir Namespace e Métricas do Prometheus no Serviço OCI Monitoring

Na Console do OCI, se as políticas necessárias estiverem configuradas corretamente e o Namespace e as métricas do Prometheus não estiverem visíveis no OCI Monitoring no Metric Explorer, talvez você precise confirmar que o usuário do SO mgmt_agent tem permissões de leitura para o arquivo .properties.

agent_inst/discovery/PrometheusEmitter/compute_exporter.properties 

Solução de Problemas: Flag fornecido, mas não definido

Erro: Se você vir o seguinte erro: flag fornecido, mas não definido: -trusted-certs-dir

$ sudo -u oracle-cloud-agent /usr/libexec/oracle-cloud-agent/plugins/oci-managementagent/oci-managementagent -cli -trusted-certs-dir=/tmp/trustedcerts
flag provided but not defined: -trusted-certs-dir
Usage of /usr/libexec/oracle-cloud-agent/plugins/oci-managementagent/oci-managementagent:
  -agent-config string
        agent config yml file
  -cli
        run the monitoring in cli mode
  -debug
        enable debug logging
  -dev
        enable dev runs
  -force-redeploy
        force redeploy image
  -metadata-config string
        metadata config json file
  -oci-config string
        oci config file
  -staging
        enable staging endpoint
  -upgrade-native-agent
        invoke native agent upgrade

Solução de problemas: Falha ao adicionar credenciais SSH com erro: caractere sem aspas ilegal

Possível Causa: Se você vir o seguinte erro ao instalar o agente, poderá ter um componente de rede que esteja injetando seus próprios certificados. Ou se você encontrar o erro ao instalar o agente e se ele estiver se conectando por meio de um proxy, o proxy poderá injetar um certificado personalizado. Você precisará consultar o administrador para obter o certificado personalizado e, em seguida, seguir as etapas abaixo.

Solução de Problemas: Não é Possível Instalar o Oracle Management Agent na Instância do Windows

Diagnosticar e Solucionar Problemas: Quando você instala o agente de gerenciamento e vê mensagens de timeout de conexão de rede

Solução de problemas: CloudRegistrationStep: Falha na tentativa de registro com o Status 401 do HTTP (As informações necessárias para concluir a autenticação não foram fornecidas ou estavam incorretas)

Causa: Este problema pode ocorrer devido a uma chave de resposta inválida ou incorreta.

Ação: Certifique-se de ter uma chave válida. Para obter mais detalhes, consulte Gerenciar Chaves de Instalação.

Solução de problemas: "code": "NotAuthenticated","message": "As informações necessárias para concluir a autenticação não foram fornecidas ou estavam incorretas.

Causa: Este problema pode ocorrer devido a uma chave de resposta expirada.

Ação: Certifique-se de ter uma chave válida. Para obter mais detalhes, consulte Gerenciar Chaves de Instalação.

• Erro:... especifica vários pacotes
• Erro: falha no scriptlet com o código de saída

Erro:... especifica vários pacotes

Causa: O registro do rpm tem vários pacotes com esse nome.

rpm -e oracle.mgmt_agent --allmatches

Erro: falha no scriptlet com o código de saída

Causa: O rpm não pôde interromper o agente em execução ou falhou ao remover o arquivo de serviço do agente do sistema.

• Solução de problemas: o upgrade automático está ativado, mas o Agente não faz upgrade automaticamente por causa do proprietário do arquivo inválido

Solução de problemas: o upgrade automático está ativado, mas o agente não faz upgrade automaticamente porque o proprietário do arquivo é inválido

Se a versão do Agente não for atualizada depois de esperar por 24 horas, alguns problemas no disco poderão estar impedindo o Agente de fazer upgrade automaticamente.

A causa mais comum desse erro é que OS arquivos pertencem a um usuário do SO que é diferente do usuário que instalou o Management Agent. O processo de atualização é executado como o mesmo usuário do SO que o processo atual em execução e não tem a capacidade de alternar para a raiz. Qualquer arquivo no diretório mgmt_agent criado manualmente pelo usuário tem o potencial de interferir na capacidade do Agente de fazer upgrade automaticamente.

• Solução de problemas: o agente está no estado 'Não Disponível'
• Solução de problemas: falha na configuração do Management Agent com fork/exec oracle.polaris.oca.main: permissão negada
• Solução de problemas: falha de autenticação do Management Agent em decorrência de desvio de relógio, um horário diferente na instância de computação em comparação com o horário no servidor
• Solução de Problemas: Serviço OCI Management Agent: Agente Não Visível na Console do OCI em Observabilidade e Gerenciamento

Solução de problemas: O agente está no estado Não Disponível e os relatórios do arquivo de log do agente "Tags inválidas"

A página Agentes de Gerenciamento mostra o Agente no estado 'Não disponível' e o arquivo mgmt_agent.log (localizado no diretório <Agent_Inst>/logs) reporta a seguinte mensagem:

ErrorBody:{"code" : "InvalidParameter","message" : "Invalid tags: Resource creation failed because the resource requires tag value(s). Adicione um valor a cada uma das seguintes definições de tag: \nGLOBAL.ComponentType, GLOBAL.ApplicationName,

Causa:

Esse problema pode acontecer quando o compartimento requer tags obrigatórias para cada recurso e a solicitação de criação do recurso não inclui as tags; em seguida, a solicitação de ativação falharia com a mensagem:"Tags inválidas: Falha na criação do recurso porque o recurso exige valores de tag)" e o status do agente é mostrado como 'Não Disponível'.

Ação:

• Agentes de Gerenciamento

  Se você tiver um Management Agent independente, ele deverá ser desinstalado.

  Se o Management Agent tiver sido instalado usando um RPM ou um arquivo ZIP, ele deverá ser desinstalado e reinstalado fornecendo um arquivo de resposta usando o parâmetro DefinedTags, conforme descrito na seção Revisar Parâmetros do Agente.

• Management Agents em Instâncias do Serviço Compute
  Se o Management Agent estiver ativado por meio da Console do OCI usando o plug-in do OCA, não haverá arquivo de resposta, pois ele não será usado para instâncias de computação. Nesse caso, faça o seguinte:

  1. Faça log-in na instância na qual o Management Agent está implantado e sudo como usuário oracle-cloud-agent usando o seguinte comando:

     sudo -u oracle-cloud-agent sh

  2. Crie um arquivo agent.definedtags no seguinte local:/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/security/resource/
  3. Adicione tags definidas necessárias para que o recurso seja criado no arquivo agent.definedtags.

     Por exemplo, se houver 2 namespaces admin_namespace e finance_namespace

     e cada namespace usa 2 chaves e 2 valores environment_type=non-prod, sensitivity=restricted; em seguida, você pode usar o seguinte:

     DefinedTags = [{"admin_namespace": {"environment_type": "non-prod",
         "sensitivity": "restricted"}, "finance_namespace": {"environment_type":
         "non-prod","sensitivity": "restricted"}}]

  4. Reinicie o oracle-cloud-agent usando o comando:

     sudo systemctl restart oracle-cloud-agent

Solução de problemas: falha na configuração do Management Agent com fork/exec oracle.polaris.oca.main: permissão negada

Os usuários podem encontrar este erro resultando em falha ao instalar ou iniciar o Management Agent.

A mensagem de erro mostrada na view Plug-in da instância de computação do Plug-in do Management Agent é semelhante à seguinte:

workflow.go:23: [ERROR] step [*core.SetupImageStep] execution failed with [setup image failed with [fork/exec 230821.1905/bin/oracle.polaris.oca.main: permission denied]]
mgmtagent_image.go:139: [ERROR] bootstrap workflow failed with error setup image failed with [fork/exec 230821.1905/bin/oracle.polaris.oca.main: permission denied]
agent.go:74: [ERROR] failed to start agent during bootstrap with [setup image failed with [fork/exec 230821.1905/bin/oracle.polaris.oca.main: permission denied]]

Possível Causa:

Esse problema pode acontecer quando uma instância de computação não permite operações fork/execute do diretório /tmp montando o tmpfs com o flag noexec.

$ mount | grep tmpfs
tmpfs on /tmp type tmpfs (rw,nosuid,nodev,noexec,inode64)

A saída deve dizer tem o flag noexec.

Ação:

1. Interrompa o Oracle Cloud Agent.

    sudo systemctl stop oracle-cloud-agent

2. Adicione a seguinte definição ao arquivo: /etc/oracle-cloud-agent/plugins/oci-managementagent/config.yml

   overrideTmpDir: true

3. Inicie o Oracle Cloud Agent.

   $ sudo systemctl start oracle-cloud-agent

Solução de problemas: falha de autenticação do Management Agent em decorrência de desvio de relógio, um horário diferente na instância de computação em comparação com o horário no servidor

Causa: Se houver uma defasagem de relógio de mais de 5 minutos entre a Instância de Computação em que o agente está sendo executado e o serviço Oracle Cloud Infrastructure Identity, as solicitações serão rejeitadas com um HTTP 401.

Na Instância do OCI Compute, vá para a guia Oracle Cloud Agent, o Management Agent exibe um erro na coluna Mensagem:

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

Ou nos logs, você pode encontrar o seguinte erro:

2022-12-09 07:41:22,144 [SysExecutor.0 (Resource Principal Token Refresher)-47] WARN  - #-#  invocation access log [request-id-prefix: K9YBE4AY] #-#
Service: OCI
Method:  GET
Path:    /20200202/managementAgents/ocid1.managementagent.....rvf6i3ba/resourcePrincipalToken
Headers:opc-rpt-request-token=********************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************         
        date=Fri, 09 Dec 2022 07:41:19 GMT         
        host=management-agent.ap-tokyo-1.oci.oraclecloud.com         
        Authorization=******************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************         
        opc-request-id=K9YBE4AYQFIMP2J6HGQ2JUKU1IJPFYVO         
        User-Agent=Jersey/2.34 (Apache HttpClient 4.5.13)Attempts:
<--> Endpoint:       management-agent.ap-tokyo-1.oci.oraclecloud.com     
     opc-request-id: K9YBE4AYQFIMP2J6HGQ2JUKU1IJPFYVO     
     StartTime:      2022-12-09 07:41:19,976 GMT     
     Status:         401 Unauthorized     
     Headers:        X-Content-Type-Options=nosniff                     
                     Content-Length=187                         
                     opc-request-id=K9YBE4AYQFIMP2J6HGQ2JUKU1IJPFYVO/E4356B68C6C541BAD867E46760316D35/4118B130EE46A8E25F90DC91AB7F12D7                     
                     Date=Fri, 09 Dec 2022 07:41:21 GMT                     
                     Content-Type=application/json     
      ErrorBody:
{  
    "code" : "NotAuthenticated",  
    "message" : "Unable to authenticate the request for ocid1.managementagent.oc1.ap-tokyo-1.amaaaa...6frjnrbvqrvf6i3ba"}

Ação

Corrija o desvio do relógio e reinicie. Se o agente estiver inativo por dias por causa desse erro, você deverá limpar o arquivo donotrestart antes de reiniciar o agente.

Além disso, a Oracle recomenda configurar a data/hora do sistema operacional para sincronização automática com servidores NTP para evitar tempo de inatividade no futuro. Se serviços adicionais estiverem em execução na máquina, é recomendável reiniciar a máquina após a alteração do horário para que os serviços possam ser redefinidos com o novo horário.

Para corrigir a data/hora do SO em que o agente está em execução e, em seguida, reiniciar o agente, você pode seguir estas etapas:

1. Para interromper o agente, execute o seguinte comando:

   sudo systemctl stop oracle-cloud-agent

2. Corrija a data e a hora.
3. Execute o comando a seguir para excluir o arquivo configure.donotrestart.

   sudo rm /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/configure.donotrestart

4. Iniciar o agente.

   sudo systemctl start oracle-cloud-agent

Solução de Problemas: Serviço OCI Management Agent: Agente Não Visível na Console do OCI em Observabilidade e Gerenciamento

O OCI Management Agent foi instalado com sucesso em uma Instância de Computação. O Agente está sendo executado no host. No entanto, o Agente não aparecerá na Console do Oracle Cloud se você acessar o menu Navegação, selecionar Observabilidade e Gerenciamento, ir para Agentes de Gerenciamento e selecionar Agentes.

Possível Causa: Os compartimentos da Instância de Computação e da Chave de Instalação do Agente são diferentes.

• Solução de Problemas: Remover Management Gateway
• Solução de Problemas: Configurar o Management Gateway
• Solução de problemas: falha na instalação do Management Gateway no Red Hat Enterprise Linux 9.x
• Solução de Problemas: Falha na Instalação do Management Gateway com Erro: Não foi possível criar certificados e o relatório de logs de Identidade: Falha na autenticação: DATE_OUTSIDE_CLOCK_SKEW
• Solução de Problemas: Ao instalar ou configurar o Management Gateway, Erro de Timeout

Solucionar Problemas: Remover Management Gateway

Causa: Em alguns casos, pode ser necessário remover uma instalação existente do Management Gateway, para reinstalá-la.

Diagnóstico e Solução de Problemas: Configurar o Management Gateway

Causa: Em alguns casos, o nome do host pode não ser resolvido no ambiente de instalação, o que pode fazer com que a instalação falhe com a seguinte mensagem de erro:

Solução de problemas: "Não foi possível resolver o nome do host <hostname value> no ambiente de instalação. Resolva o nome do host ou forneça o GatewayCertCommonName no arquivo de resposta e execute novamente o script de configuração do gateway."

Ação:

• Verifique e resolva o nome do host do ambiente para obter o valor de nome doamin totalmente qualificado (FQDN) após executar o comando: hostname -f
• Opcionalmente, um usuário pode fornecer um nome de domínio totalmente qualificado personalizado para a configuração do gateway por meio da pré-implantação da propriedade GatewayCertCommonName no arquivo de resposta de entrada. Consulte Pmatrizes do Arquivo de Resposta
• Execute novamente o script de configuração do gateway.

  sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<user_home_directory>/gateway.rsp

Causa: Em alguns casos, a instalação do Management Gateway pode falhar com a mensagem de erro a seguir devido à ausência de políticas no OCI ou por causa de problemas de limite de recursos na tenancy. Se você vir o erro a seguir, siga as etapas abaixo.

Solução de problemas: "Falha ao iniciar o Management Gateway, pois não foi possível criar, inicializar ou recuperar certificados no OCI. Verifique os logs para obter mais detalhes."

Ação:

• Abra o arquivo de log no diretório de instalação do Management Gateway, por exemplo: /opt/oracle/mgmt_agent/plugins/GatewayProxy/statedir/log/mgmt_gateway.log
• Se o arquivo de log contiver qualquer um dos 404 códigos de erro a seguir, escolha uma das seguintes opções para resolver o problema:

  2023-07-25 15:38:06.694/CEST [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility - Response String {  "code" : "NotAuthorizedOrNotFound",  "message" : "Authorization failed or requested resource not found."}
  2023-07-25 15:38:06.696/CEST [pool-3-thread-1] ERROR com.oracle.mgmtagent.proxy.ProxyServer - Error while initializing and loading certificate bundlescom.oracle.mgmtagent.proxy.exception.CertificateFailureException: The response status is 404 after multiple retries at com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility.executeRequest(CertificateUtility.java:293) ~

  • Opção recomendada: Use o Aplicativo do Marketplace de Início Rápido do Management Gateway para criar automaticamente os grupos dinâmicos, as políticas e gerenciar os certificados necessários para instalar o Management Gateway.
  • Adicione e confirme manualmente os grupos dinâmicos e as políticas corretos necessários para instalar o Management Gateway que são adicionados ao compartimento específico na tenancy em que você deseja instalar o Management Gateway. Para obter mais informações, consulte Executar Pré-requisitos para a Implantação do Management Gateway.

• Se o arquivo de log contiver qualquer um dos 400 códigos de erro a seguir, revise as seguintes opções para resolver o problema:

  2023-09-20 18:51:32.772/GMT [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateCreationUtil - Create Vault Service Url invoked https://kms.us-ashburn-1.oraclecloud.com/20180608/vaults
  2023-09-20 18:51:33.400/GMT [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility - Received response code 400
  2023-09-20 18:51:33.400/GMT [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility - Header name opc-request-id , value /5704D03441842D3818B824B2D6B2712E/1D1FED893474FDA900188E24F3DEE59B
  2023-09-20 18:51:33.401/GMT [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility - Response String {  "code" : "LimitExceeded",  "message" : "The limit for this tenancy has been exceeded."}

  • Verifique o limite do recurso Contagem de Vaults Padrão para o Serviço Key Management na console do OCI. Você pode gerar uma solicitação para aumentar os limites de recursos. Para obter mais informações, consulte Gerenciando Chaves e Gerenciando Vaults.
  • Você pode configurar certificados manualmente. Para obter detalhes, consulte Executar Pré-requisitos para a Implantação do Management Gateway e vá para a seção Gerenciamento Manual de Certificados.
    Observação
    
    Quando você cria os certificados Emitidos por CA interna, o Perfil de Certificado deve ser Servidor TLS ou Cliente TLS e apenas os algoritmos de assinatura RSA são suportados.

• Se houver outras falhas relacionadas ao Vault ou às APIs de serviço de Chave nos logs, você poderá gerar uma solicitação e entrar em contato com a equipe oci_kms fornecendo o corpo da resposta e opc-request-id.
• Se houver outras falhas relacionadas às Autoridades de Certificação ou às APIs de serviço de Certificado nos logs, gere uma solicitação e entre em contato com a equipe oci_certificates fornecendo o corpo da resposta e opc-request-id.

Diagnosticar e Solucionar Problemas: Falha na instalação do Management Gateway no Red Hat Enterprise Linux 9.x

Além disso, as mensagens de log de falha de instalação podem confirmar o erro e indicar que as tentativas de configuração usam um gerenciador de serviços incorreto para instalar o gateway.

Causa: A Red Hat removeu o pacote chkconfig na distribuição do Red Hat Enterprise Linux (RHEL) 9. Para obter mais detalhes, consulte a Base de Conhecimento da Red Hat.

Ação:

1. Instale o pacote ausente executando o seguinte comando:

   $ dnf install chkconfig

2. Verifique se o pacote existe no ambiente executando o seguinte comando:

   $ rpm -qa | grep chkconfig

3. Instale o Management Gateway novamente.

Se a instalação do pacote chkconfig não for uma opção, conforme descrito na seção Solução 1 acima, conclua as etapas a seguir como uma solução alternativa para instalar o software do Management Gateway.

$ sudo /bin/bash

$ export DIST_LINUX_FAMILY_OVERRIDE="Red Hat"

# RPM install
$ rpm -ivh <rpm_file_name.rpm>

# ZIP install
$ ./installer.sh <full_path_of_response_file>

Solução de Problemas: Falha na Instalação do Management Gateway com Erro: Não foi possível criar certificados e o relatório de logs de Identidade: Falha na autenticação: DATE_OUTSIDE_CLOCK_SKEW

Causa:

Falha na autenticação do relatório de logs de identidade: DATE_OUTSIDE_CLOCK_SKEW

# /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<PATH>/gateway_agent.rsp/opt/oracle/mgmt_agent/agent_inst/bin/setupAgent.sh
    opts=<PATH>/gateway_agent.rsp

Executing configure

Parsing input response file
Validating install key
Generating communication wallet
Generating security artifactsRegistering Management Gateway
Found service plugin(s):[GatewayProxy]

Starting gateway...
Gateway started successfully
Starting plugin deployment for: [GatewayProxy]
Deploying service plugin(s)...Done.
GatewayProxy : Successfully deployed external plugin

Gateway setup completed and the gateway is running.
In the future gateway can be started by directly running: sudo systemctl start mgmt_gateway

Please make sure that you delete <PATH>/gateway_agent.rsp or store it in secure location.

Creating gateway system properties file
Creating properties fileCreating or validating certificates
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Failed to start Management Gateway as certificates could not be created, initialized or retrieved in OCI. Please check the logs for more details.
Management Gateway stopped

Ação:

No host em que o Management Gateway está instalado, verifique se o horário do host está correto e instale o Management Gateway.

Diagnosticar e Solucionar Problemas: Ao instalar ou configurar o Management Gateway, Erro de Timeout

Se você verificar se a Console do OCI exibe o Management Gateway como ativo, mas as métricas não estão sendo preenchidas.

/opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<user_home_directory>/gateway.rsp
Starting gateway...
Gateway started successfully

Starting plugin deployment for: [GatewayProxy]
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.

Causa: Um tempo maior do que o esperado para concluir a tarefa de configuração do Management Gateway pode resultar em um problema de comunicação de rede e pode fazer com que o Management Gateway expire.