Documentação do Oracle Cloud Infrastructure

Instalar Management Agents

Depois de concluir os pré-requisitos, conforme descrito em Executar Pré-requisitos para Implantação de Management Agents, siga estas etapas para instalar os Management Agents.

Assista aos vídeos a seguir para ver como instalar o Management Agent para estes exemplos específicos:

Para obter mais detalhes, incluindo como instalar o Management Agent em todos os sistemas operacionais e várias maneiras de fazer download do Management Agent, você pode seguir as instruções abaixo.

Faça download do Software do Management Agent

Você pode fazer download do software Management Agent usando qualquer uma das seguintes opções:

Opção 1: Fazer Download do Software do Management Agent usando a Console do Oracle Cloud

Na Console do Oracle Cloud, você pode executar as seguintes etapas para fazer download do software Management Agent:

  1. Na Console do Oracle Cloud, clique no menu de navegação, vá para Observabilidade e Gerenciamento e, em Management Agents, selecione Downloads e Chaves.
  2. As opções de Download de Software, selecione o sistema operacional.
  3. No painel Download de Software, selecione o sistema operacional no qual o Management Agent será instalado na coluna Download.
  4. Clique no link específico do sistema operacional para fazer download do arquivo de software do agente.
    Ambientes Exadata: Para instalar o Management Agent no Exadata e no Exadata Cloud, incluindo o Cloud@Customer e no Oracle Cloud Infrastructure, você só deve seguir as instruções para Instalar o Management Agent em um Volume Externo usando o Arquivo ZIP do Linux.
    Observação

    O tipo de pacote RPM para Linux não é suportado no Exadata.

    Por exemplo, clique em Agente para WINDOWS (X86_64) para Windows.

O arquivo de software agora é salvo no host.

Depois de fazer download do arquivo, você pode verificar a integridade do arquivo verificando o valor da coluna SHA-256 Checksum. Por exemplo, se você estiver usando o Linux, ele deverá corresponder à saída do seguinte comando: sha256sum <download_file>

Opção 2: Fazer Download do Software do Management Agent usando a CLI

Você pode usar a interface de linha de comando (CLI) do OCI (Oracle Cloud Infrastructure) para fazer download do software Management Agent concluindo as etapas a seguir. A Interface de Linha de Comando (CLI) do Oracle Cloud Infrastructure (OCI) é uma ferramenta de interface de linha de comando. Para obter mais informações, consulte Interface de Linha de Comando (CLI).
  1. Obtenha o valor object-url usando o comando da CLI agent-image list. 
    oci management-agent agent-image list --compartment-id <tenancyId>

    O valor object-url de retorno é semelhante ao seguinte:

    https://objectstorage.<region_identifier>.oraclecloud.com/n/<namespace>/b/<bucketName>/o/Linux-x86_64/latest/oracle.mgmt_agent.rpm

    Anote os valores <namespace> e <bucketName> acima.

  2. Faça download do software do Management Agent com o principal autenticado do OCI usando os valores <namespace> e <bucketName> da Etapa 1:
    • Para Linux: 
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Linux-x86_64/latest/oracle.mgmt_agent.rpm --file oracle.mgmt_agent.rpm
    • Para Windows Server: 
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Windows-x86_64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
    • Para o Solaris: 
      oci os object get --namespace <namespace> --bucket-name <bucketName> --name Solaris-Sparc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
    • Para o AIX:
      oci os object get --namespace <namespace> --bucket-name  <bucketName> --name AIX-ppc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
    • Para o Linux ARM:
      oci os object get --namespace <namespace> --bucket-name  <bucketName> --name Linux-Aarch64/latest/oracle.mgmt_agent.rpm  --file oracle.mgmt_agent.rpm

    • Para a área de trabalho macOS e Windows: o Management Agent é suportado ao usar o serviço Java Management. Para obter detalhes, consulte Serviço Java Management, especificamente a seção Instalando um Management Agent.

    3 Depois de fazer download do arquivo, você pode verificar a integridade do arquivo verificando o valor da coluna SHA-256 Checksum. Por exemplo, se você estiver usando o Linux, ele deverá corresponder à saída do seguinte comando: sha256sum <download_file>

Opção 3: Fazer Download do Software do Management Agent usando a API REST

Para fazer download do software do Management Agent, você pode:

  1. Use a API REST ListManagamentAgentImages com autenticação OCI válida para obter detalhes. Consulte a documentação da API REST ListManagementAgentImages.
  2. Obtenha o valor de object-url na saída e use esse URL para fazer download do Software do Management Agent. Para obter detalhes, consulte a operação GetObject na documentação da API do Object Storage Service.

Criar Chave de Instalação

Você precisa criar uma chave de instalação antes de instalar o Management Agent.

Uma chave de instalação é emitida para o domínio de identidades e valida a autenticidade da instalação. Certifique-se de criar a chave de instalação antes de iniciar a instalação do Management Agent.

Para criar uma chave de instalação:

  1. Na home page Management Agent, clique em Download e Chaves no menu esquerdo para exibir o painel Chaves de Instalação.

    O painel Chaves de Instalação é exibido na parte inferior da página.

  2. No painel Chaves de Instalação, clique em Criar Chave para criar uma chave.

  3. Informe os detalhes necessários na janela Criar Chave.

    1. No campo Nome da Chave, especifique um nome para identificar a chave.

    2. No campo Compartimento, selecione o compartimento na lista drop-down. Este é o compartimento no qual o recurso do agente será criado.

    3. No campo Máximo de Instalações, especifique um número que indique o número máximo de instalações que podem ser associadas à chave. O valor padrão é 1000.

    4. No campo Válido para, especifique um número que indique o período para o qual a chave é válida. O valor padrão é 1 semana.

    5. A caixa de seleção Ilimitado é opcional.

      Se ela for selecionada, a chave poderá ser usada para um número ilimitado de instalações de agente e gateway e a chave nunca expirará.

      Riscos do uso de chaves ilimitadas: A Oracle recomenda manter o tempo de vida útil de uma Chave de Instalação até um tempo mínimo necessário e número limitado de agentes. Certifique-se de manter a chave baixada em um local seguro para proteger a confidencialidade. Se a chave de instalação ilimitada for comprometida, um invasor poderá instalar agentes invasores em sua tenancy. Uma auditoria regular dos agentes da sua tenancy pode ajudar a mitigar quaisquer riscos potenciais associados a chaves de instalação ilimitadas. Quando uma chave de instalação ilimitada não for mais necessária, certifique-se de excluí-la usando a Console ou a CLI do Management Agents.

    Caixa de diálogo Criar Chave.

    Uma nova chave é criada.

O painel Chaves de Instalação oferece diferentes opções disponíveis para gerenciar as chaves. Durante uma etapa posterior, a opção Download de Chave para Arquivo é útil para fazer download de um arquivo que pode ser usado como um modelo de arquivo de resposta, conforme descrito em Configurar um Arquivo de Resposta.

Para obter mais informações sobre o gerenciamento de chaves de instalação, consulte Gerenciar Chaves de Instalação.

Observação

Se você estiver instalando um Management Gateway, poderá usar a mesma chave de instalação para instalar o Management Gateway e o Management Agent. Para obter informações sobre o Management Gateway, consulte Management Gateway.

Configurar um Arquivo de Resposta

O script de instalação do Management Agent usa um arquivo de resposta para ler os parâmetros do agente específicos do seu ambiente.

Revisar Parâmetros do Agente

É necessário um arquivo de resposta contendo os parâmetros do agente ao executar o script de configuração do agente.

A seção a seguir descreve os parâmetros suportados no arquivo de resposta:

Tabela 3-1 Parâmetros do Arquivo de Resposta

Nome do Parâmetro Tipo de Parâmetro Descrição
ManagementAgentInstallKey Obrigatório Chave de instalação necessária para validar a identidade do domínio e a autenticidade da instalação.
CredentialWalletPassword Opcional Senha da wallet do agente quando o usuário fornece uma senha personalizada para a wallet armazenar informações confidenciais.
O tamanho mínimo da senha é de 8 caracteres com as seguintes especificações:
  • Pelo menos um caractere minúsculo (a-z)
  • Pelo menos um caractere maiúsculo (A-Z)
  • Pelo menos um dígito (0-9)
  • Pelo menos um caractere especial da seguinte lista: '!', '@', '#', '%', '^', '&', '*'

Todos os caracteres da senha devem estar entre os caracteres definidos acima. Por exemplo, se a senha contiver o caractere $, ela falhará na verificação de validade, pois $ não está entre os caracteres especiais listados acima.

GatewayServerHost Opcional Nome do host ou endereço do servidor proxy ou do servidor do Management Gateway.

Se fornecido, GatewayServerPort também deve ser fornecido.

Se o Management Gateway estiver configurado no modo de alta disponibilidade, você deverá especificar o nome do host do balanceador de carga como o valor GatewayServerHost. Para obter informações, consulte Configurar Alta Disponibilidade para o Management Gateway.

GatewayServerPort Opcional Número da porta do servidor proxy ou do servidor do Management Gateway.

Se fornecido, GatewayServerHost também deve ser fornecido.

Se o Management Gateway estiver configurado no modo de alta disponibilidade, você deverá especificar o número da porta do balanceador de carga como o valor GatewayServerPort. Para obter informações, consulte Configurar Alta Disponibilidade para o Management Gateway.

GatewayServerUser Opcional Nome de usuário, se o servidor do Gateway de Gerenciamento ou o servidor proxy exigir autenticação.

Se fornecido, GatewayServerPassword também deve ser fornecido.

GatewayServerPassword Opcional Senha, se o servidor do Gateway de Gerenciamento ou o servidor proxy exigir autenticação.

Se fornecido, GatewayServerUser também deve ser fornecido.

GatewayServerRealm Opcional O realm de autenticação do servidor proxy.

Se estiver usando o Management Gateway, esse valor não será necessário.
AgentDisplayName Opcional O nome para exibição do seu agente. Se for deixado vazio, o valor padrão será definido como "Agent (host-name)".
Service.plugin.<plugin_name>.download=true Opcional O nome do plug-in que você deseja implantar durante a instalação do agente. <plugin_name> é um plug-in compatível com o serviço Management Agent.

Por exemplo, se você quiser implantar o plug-in DataSafe durante a instalação do agente, ele será: Service.plugin.datasafe.download=true
FreeFormTags = [{"<key1>":"<value1>"}, {"<key2>":"<value2>"}] Opcional A associação de metadados de tag se estiver usando tags no OCI.

Ela consiste em uma chave e um valor. A chave é qualquer nome que você use para fazer referência à tag. Valor é o valor que o usuário que aplica a tag adiciona à chave da tag.

Para o Agente Associado, se esse Agente de Gerenciamento estiver configurado para estabelecer conexão por meio de um Gateway de Gerenciamento, adicione uma tag com o nome "GatewayGroup".

Por exemplo: "GatewayGroup":"<User_Defined_ClusterName>
DefinedTags = [{"namespace1":{"<key1>":"<value1>"}}, {"namespace2":{"<key2>":"<value2>"}}] Opcional A associação de metadados de tag se estiver usando tags no OCI. O administrador de tags cria e gerencia todas as tags que os usuários aplicam aos recursos. Os usuários devem ter políticas de tag definidas.

O namespace de tag é um contêiner para suas chaves de tag. A chave de tag é uma chave dentro do seu namespace; você deve criar chaves de tag para tags definidas em um namespace.

Para tags definidas, o valor da tag tem um tipo que pode ser uma string ou uma lista de strings. Ao definir o tipo de valor da tag, se o tipo definido for uma string, qualquer valor poderá ser informado. Ao passo que, se for uma lista de strings, esse valor deverá ser uma das strings dessa lista.

No exemplo a seguir, há 2 namespaces admin_namespace e finance_namespace. Cada namespace usa 2 chaves e 2 valores environment_type=non-prod, sensitivity=restricted. Para definir as tags, você pode usar: 

DefinedTags = [{"admin_namespace": {"environment_type": "non-prod",
    "sensitivity": "restricted"}, "finance_namespace": {"environment_type":
    "non-prod","sensitivity": "restricted"}}]
GatewayServerRootCACertOcid Opcional Este parâmetro está disponível a partir do Agente versão 221019.0021.

Quando o Agente se conectar a um Gateway de Gerenciamento da versão 221019.0021.1667404647 ou superior, a conexão será criptografada.

Este parâmetro especifica o OCID do Certificado de Autoridade de Certificação Raiz a ser usado. O Agente e o Gateway devem estar no mesmo compartimento.

importTrustedCertsDirectory Opcional

Localização dos certificados de CA raiz adicionais no formato PEM.

Use esse parâmetro se quiser adicionar outros certificados de CA Raiz no formato PEM. O Agente de Gerenciamento pesquisou nesse local e adicionou os certificados durante a instalação.

Por exemplo: importTrustedCertsDirectory=/tmp/crt
maxHeapInMb Opcional Quantidade de heap máximo em megabytes.

O valor padrão do heap é 512 Mb. Use esse parâmetro para ajustar o agente para usar mais heap se souber o tempo de instalação anterior em que o agente será configurado com uma carga grande, como logs e bancos de dados.

Por exemplo: maxHeapInMb=1024
BufferingEnabled Opcional Permite o buffer de vários pontos finais por meio do Management Gateway, como os serviços Log Analytics e Object Storage OCI.

Criar um Arquivo de Resposta

Antes de continuar, certifique-se de ter verificado e entendido as informações fornecidas em Revisar Parâmetros do Agente.

Para instalar e configurar agentes, crie um arquivo de resposta e execute um script usando o arquivo de resposta recém-criado que apontará o agente para a região do OCI correta e permitirá que um recurso seja criado para o agente.

Observação

Ao criar um arquivo de resposta, verifique a localização e as permissões do arquivo. Certifique-se de que o arquivo de resposta tenha permissões de leitura para o usuário do SO mgmt_agent.

Para criar um arquivo de resposta, use uma das seguintes opções:

Opção 1: Fazer download de um modelo de arquivo de resposta para criar um arquivo de resposta

Você pode fazer download de um arquivo de modelo contendo os parâmetros do agente que podem ser salvos e usados como um arquivo de resposta durante a instalação do agente.

Para fazer download de um modelo de arquivo de resposta, use a opção de menu Fazer Download da Chave para o Arquivo na lista Chaves de Instalação do Agente.

  • Clique em Download e Chaves no menu esquerdo para abrir o painel Chaves de Instalação do Agente. Na lista de chaves de instalação do agente, selecione a chave que deseja submeter a download.

  • No lado direito da chave selecionada, clique no menu de ação Menu Ação e selecione Fazer Download da Chave para o Arquivo.

    Um arquivo é submetido a download. Para obter mais informações, consulte Fazer Download da Chave de Instalação.

Ao fazer download da chave de instalação do agente para um arquivo, o arquivo submetido a download contém os parâmetros do agente, incluindo o valor da chave de instalação do agente específico.

Depois de fazer download do arquivo, você precisa personalizá-lo de acordo com o seu ambiente:
  • Abra o arquivo usando um editor de texto, revise-o e edite os parâmetros obrigatórios do agente. Consulte Revisar Parâmetros do Agente.
  • Comente (adicione o símbolo # no início da linha) ou remova os parâmetros do agente que você não precisa para sua configuração específica do agente.
  • Remova o comentário (remova o símbolo # do início da linha) dos parâmetros do agente necessários para a configuração específica do agente e atualize o valor do parâmetro do agente, se preciso.
  • Salvar o arquivo de resposta atualizado. Por exemplo, ele pode ser salvo como arquivo de resposta input.rsp.

Opção 2: Criar um arquivo de resposta usando um editor de texto

É possível criar um arquivo de resposta manualmente usando um editor de texto. Por exemplo, você pode criar um arquivo usando o editor de texto de sua preferência, adicionar os parâmetros de agente necessários para a configuração do agente ao arquivo de resposta e salvá-lo. Por exemplo, o arquivo de resposta pode ser salvo como input.rsp.

Amostra do arquivo de resposta input.rsp:
managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5
CredentialWalletPassword = Abcdefgh1#

Depois de criar o arquivo de resposta usando qualquer uma das opções acima, verifique as permissões do arquivo e certifique-se de que ele tenha permissões de leitura para o usuário mgmt_agent (usuário do SO criado durante o processo de instalação do Management Agent).

Instalar o Management Agent

Depois de fazer download do software do agente, criar uma chave de instalação e um arquivo de resposta, você poderá prosseguir com a instalação do agente de gerenciamento para coletar dados das origens que deseja gerenciar e monitorar do Oracle Cloud Infrastructure.

Observação

  • Exadata: Para instalar o Management Agent no Exadata e no Exadata Cloud, faça download e instale o Management Agent usando o método de instalação de arquivo ZIP para evitar problemas com operações de gerenciamento do ciclo de vida do Exadata. Não use a instalação do RPM em nenhuma implantação do Exadata, incluindo no local, Cloud@Customer e Oracle Cloud Infrastructure. Para implantações do Exadata Cloud no Cloud@Customer e no Oracle Cloud Infrastructure, certifique-se de que o agente de gerenciamento esteja instalado no sistema de arquivos /u02.

    Para obter instruções de instalação, consulte Instalar o Management Agent em um Volume Externo usando o Arquivo ZIP do Linux.

    Para obter mais detalhes e considerações importantes ao instalar o Management Agent no Exadata Cloud, consulte OCI: Observability & Management Support For Exadata Cloud ID do Documento 3015115.1 no My Oracle Support.

  • Implantação em Massa: A implantação em massa do Management Agent é suportada. Para obter informações, consulte o tutorial Oracle Management Agent Bulk Deployment Using Ansible Playbooks.

  • Você pode instalar o Management Agent em várias máquinas virtuais. Para obter detalhes, consulte o vídeo OCI Management Agent: How to install management agent across multiple virtual machines.

Instalar o Agente de Gerenciamento no Linux (arquivo RPM)

Observação

Exadata: Não use a instalação do RPM em nenhuma implantação do Exadata, incluindo no local, Cloud@Customer e Oracle Cloud Infrastructure. Para obter instruções de instalação, consulte Instalar o Management Agent em um Volume Externo usando o Arquivo ZIP do Linux.

Para instalar o software do agente de gerenciamento no Linux usando um arquivo RPM, execute as seguintes etapas:
  1. Faça log-in como um usuário com privilégios sudo. Se quiser alterar o usuário padrão, você poderá ver Usar um Usuário do Sistema Operacional Não Padrão para Instalar o Management Gateway para obter mais informações.
  2. Instale o software do agente.
    Navegue até o diretório em que você fez download do arquivo RPM do software do agente de gerenciamento e execute o seguinte comando para instalar o arquivo RPM: 
    sudo rpm -ivh <rpm_file_name.rpm>

    Por exemplo: sudo rpm -ivh oracle.mgmt_agent-<VERSION>.rpm

    A saída será semelhante à seguinte: 
    Preparing... ################################# [100%]
Checking pre-requisites

      Checking if any previous agent service exists
      Checking if OS has systemd or initd
      Checking available disk space for agent install
      Checking if /opt/oracle/mgmt_agent directory exists
      Checking if 'mgmt_agent' user exists
      'mgmt_agent' user already exists, the agent will proceed installation without creating a new one.
      Checking Java version
      JAVA_HOME is not set. Trying default path
      Java version: 1.8.0_281 found at /usr/bin/java

Updating / installing...
      1:oracle.mgmt_agent-<VERSION>################################# [100%]
Executing install
      Unpacking software zip
      Copying files to destination dir (/opt/oracle/mgmt_agent)
      Initializing software from template
      Creating 'mgmt_agent' daemon
      Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer-log-0
      Setup agent using input response file (run as any user with 'sudo' privileges)
      Usage:sudo
      /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=[RESPONSE_FILE]
Agent install successful
    O processo de instalação do agente faz o seguinte:
    • Um novo usuário chamado mgmt_agent é criado. Este será o usuário do agente de gerenciamento. Se o usuário mgmt_agent já existir, o processo de instalação do agente o usará para instalar o software do agente.
    • Quando o daemon mgmt_agent é criado, o ulimit de hard e soft nofile é definido como 5000.
    • Todos os arquivos do agente são copiados e instalados pelo usuário mgmt_agent. O diretório base de instalação do agente é o diretório em que o agente está instalado. O diretório é criado como parte do processo de instalação do agente no diretório /opt/oracle/mgmt_agent.
    • Por padrão, o serviço mgmt_agent é ativado e iniciado automaticamente após a instalação do agente.
    Os arquivos de log da instalação do agente estão localizados no diretório /opt/oracle/mgmt_agent/installer-logs. Para exibir os arquivos de log ou quaisquer outros arquivos de instalação do agente, faça log-in como usuário mgmt_agent executando o seguinte:
    sudo -u mgmt_agent sh
  3. Configure o agente de gerenciamento executando o script setup.sh usando um arquivo de resposta. 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<full_path_of_response_file>
    A saída será semelhante à seguinte: 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<response_file_directory>/input.rsp
Executing configure
      Generating communication wallet
      Parsing input response file
      Validating install key
      Generating security artifacts
      Registering management agent
      Configuration Logs: /opt/oracle/mgmt_agent/configure-logs

Agent configuration successful

Starting agent...
Agent started successfully
In future agent can be started by directly running: sudo systemctl start mgmt_agent
Please make sure that you delete input.rsp or store it in a secure location.

Para obter mais informações sobre como criar arquivos de resposta, consulte Criar um Arquivo de Resposta.

Instalar o Management Agent no Linux (arquivo ZIP)

Observação

Exadata: Para instalar o Management Agent no Exadata e no Exadata Cloud, faça download e instale o Management Agent usando o método de instalação de arquivo ZIP para evitar problemas com operações de gerenciamento do ciclo de vida do Exadata. Não use a instalação do RPM em nenhuma implantação do Exadata, incluindo no local, Cloud@Customer e Oracle Cloud Infrastructure. Para implantações do Exadata Cloud no Cloud@Customer e no Oracle Cloud Infrastructure, certifique-se de que o agente de gerenciamento esteja instalado no sistema de arquivos /u02.

Para obter instruções de instalação, consulte Instalar o Management Agent em um Volume Externo usando o Arquivo ZIP do Linux.

Para obter mais detalhes e considerações importantes ao instalar o Management Agent no Exadata Cloud, consulte OCI: Observability & Management Support For Exadata Cloud ID do Documento 3015115.1 no My Oracle Support.

Para instalar o software do agente de gerenciamento no Linux usando um arquivo ZIP, execute as seguintes etapas:
Observação

O local de instalação padrão está no volume /opt. Se você preferir usar um volume externo para instalar o Management Agent, consulte Instalar o Management Agent em um Volume Externo usando o Arquivo ZIP do Linux.

  1. Extraia o software do agente de gerenciamento.

    Navegue até o diretório em que você fez download do arquivo ZIP do software do agente de gerenciamento e descompacte-o em qualquer local de sua preferência.

  2. Faça log-in como um usuário com privilégios sudo.

  3. Instale e configure o agente de gerenciamento executando o script installer.sh fornecendo um arquivo de resposta. Para obter informações sobre como criar um arquivo de resposta, consulte Criar um Arquivo de Resposta.

    Navegue até o diretório em que você descompactou o arquivo ZIP do software do agente de gerenciamento e execute o seguinte:
    sudo ./installer.sh <full_path_of_response_file>

    Por exemplo: sudo ./installer.sh /tmp/input.rsp

    A saída será semelhante à seguinte: 
    sudo ./installer.sh <user_home_directory>/input.rsp 
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        JAVA_HOME is not set or not readable to root
        Trying default path /usr/bin/java
        Java version: 1.8.0_282 found at /usr/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Creating 'mgmt_agent'daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
    O processo de instalação do agente faz o seguinte:
    • Um novo usuário chamado mgmt_agent é criado. Este será o usuário do agente de gerenciamento. Se o usuário mgmt_agent já existir, o processo de instalação do agente o usará para instalar o software do agente.
    • Quando o daemon mgmt_agent é criado, o ulimit de hard e soft nofile é definido como 5000.
    • Todos os arquivos de instalação do agente pertencem ao usuário mgmt_agent. O diretório base de instalação do agente é o diretório em que o agente está instalado. O diretório é criado como parte do processo de instalação do agente no diretório /opt/oracle/mgmt_agent.
    • Por padrão, o serviço mgmt_agent é ativado e iniciado automaticamente após a instalação do agente.

    Os arquivos de log da instalação do agente estão localizados no diretório /opt/oracle/mgmt_agent/installer-logs.

    Os arquivos de log do agente em execução estão localizados em /opt/oracle/mgmt_agent/agent_inst/log.

    Para exibir os arquivos de log ou quaisquer outros arquivos de instalação do agente, faça log-in como usuário mgmt_agent executando o seguinte:
    sudo -u mgmt_agent sh
Instalar o Management Agent em um Volume Externo usando o Arquivo ZIP do Linux
Observação

Exadata: Para instalar o Management Agent no Exadata e no Exadata Cloud, faça download e instale o Management Agent usando o método de instalação de arquivo ZIP para evitar problemas com operações de gerenciamento do ciclo de vida do Exadata. Não use a instalação do RPM em nenhuma implantação do Exadata, incluindo no local, Cloud@Customer e Oracle Cloud Infrastructure. Para implantações do Exadata Cloud no Cloud@Customer e no Oracle Cloud Infrastructure, certifique-se de que o agente de gerenciamento esteja instalado no sistema de arquivos /u02.

Para obter mais detalhes e considerações importantes ao instalar o Management Agent no Exadata Cloud, consulte OCI: Observability & Management Support For Exadata Cloud ID do Documento 3015115.1 no My Oracle Support.

Em alguns ambientes Linux, o volume /opt tem espaço em disco limitado e não pode ser usado para instalar software. Nesses casos, você pode instalar o Management Agent em um volume externo usando o arquivo ZIP do Linux e criando um link simbólico.

Para instalar o Management Agent em um volume externo no Linux, faça o seguinte:

  1. Crie o diretório de instalação do Management Agent em um volume externo.
    Por exemplo: 
    sudo mkdir -p /devext/oracle/mgmt_agent

    No exemplo acima, /devext é um volume externo.

  2. Crie um link simbólico no diretório /opt/oracle para apontar para o volume externo.

    Antes de executar o comando abaixo, confirme se o diretório /opt/oracle já existe.

    Por exemplo:
    sudo ln -s /devext/oracle/mgmt_agent /opt/oracle/mgmt_agent
  3. Confirme se o arquivo ZIP do Linux do software Management Agent foi baixado. Para obter detalhes, consulte Fazer Download do Software do Management Agent.
  4. Alterne para um shell raiz, defina a variável de ambiente OPT_ORACLE_SYMLINK = true e instale o software Management Agent como usuário raiz.
    sudo /bin/bash
export OPT_ORACLE_SYMLINK=true
./installer.sh <full_path_of_response_file>
    Por exemplo:
    sudo /bin/bash
export OPT_ORACLE_SYMLINK=true
./installer.sh ./input.rsp
  5. Depois que o processo de instalação for concluído, verifique se o usuário do Linux mgmt_agent é o proprietário do local de instalação do Management Agent.
    stat -c '%U' /opt/oracle/mgmt_agent
mgmt_agent

sudo stat -c '%U' /opt/oracle/mgmt_agent/agent_inst
mgmt_agent

Instalar o Management Agent no Mac

A instalação do Management Agent em um Mac é suportada ao usar o serviço Java Management. Para obter detalhes, consulte Serviço Java Management, especificamente a seção Instalando um Management Agent.

Instalar o Management Agent no Windows Server

Para instalar o software do agente de gerenciamento no Windows Server, execute as seguintes etapas:

  1. Extraia o software do agente de gerenciamento.

    Navegue até o diretório em que você fez download do arquivo ZIP do software do agente de gerenciamento e descompacte-o em qualquer local de sua preferência.

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

  3. Instale e configure o agente de gerenciamento executando o script install.bat usando um arquivo de resposta. 
    installer.bat <full_path_of_response_file>
    A saída será semelhante à seguinte: 
    installer.bat C:\<user_home_directory>\input.rsp
Checking pre-requisites

        Checking if previous agent service exists
        Checking if C:\Oracle\mgmt_agent\agent_inst directory exists
        Checking if C:\Oracle\mgmt_agent\200820.0751 directory exists
        Checking available disk space for agent install
        Checking Java version
                Java version: 1.8.0_281 found at C:\Program Files\Java\jdk1.8.0_281
 
Executing install
        Unpacking software zip
        Copying files to destination dir (C:\Oracle\mgmt_agent)
        Initializing software from template
        Creating mgmt_agent service 

Agent install successful 

Executing configure

        Parsing input response file
        Generating communication wallet
        Validating install key
        Generating security artifacts
        Registering Management Agent

The mgmt_agent service is starting....
The mgmt_agent service was started successfully.


Agent setup completed and the agent is running
In the future agent can be started by directly running: NET START mgmt_agent
Please make sure that you delete C:\<user_home_directory>\input.rsp or store it in secure location.

Para obter mais informações sobre como criar arquivos de resposta, consulte Criar um Arquivo de Resposta.

O processo de instalação do agente faz o seguinte:
  • Um novo diretório é criado como parte do processo de instalação do agente: C:\Oracle\mgmt_agent.
  • O diretório base de instalação do agente é o diretório em que o agente será instalado. Por padrão, o agente é instalado no diretório C:\Oracle. Esse diretório padrão pode ser alterado definindo a variável de ambiente AGENT_INSTALL_BASEDIR antes de executar o script install.bat.

  • Os arquivos de log da instalação do agente estão localizados no diretório C:\Oracle\mgmt_agent\installer-logs.

Instalar o Management Agent na Área de Trabalho do Windows

A instalação do Agente de Gerenciamento em uma Área de Trabalho do Windows é suportada ao usar o serviço Java Management. Para obter detalhes, consulte Serviço Java Management, especificamente a seção Instalando um Management Agent.

Instalar o Management Agent no Solaris

Para instalar o software do agente de gerenciamento no Solaris, execute as seguintes etapas:

  1. Extraia o software do agente de gerenciamento.

    Navegue até o diretório em que você fez download do arquivo ZIP do software do agente de gerenciamento e descompacte-o em qualquer local preferencial.

  2. Se o caminho para sudo não estiver definido no seu PATH, defina a variável de ambiente SUDO_PATH com o caminho para sudo. Você pode usar a opção sudo -E para reter variáveis do ambiente durante a execução do comando como sudo.

    Confirme que useradd e groupadd estão na variável de ambiente PATH. Por exemplo, se estiver no local /sbin/useradd, confirme se está no seu caminho.

    Confirme se o sudo está na variável de ambiente PATH. Por exemplo, se sudo estiver no local /usr/bin/sudo, confirme que a variável do ambiente PATH inclui o local "/usr/bin".

  3. Faça log-in como um usuário com privilégios sudo.

  4. Instale e configure o agente de gerenciamento executando o script installer.sh usando um arquivo de resposta.

    Para obter informações sobre como criar arquivos de resposta, consulte Criar um Arquivo de Resposta.

    Navegue até o diretório em que você descompactou o arquivo ZIP do software do agente de gerenciamento e execute o seguinte:
    sudo ./installer.sh <full_path_of_response_file>
    A saída será semelhante à seguinte: 
    sudo ./installer.sh <user_home_directory>/input.rsp 
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        JAVA_HOME is not set or not readable to root
        Trying default path /usr/bin/java
        Java version: 1.8.0_282 found at /usr/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Creating 'mgmt_agent'daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent 

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

    O processo de instalação do agente faz o seguinte:
    • Um novo usuário chamado mgmt_agent é criado. Este será o usuário do agente de gerenciamento. Se o usuário mgmt_agent já existir, o processo de instalação do agente o usará para instalar o software do agente.
    • Quando o daemon mgmt_agent é criado, o ulimit de arquivos hard e soft nofile é definido como 5000.
    • Todos os arquivos de instalação do agente pertencem ao usuário mgmt_agent. O diretório base de instalação do agente é o diretório em que o agente está instalado. O diretório é criado como parte do processo de instalação do agente no diretório /opt/oracle/mgmt_agent.
    • Por padrão, o serviço mgmt_agent é ativado e iniciado automaticamente após a instalação do agente.

    Os arquivos de log da instalação do agente estão localizados no diretório /opt/oracle/mgmt_agent/installer-logs.

    Os arquivos de log do agente em execução estão localizados em /opt/oracle/mgmt_agent/agent_inst/log.

    Para exibir os arquivos de log ou quaisquer outros arquivos de instalação do agente, faça log-in como usuário mgmt_agent executando o seguinte:
    sudo -u mgmt_agent sh

Instalar o Management Agent no AIX

Para instalar o software do agente de gerenciamento no AIX, execute as seguintes etapas:
Observação

sudo, unzip e OpenJDK 8 para AIX são necessários antes de continuar com a instalação do Management Agent.

  1. Extraia o arquivo ZIP do software do agente de gerenciamento.

    Navegue até o diretório em que você fez download do arquivo ZIP do software do agente de gerenciamento e descompacte-o em qualquer local de sua preferência.

    O utilitário unzip é necessário para a instalação. Para obter informações sobre unzip para AIX, consulte AIX Toolbox for Open Source Software.

  2. Efetue log-in como um usuário com privilégios sudo.

  3. Instale e configure o agente de gerenciamento executando o script installer.sh que fornece um arquivo de resposta.

    Para obter informações sobre como criar um arquivo de resposta, consulte Criar um Arquivo de Resposta.

    Navegue até o diretório em que você descompactou o arquivo ZIP do software do agente de gerenciamento e execute o seguinte: 

    sudo sh installer.sh <full_path_of_response_file>

    Por exemplo: sudo sh installer.sh /usr/input.rsp

    A saída será semelhante à seguinte: 
    Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        Trying /tmp/java/jdk8u372-b07
        Java version: 1.8.0_372 found at /tmp/java/jdk8u372-b07/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Checking if JavaScript engine is available to use       
    Creating mgmt_agent daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
0513-059 The mgmt_agent Subsystem has been started. Subsystem PID is 16122232.
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo startsrc -s mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
    O processo de instalação do agente faz o seguinte:
    • Um novo usuário chamado mgmt_agent é criado. Este será o usuário do agente de gerenciamento. Se o usuário mgmt_agent já existir, o processo de instalação do agente o usará para instalar o software do agente.
    • Quando o daemon mgmt_agent é criado, o ulimit de hard e soft nofile é definido como 5000.
    • Todos os arquivos de instalação do agente pertencem ao usuário mgmt_agent. O diretório base de instalação do agente é o diretório em que o agente está instalado. O diretório é criado como parte do processo de instalação do agente no diretório /opt/oracle/mgmt_agent.
    • Por padrão, o serviço mgmt_agent é ativado e iniciado automaticamente após a instalação do agente.

    Os arquivos de log da instalação do agente estão localizados no diretório /opt/oracle/mgmt_agent/installer-logs.

    Os arquivos de log do agente em execução estão localizados em /opt/oracle/mgmt_agent/agent_inst/log.

    Para exibir os arquivos de log ou quaisquer outros arquivos de instalação do agente, faça log-in como usuário mgmt_agent executando o seguinte:
    sudo -u mgmt_agent sh

Instalar Vários Agentes de Gerenciamento

O Agente de Gerenciamento suporta a instalação de várias instâncias do Agente de Gerenciamento na mesma máquina para replicar dados coletados pelo agente entre regiões. Cada Agente de Gerenciamento é instalado apontando para uma região do OCI diferente enquanto coleta das mesmas origens.
Observação

O recurso Instalar vários agentes de gerenciamento está disponível no momento apenas no Linux.

Identificadores de Serviço do Agente

Os identificadores de serviço do agente são usados para identificar um serviço do agente na presença de outras instâncias do agente em uma determinada máquina para evitar confusão. Cada serviço do agente de gerenciamento pode ser instalado com um identificador específico que é usado para localizar e gerenciar essa instância específica do agente.

Se a instalação de um agente de gerenciamento começar sem fornecer um identificador de serviço, uma instalação padrão será presumida.

Todos os identificadores de serviço devem começar com mgmt_agent- seguido por uma string que consiste apenas em valores alfanuméricos, hífen ou sublinhado como os únicos caracteres permitidos. Por exemplo: 
mgmt_agent-oc1_phx-abc123

Para instalar o agente de gerenciamento com um identificador de serviço, execute as seguintes etapas:

  1. Extraia o software do agente de gerenciamento.

    Navegue até o diretório em que você fez download do arquivo ZIP do software do agente de gerenciamento e descompacte-o em qualquer local de sua preferência.

  2. Faça log-in como um usuário com privilégios sudo.

  3. Instale e configure o agente de gerenciamento executando o script installer.sh usando um arquivo de resposta.

    Para obter informações sobre como criar arquivos de resposta, consulte Criar um Arquivo de Resposta.

    Navegue até o diretório em que você descompactou o arquivo ZIP do software do agente de gerenciamento e execute o seguinte:
    sudo ./installer.sh <full_path_of_response_file> <service identifier>
    Por exemplo: 
    sudo ./installer.sh /tmp/input.rsp mgmt_agent-oc1_phx-abc123
    A saída será semelhante à seguinte: 
    sudo ./installer.sh <user_home_directory>/input.rsp mgmt_agent-oc1_phx-abc123
Checking pre-requisites
	Checking if any previous agent service exists
	Checking if OS has systemd or initd
	Checking available disk space for agent install
	Checking if /opt/oracle/mgmt_agent-oc1_phx-abc123 directory exists
	Checking if 'mgmt_agent' user exists
	Checking Java version
		JAVA_HOME is not set or not readable to root
		Trying default path /usr/bin/java
		Java version: 1.8.0_282 found at /usr/bin/java
	Checking agent version

Executing install
	Unpacking software zip
	Copying files to destination dir (/opt/oracle/mgmt_agent-oc1_phx-abc123)
	Initializing software from template
	Checking if JavaScript engine is available to use
	Creating mgmt_agent-oc1_phx-abc123 daemon
	Agent Install Logs: /opt/oracle/mgmt_agent-oc1_phx-abc123/installer-logs/installer.log.0

Agent install successful

Executing configure

	Parsing input response file
	Validating install key
	Generating communication wallet
	Generating security artifacts
	Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent-oc1_phx-abc123

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
O processo de instalação do agente faz o seguinte:
  • Um novo usuário chamado mgmt_agent é criado. Este será o usuário do agente de gerenciamento. Se o usuário mgmt_agent já existir, o processo de instalação do agente o usará para instalar o software do agente.
  • Um daemon usando o identificador de serviço como o nome é criado.
  • Ulimit de nofile duro e macio são definidos como 5000.
  • Todos os arquivos de instalação do agente pertencem ao usuário mgmt_agent. O diretório base de instalação do agente é o diretório em que o agente está instalado. O diretório é criado como parte do processo de instalação do agente no diretório /opt/oracle/<service-identifier> .
  • Por padrão, o serviço de daemon <service-identifier> é ativado e iniciado automaticamente após a instalação do agente.
  • Toda interação com o serviço daemon do agente, como iniciar ou interromper um agente, pode ser feita usando <service-identifier>. Por exemplo: 
    sudo systemctl start <service-identifier>
sudo systemctl stop <service-identifier>

Os arquivos de log da instalação do agente estão localizados no diretório /opt/oracle/<service-identifier>/installer-logs.

Os arquivos de log do agente em execução estão localizados em /opt/oracle/<service-identifier>/agent_inst/log.

Para exibir os arquivos de log ou quaisquer outros arquivos de instalação do agente, faça log-in como usuário mgmt_agent executando o seguinte:
sudo -u mgmt_agent sh

Verificar a Instalação do Management Agent

Verificar a Instalação do Agente Usando a Interface do Usuário

Para verificar a instalação do agente usando a interface do usuário, execute as seguintes etapas:

  1. Na página principal Management Agents, clique em Agentes no menu esquerdo.

    A página Agentes é exibida com uma lista de todos os agentes e gateway instalados.

    Para ver somente os agentes, você pode usar a seção Filters no menu esquerdo:

    Vá para Filters, use a lista drop-down Install Type e selecione Agent.

    Todos os agentes são exibidos.

    Página Lista de agentes que mostra todos os agentes de gerenciamento instalados.

  2. Na lista Agentes, procure o agente que foi instalado recentemente usando a coluna Criado em, que exibe a data da instalação do agente ou a coluna Host, que exibe o nome do host em que o agente foi instalado.

Verificar a Instalação do Agente Usando a Interface de Linha de Comando

Verificar a Instalação do Agente Usando a Interface de Linha de Comando no Linux

  1. Faça log-in no host usando um usuário com privilégios sudo.

  2. Execute o seguinte comando:

    Para o Oracle Linux 6:
    sudo /sbin/initctl status mgmt_agent
    Para o Oracle Linux 7: 
    sudo systemctl status mgmt_agent

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

Verificar a Instalação do Agente Usando a Interface de Linha de Comando no Windows

  1. Faça log-in no host usando um shell de comando da conta Administrator.

  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.

Verificar a Instalação do Agente Usando a Interface de Linha de Comando no Solaris

  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.

Diagnosticar e Solucionar Problemas de Instalação do Management Agent