Executar Tarefas de Pós-Instalação do Management Gateway

Configurar Management Agents com o Management Gateway

Após instalar o Management Gateway, você precisa configurar cada Management Agent para usar o Management Gateway recém-instalado, em vez de usar o proxy corporativo.

O Management Gateway será configurado para conexão com a internet por meio de firewalls.

No lado do Agente de Gerenciamento, os mesmos parâmetros são usados para configurar o acesso por meio de um Gateway de Gerenciamento como por meio de um proxy regular.

Após a conclusão da instalação do Management Gateway, configure os Management Agents.

Existem dois cenários:

Configure um novo Management Agent para usar o Management Gateway.

Nesse cenário, você está configurando um novo Management Agent para usar o Management Gateway recém-instalado.
O Management Agent deve ser configurado para apontar para o Management Gateway definindo os seguintes parâmetros durante a instalação do agente:
- GatewayServerHost
- GatewayServerPort
- GatewayServerUser
- GatewayServerPassword
Para obter detalhes sobre como configurar os parâmetros acima e o arquivo de resposta durante o processo de instalação do Management Agent, consulte Configurar um Arquivo de Resposta.
Para obter informações sobre como instalar Agentes de Gerenciamento, consulte Instalar Agentes de Gerenciamento.
Configure um Management Agent existente para usar o Management Gateway.

Nesse cenário, você está configurando um Management Agent existente para usar o Management Gateway recém-instalado.

A configuração do Management Agent existente deve ser atualizada e definida para apontar para o Management Gateway:
1. Certifique-se de que o agente de gerenciamento esteja em execução.
2. Se o Management Gateway estiver configurado para exigir autenticação, crie um arquivo de credenciais contendo o nome de usuário e a senha necessários para estabelecer conexão com o Management Gateway.
  Por exemplo, um arquivo /opc/my_cred_file.json pode ser criado contendo as credenciais a serem configuradas.
```
{
  "source":"agent.<OCID_OF_THE_AGENT>",  <---Prefix the OCID of the agent with "agent."
  "name":"ManagementAgent-Gateway",
  "type":"ProxyCreds",
  "description":"These credentials are used to connect to Management Gateway.",
  "tags":["GatewayServerHost:gatewayhost.myco.com","GatewayServerPort:3128"],
  "properties":
  [
    { "name":"ProxyUser", "value":"<USER_NAME>" },
    { "name":"ProxyPassword", "value":"<USER_PASSWORD>" }
  ]
}
```
3. Adicione as credenciais especificadas no arquivo /opc/my_cred_file.json usando o script credential_mgmt.sh.
```
cat /opc/my_cred_file.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s Agent
```
4. Exclua o arquivo de credencial /opc/my_cred_file.json.
5. Interrompa o agente de gerenciamento.
6. Atualize o arquivo emd.properties do agente de gerenciamento adicionando os parâmetros GatewayServerHost e GatewayServerPort.
  O arquivo emd.properties está localizado no diretório /opt/oracle/mgmt_agent/agent_inst/config.
  
  Por exemplo:
```
GatewayServerHost=proxyhost.example.com
GatewayServerPort=3128
```
7. Inicie o agente de gerenciamento.
Para obter detalhes sobre os parâmetros do Management Agent, consulte Revisar Parâmetros do Agente.

Adicionar ou Atualizar Informações do Proxy para o Management Gateway

Você pode adicionar ou atualizar as informações do proxy, como host do proxy, porta e/ou credenciais após instalar o Management Gateway.

Observação

Durante a instalação do Management Gateway, o Management Gateway pode ser configurado para rotear por meio de um servidor proxy fornecendo as informações do proxy (host, porta e credenciais) usando um arquivo de resposta. Se você estiver instalando o Management Gateway, consulte Configurar um Arquivo de Resposta para o Management Gateway para obter detalhes.

Esta seção fornece informações sobre como adicionar as informações do proxy após o Management Gateway já ter sido instalado.

Estes são alguns cenários comuns:

Durante o processo de instalação do Management Gateway, as informações do proxy não foram fornecidas. Pode ser que você tenha esquecido de adicioná-lo ao arquivo de resposta ou que as informações de proxy não estavam disponíveis no momento.
O Management Gateway deve ser roteado por meio de um proxy ou firewall após sua instalação.
Há alterações no servidor proxy. Por exemplo, as informações do servidor proxy foram fornecidas durante a instalação, mas depois, precisam ser alteradas para outro servidor proxy. (Pode ser que o usuário queira que o Management Gateway seja roteado por outro).

Pré-requisitos: O Management Gateway deve ter sido instalado sem fornecer as informações do proxy ou instalado com um proxy que agora precisa ser alterado.

Etapa 1: Adicione ou atualize as informações do proxy no arquivo emd.properties

Edite o arquivo /opt/oracle/mgmt_agent/agent_inst/config/emd.properties e adicione as propriedades abaixo no final do arquivo:

ProxyHost=<Nome do host do servidor proxy ou endereço do servidor proxy ou firewall>

ProxyPort=<Número da porta do servidor proxy do servidor proxy ou firewall>

Por exemplo:

ProxyHost=myproxy.example.com
ProxyPort=80

Se o Management Gateway já tiver sido configurado com um servidor proxy e se o usuário precisar alterá-lo para outro servidor proxy, as propriedades: ProxyHost e ProxyPort já deverão estar presentes no arquivo emd.properties. Atualize as propriedades acima para usar os novos valores do servidor proxy.

Etapa 2 (Opcional): Atualizar credenciais de proxy no Management Gateway

Se o servidor proxy tiver credenciais, você precisará atualizá-las. Para obter instruções, consulte Atualizar Credenciais de Proxy para o Management Gateway.

Etapa 3: Reiniciar o Management Gateway

Para Linux, use

sudo systemctl restart mgmt_gateway

Para Windows, use

net stop mgmt_gateway
net start mgmt_gateway

Documentação do Oracle Cloud Infrastructure