• Acesse o OCI e abra o menu de navegação na Console do OCI.

• Em Observabilidade e Gerenciamento, clique em Management Agent.

• Vá para o menu esquerdo e selecione um compartimento na lista drop-down Compartimento.

  A console de Management Agents é exibida.

1. Crie um diretório para armazenar os certificados de Autoridade de certificado raiz (CA) confiáveis adicionais no formato PEM. No exemplo a seguir, o diretório tmp é um exemplo. Você pode usar qualquer diretório e confirmar se o usuário do Agente tem acesso de leitura a todos os diretórios no caminho dos certificados.

   mkdir /tmp/crt

2. Em seguida, digite o comando a seguir para copiar todos os certificados confiáveis personalizados no formato PEM para o novo diretório criado na etapa anterior.

   cp *.pem /tmp/crt

3. Defina permissões para o diretório e seu conteúdo para permitir que o agente independente acesse os certificados.

   chmod 644 /tmp/crt

4. Para adicionar certificados confiáveis personalizados ao Management Agent durante a instalação ou configuração, especifique o diretório dos certificados no arquivo de resposta input.rsp.

   importTrustedCertsDirectory=/tmp/crt

5. Agora, você pode executar a instalação para importar os certificados para o Management Agent.
6. Após a instalação, você pode usar o comando a seguir e substituí-lo por valores para seu ambiente, a fim de verificar os certificados confiáveis importados com sucesso para a área de armazenamento de chaves do Agente. Substitua <CUSTOM_CERTIFICATE_FILE_NAME> pelo nome do arquivo de certificado personalizado em seu ambiente, por exemplo: my-cert.pem

   keytool -list -keystore /opt/oracle/mgmt_agent/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE_FILE_NAME>

   O arquivo commwallet.pem é um certificado personalizado que é adicionado ao armazenamento de certificados confiáveis do Agente.

1. Use os seguintes comandos para criar um diretório trustedcerts a fim de importar os certificados confiáveis para esse local: /var/lib/oracle-cloud-agent/plugins/oci-managementagent/. Confirme se o usuário oracle-cloud-agent é um proprietário do diretório.

   cd /var/lib/oracle-cloud-agent/plugins/oci-managementagent/
   mkdir trustedcerts
   chown oracle-cloud-agent:oracle-cloud-agent trustedcerts/

2. Copie todos os certificados confiáveis personalizados no formato PEM para o novo diretório criado na etapa anterior.

   cp *.pem /var/lib/oracle-cloud-agent/plugins/oci-managementagent/trustedcerts

3. Agora, você pode executar a instalação do Agente OCA para importar os certificados para o Agente de Gerenciamento.
4. Após a instalação, você pode usar o comando a seguir para verificar os certificados confiáveis importados com sucesso para a área de armazenamento de chaves do Agente. Substitua o <CUSTOM_CERTIFICATE> pelo nome do arquivo de certificado personalizado em seu ambiente, por exemplo: my-cert.pem

   keytool -list -keystore /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE>

   O arquivo commwallet.pem é um certificado personalizado que é adicionado ao armazenamento de certificados confiáveis do Agente.

• Implantar um Plug-in Usando a Página Agentes
• Implantar um Plug-in Durante a Instalação do Management Agent

1. No menu esquerdo, clique em Agentes para abrir a página Agentes.

2. Na lista Agentes, clique no agente desejado no qual deseja implantar o plug-in.

   A página de detalhes do Agente é exibida.

   
   
   

3. Clique em Implantar Plug-ins.

   A janela Implantar Plug-ins é exibida.

4. Selecione o plug-in e selecione Atualizar.

   Agora, o plug-in selecionado será implantado no agente desejado.

1. Siga as instruções para fazer download do software do agente e criar uma chave de instalação do agente conforme descrito em Fazer Download do Software do Agente de Gerenciamento e em Criar Chave de Instalação.

2. Faça download do arquivo de chaves de instalação do agente.

   Vá para a página Chaves de Instalação do Agente e, no menu de ação, selecione a opção Fazer Download da Chave para o Arquivo.

   A opção Fazer Download da Chave para o Arquivo permite fazer download de um modelo de arquivo de resposta. Para obter detalhes, consulte Fazer Download da Chave de Instalação.

3. Edite o modelo do arquivo de resposta usando um editor de texto e crie um arquivo de resposta personalizado.

   Siga as instruções para criar um arquivo de resposta usando a opção de download de um modelo de arquivo de resposta conforme descrito em Opção 1: Fazer download de um modelo de arquivo de resposta para criar um arquivo de resposta.

   O modelo de arquivo de resposta contém parâmetros de agente, incluindo o parâmetro de plug-in de serviço necessário para a implantação de um plug-in.

   Para implantar um plug-in de serviço como parte do processo de instalação do Management Agent, personalize o parâmetro Service.plugin.<plugin_name>.download.

   Por exemplo, se você quiser implantar o plug-in DataSafe durante a instalação do agente, o valor do parâmetro será: Service.plugin.datasafe.download=true

   Para obter mais informações sobre parâmetros do agente suportados no arquivo de resposta, consulte Revisar Parâmetros do Agente.

4. Instale o Management Agent conforme descrito em Instalar o Management Agent para concluir a instalação.

• Verificar status do plug-in de serviço
• Verificar Status da Solicitação de Serviço

• Na página da lista Agentes, clique no agente desejado.

  A página de detalhes do Agente é exibida.

• Clique em Ativar Logs do Agente.

  A janela Ativar logs: Agente do agente selecionado é exibida.

• Selecione um Compartimento do Grupo de Logs na lista drop-down.
• Selecione um Grupo de Logs na lista drop-down.

  Se quiser criar um novo grupo de Logs, clique em Criar Grupo de Logs.

  Na janela Criar Grupo de Logs, informe o Nome do Grupo de Logs e uma Descrição. Depois, clique em Criar.

• Clique em Ativar.

• Navegue até Observabilidade e Gerenciamento e vá para Log Analytics.
• Na página Log Analytics, vá para Administração.

  No menu esquerdo, selecione Origens.

  No painel central, selecione Logs do Oracle Management Agent e verifique se o agente está listado na lista Entidades Associadas.

• Clique em Desativar Logs do Agente.

  A janela de desativação de logs do agente selecionado é exibida.

• Clique em Desativar.

• O Management Agent foi implantado usando o Management Agent versão 231231.0001 ou mais recente.
• Para Prometheus Exportador, o Agente de Gerenciamento deve estar na mesma máquina virtual (VM) ou em uma VM com acesso ao ponto final do Exportador. Este Agente de Gerenciamento está configurado para extrair métricas do Exportador Prometheus em execução.

• Na página da lista Agentes, clique no agente desejado.

  A página de detalhes do Agente é exibida.

• Clique em Gerenciar Origens de Dados.

  A janela Origens de Dados exibe uma tabela com as seguintes colunas:

  • Nome: Nome da origem de dados.
  • Tipo: Tipo da origem de dados. Por exemplo: Prometheus.
  • Estado: Status da origem de dados.
  • Hora de Criação: Timestamp quando a origem de dados foi criada.
  • : Mostra mais ações disponíveis para uma origem de dados específica.
• Se você clicar em um nome de origem de dados específico, a janela Exibir Origem de Dados será exibida.

  Use Exibir Origem de Dados para exibir todas as informações sobre uma origem de dados.

  Por exemplo: Você pode exibir os dados de métrica do Prometheus Exportador.

• Use Adicionar Origem de Dados para adicionar uma origem de dados.

  • Selecione o Tipo da Origem de Dados na lista suspensa. Por exemplo: Prometheus.
  • Use Nome para inserir o novo nome de origem de dados.
  • Selecione Compartimento de métricas na lista drop-down.
  • Informe o Namespace de métricas.
  • Informe o URL que o Prometheus Exportador usa para publicar suas métricas.
  • Use as Dimensões de métrica personalizadas para adicionar uma dimensão de métrica.
  • Use Propriedades opcionais, se necessário.
• Excluir Origem de Dados: Use o menu de ação para excluir uma origem de dados.
• Editar Origem de Dados: Use o menu de ação para editar propriedades de uma origem de dados.

  Por exemplo, você pode modificar o URL do exportador Prometheus, que publica os dados de métrica no serviço OCI Monitoring.

1. Faça log-in como um usuário com permissões sudo.

2. Execute o seguinte comando:

   Para o Oracle Linux 6: sudo /sbin/initctl start mgmt_agent

   Para o Oracle Linux 7: sudo systemctl start mgmt_agent

1. Faça log-in como um usuário Administrator e abra uma janela do Prompt de Comando.

2. Execute o seguinte comando: net start mgmt_agent

1. Faça log-in como um usuário com permissões sudo para executar comandos como o usuário raiz.

2. Execute o seguinte comando:

   sudo /etc/init.d/mgmt_agent start

1. Faça log-in como um usuário com permissões sudo.

2. Execute o seguinte comando:

   Para o Oracle Linux 6: sudo /sbin/initctl stop mgmt_agent

   Para o Oracle Linux 7: sudo systemctl stop mgmt_agent

1. Faça log-in como um usuário Administrador e abra uma janela de Prompt de Comando.

2. Execute o seguinte comando: net stop mgmt_agent

1. Faça log-in como um usuário que tem o privilégio sudo para executar comandos como usuário raiz.

2. Execute o seguinte comando:

   sudo /etc/init.d/mgmt_agent stop

1. Faça log-in como um usuário Administrador e abra uma janela de Prompt de Comando.

2. Execute o seguinte comando: sc query mgmt_agent

   Para obter mais detalhes, verifique o arquivo de log: C:\Oracle\mgmt_agent\agent_inst\log\mgmt_agent.log.

1. Faça log-in como um usuário que tem o privilégio sudo para executar comandos como usuário raiz.

2. Execute o seguinte comando: sudo /etc/init.d/mgmt_agent status

   Para obter mais detalhes, verifique o arquivo de log: /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log.

• Upgrade Automático
• Upgrade Manual

• Um agente implantado no host de destino não é mais necessário.
• Não é mais necessário coletar dados, métricas de desempenho ou logs de um host de destino específico.
• Você modificou a topologia de implantação.

• Remover Agentes da Interface do Usuário

• Remover Agentes da Interface de Linha de Comando

1. Selecione o agente na lista Agentes e clique no Menu Ação.

   Figura 4-1 Excluir Agente

   

2. Clique em Excluir Agente.

3. Pressione Excluir para confirmar a seleção.

• Linux usando o comando RPM
• Linux usando script desinstalador
• Janelas
• Solaris
• AIX

sudo rpm -e <rpm_name>

$ sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_agent...
Removing mgmt_agent daemon from systemd...
Removed symlink/etc/systemd/system/multi-user.target.wants/mgmt_agent.service.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

C:\Oracle>mgmt_agent\uninstaller.bat
Removing agent from Management Agent Cloud Service
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Removing agent service from the host
Agent service was removed from the host successfully
Removing agent directories

sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_agent...
Removing mgmt_agent daemon from systemd...
Removed symlink /etc/systemd/system/multi-user.target.wants/mgmt_agent.service.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

sudo sh /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected AIX:
Stopping mgmt_agent...
Waiting for mgmt_agent to exit...
Stopped mgmt_agent.
Removing mgmt_agent daemon...
0513-083 Subsystem has been Deleted.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

• Opção 1. No Serviço Management Agent, a Oracle recomenda que você use a Console do Oracle Cloud ou a API para adicionar credenciais nomeadas.
• Opção 2. Você pode configurar credenciais de origem nos arquivos de configuração do agente para permitir que ele colete dados de diferentes origens.

• Oracle Cloud Console
• API de Credenciais Nomeadas do Management Agent

• Confirme se a versão do Management Agent: 250704.1404 ou mais recente está instalada.
• Configure o seguinte para seu usuário:
  • Adicione as permissões necessárias para credenciais nomeadas. Consulte Cenários do Usuário e Detalhes para a Referência de Política do Serviço Management Agent.
  • Adicione a política a seguir para credenciais nomeadas. Consulte a Tabela 2-1 do Serviço Management Agent.

    ALLOW GROUP <group-name> TO MANAGE management-agent-named-credentials IN <compartment_name>

  • Crie um segredo em um vault. Para fazer isso, você precisa de uma permissão adicional para criar um segredo, consulte Criando um Segredo em um Vault e Detalhes para o Vault, o Key Management e os Segredos. O vault e o segredo podem estar em compartimentos diferentes. E o vault e o segredo podem estar em um compartimento diferente do agente.
  • Configure as permissões a seguir para que você possa ler o pacote de segredos. Consulte Detalhes do Vault, do Gerenciamento de Chaves e dos Segredos.
    • Para listar as permissões VAULT_INSPECT e VAULT_READ do vault.
    • Para listar segredos das permissões SECRET_INSPECT e SECRET_READ.
• Configure as permissões e políticas para o recurso do agente para fazer isso:

  • Crie um grupo dinâmico para o recurso do agente usando o exemplo abaixo. Substitua o ocid1.compartment.oc1.agentcompartmentid pelo OCID do compartimento do seu agente. Consulte Como criar um grupo dinâmico na Console e Gerenciando Grupos Dinâmicos.

    ALL {resource.type='managementagent', resource.compartment.id='ocid1.compartment.oc1.agentcompartmentid'}

  • Adicione a política a seguir para permitir que o grupo dinâmico leia o segredo em um compartimento específico, substitua o ocid1.compartment.oc1.secretcompartmentid pelo OCID do compartimento do segredo. Consulte Atualizando a Instrução de uma Política.

    allow dynamic-group X to read secret-bundles in compartment ocid1.compartment.oc1.secretcompartmentid

  • O agente também deve ter permissões e políticas para quaisquer recursos do OCI usados na criação de credenciais nomeadas. Por exemplo, se o agente usar credenciais com nome para interagir com um banco de dados autônomo, você precisará criar uma política para permitir que o grupo dinâmico do agente leia a wallet do banco de dados autônomo. Por exemplo:

    allow dynamic-group X to read autonomous-databases in compartment DB_COMPARTMENT

• Um usuário operador com a permissão MGMT_AGENT_NAMED_CREDENTIAL_APPLY e, em seguida, os agentes aos quais o usuário tem acesso podem usar credenciais nomeadas para executar ações sem ter acesso a senhas. Um usuário com essa permissão não poderá exibir o vault ou os OCIDs secretos contidos na credencial nomeada.
• Um usuário administrador, com as permissões a seguir, pode executar as operações CRUD padrão em credenciais nomeadas e não terá acesso para ler o pacote de segredos do vault.

  • MGMT_AGENT_NAMED_CREDENTIAL_CREATE

  • MGMT_AGENT_NAMED_CREDENTIAL_UPDATE

  • MGMT_AGENT_NAMED_CREDENTIAL_DELETE

• Se um usuário tiver a permissão MGMT_AGENT_DELETE, ele poderá excluir o recurso do agente e todas as credenciais nomeadas associadas também serão excluídas.
  Observação
  
  A exclusão de um agente ou de uma credencial com nome não afeta o segredo armazenado no vault do OCI.

1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Management Agent, selecione Agentes.
2. Selecione o compartimento que contém os agentes que você deseja listar. Selecione a opção para incluir subcompartimentos para obter uma visão geral dos detalhes do agente no compartimento selecionado, incluindo os compartimentos filhos.
3. No menu Ações, selecione Gerenciar Credenciais Nomeadas.
   • Ou você pode ir para a página Detalhes do Agente, selecionar a opção Mais ações e, em seguida, selecionar Gerenciar Credenciais Nomeadas.
4. Informe o Nome da Credencial. Opcionalmente, você pode informar uma descrição.
5. Selecione o tipo de credencial que você deseja adicionar na lista drop-down Tipo de Credencial.
6. Para cada campo ou atributo do tipo de credencial selecionado, informe um valor ou selecione um identificador de recurso ou selecione um vault e um identificador de segredo.

   Se o recurso existir em outro compartimento, você poderá selecionar Alterar Compartimento para alterar o compartimento e localizar o valor do recurso.

7. Para adicionar tags, selecione Mostrar Opções Avançadas.
   • Para adicionar tags, selecione um Namespace de tag, digite uma Chave de tag e um Valor de tag e selecione Adicionar tag. Você pode restringir o acesso às credenciais adicionando tags. Se você tiver as permissões necessárias para criar uma credencial com nome, também terá as permissões para adicionar tags de formato livre. Para adicionar uma tag definida, você também deve ter as permissões para o namespace da tag. Para obter mais informações, consulte Visão Geral do Serviço Tagging e para saber como adicionar uma tag ao criar um recurso, consulte Como Trabalhar com Tags de Recursos.
   • Para excluir uma tag, selecione o X.
8. Selecione Salvar para adicionar a credencial nomeada ao agente. Se você não puder salvar as credenciais nomeadas, confirme se você inseriu todos os campos obrigatórios.

   Quando as credenciais nomeadas são salvas, uma solicitação de serviço é enviada ao agente. Após a conclusão da solicitação de serviço, o agente pode usar essa credencial nomeada para executar várias tarefas em vários plug-ins ou serviços implantados no agente.

   Observação
   
   Se a solicitação de serviço falhar, confirme se o agente tem a permissão SECRET_READ para acessar os segredos do vault e executar a operação GetSecret. Consulte Detalhes do Vault, do Serviço Key Management e dos Segredos.

   Para editar ou excluir credenciais nomeadas de um agente:

   1. Localize o agente que deseja atualizar. Para isso, você pode:
      • Vá para a página de lista Agentes. Ao lado do agente que deseja atualizar, selecione o menu Ações e, em seguida, selecione Gerenciar Credenciais Nomeadas.
      • Ou você pode ir para a página Detalhes do Agente, selecionar a opção Mais ações e, em seguida, selecionar Gerenciar Credenciais Nomeadas.
   2. Selecione Editar ou Excluir. Você pode editar os detalhes do vault do nome de usuário e da senha. Não é possível editar o nome ou o tipo da credencial.
      Observação
      
      Se você excluir uma credencial com nome que esteja em uso ativamente, o monitoramento da origem no agente poderá ser interrompido.

• Tipos de Credencial de Origem
• Adicionar ou Atualizar Credenciais
• Excluir Credenciais
• Adicionar ou Atualizar o Alias da Credencial
• Excluir Alias da Credencial

• Abra o menu de navegação. Em Governança e Administração, vá para Governança e clique em Auditoria.

  O serviço Audit é exibido.

• Fazer Upgrade do JRE no Linux
  • Fazer Upgrade do JRE Usando o Pacote RPM
  • Fazer Upgrade do JRE Usando o Arquivo Compactado
• Fazer Upgrade do JRE no Windows
• Atualizar a JAVA_HOME Personalizada