Executar Tarefas Genéricas de Pré-Requisitos

Para configurar o Oracle Management Cloud para monitorar seu ambiente Oracle E-Business Suite, você precisa executar um conjunto de tarefas genéricas.

Ativar a Licença do Enterprise Edition

As ofertas do Oracle Management Cloud são categorizadas e disponibilizadas em diferentes edições de licença, incluindo o Enterprise Edition.

O Oracle Management Cloud – Enterprise Edition oferece o seguinte:

Oracle Application Performance Monitoring: Fornece uma plataforma para monitorar e gerenciar aplicativos.
Oracle Infrastructure Monitoring: monitora o status e a integridade da infraestrutura de tecnologia de informações inteira de uma única plataforma e alerta os administradores sobre problemas.
Orquestração do Oracle: Automatiza a nuvem e a infraestrutura local e executa tarefas chamando APIs REST ou usando estruturas de automação de terceiros.
Oracle IT Analytics: fornece uma visão do 360-degree sobre o desempenho, a disponibilidade e a capacidade de aplicativos e investimentos em infraestrutura.

Ative o Oracle Management Cloud - Enterprise Edition para o sistema Oracle Cloud Infrastructure do host e para o Oracle E-Business Suite.

Faça log-in no console do Oracle Management Cloud como um Administrador do Oracle Management Cloud.
Se o painel de navegação do Management Cloud não for exibido, clique no ícone Navegação OMC no canto superior esquerdo.
No painel de navegação da console do Oracle Management Cloud, clique em Administração e, em seguida, clique em Configuração da Entidade.
Clique em Licenciamento e, em seguida, clique em Selecionar Entidades .
Localize e selecione as entidades necessárias e clique no botão Selecionar .
Selecione Enterprise Edition para cada entidade listada ou clique em Edição da Licença e selecione Definir Tudo para Empresa .
Clique em Salvar.

Instalar os Agentes do Oracle Management Cloud

Instale agentes do Oracle Management Cloud que recuperam métricas de monitoramento.

Agente do gateway: Instale o agente de gateway em um host que tenha acesso à Internet ao Oracle Management Cloud e pode ser acessado por todos os hosts nos quais os agentes de nuvem são implantados. Todos os agentes do Oracle Management Cloud devem usar um gateway comum.
Agentes do Cloud: Instale agentes na nuvem em cada host na topologia do Oracle E-Business Suite para monitorar e coletar dados (por exemplo, métricas, informações de configuração e logs) de entidades que residem nesses hosts.

Antes de Instalar os Agentes

Antes de instalar agentes no Oracle E-Business Suite, certifique-se de solucionar as seguintes considerações.

Para o Diretório Base do Agente onde você instala um agente:

Certifique-se de que somente o usuário do root e o usuário do agent installation têm permissão de gravação no Diretório de Base do Agente e seu diretório pai, mesmo após a instalação do agente. Isso garante que todas as operações do ciclo de vida do agente, como atualização ou exclusão sejam concluídas com sucesso.
Se o Diretório Base do Agente for criado antes da instalação, certifique-se de que o diretório está vazio. O usuário de instalação do agente deve ter acesso de gravação ao diretório.
Se o Diretório Base do Agente não for criado antes da instalação, ele será criado por default no diretório em que o arquivo zip do software do agente foi extraído. Certifique-se de que o usuário da instalação do agente tem acesso de gravação ao diretório pai onde o Diretório Base do Agente foi criado.

Criar ou Fazer Download de uma Chave de Registro

Uma chave de registro é emitida para seu domínio de identidades e é usada na implantação de agentes de nuvem. Depois que um agente é instalado com a chave de registro, você pode remover a chave do Oracle Management Cloud.

Ao criar uma chave de registro, você especifica uma contagem de uso para a chave. Uma chave expira quando a contagem de uso é maior ou igual ao uso máximo especificado quando a chave foi criada.

Faça log-in no console do Oracle Management Cloud como um Administrador do Oracle Management Cloud.
Se o painel de navegação do Management Cloud não for exibido, clique no ícone Navegação OMC no canto superior esquerdo.
No painel de navegação da console do Oracle Management Cloud, clique em Administração e, em seguida, clique em Agentes .
Clique no menu à direita e selecione Gerenciar Chaves de Registro.
Crie uma nova chave de registro informando os detalhes necessários na página Chaves de Registro e, em seguida, clicando em Criar Nova Chave .
Para fazer download de uma chave de registro existente, execute as seguintes etapas:
1. Na lista de chaves de registro, localize a chave que você deseja fazer download.
2. Clique no menu de ações no lado direito da página e, em seguida, selecione Fazer Download.
  Um arquivo de texto registrationKey.txt que contém o valor da chave de registro é submetido a download para sua unidade local. Para exibir o valor da chave, abra o arquivo registrationKey.txt.

Você adicionará o valor da chave no parâmetro AGENT_REGISTRATION_KEY no arquivo de resposta.

Faça download do Agente de Gateway

Use o console do Oracle Management Cloud para fazer download dos arquivos ZIP do pacote de instalação do software do agente de gateway para seu host.

Quando você extrai o arquivo ZIP do gateway, um arquivo de resposta de amostra, gateway.rsp, é fornecido como um modelo.

Faça log-in no console do Oracle Management Cloud como um Administrador do Oracle Management Cloud.
Se o painel de navegação do Management Cloud não for exibido, clique no ícone Navegação OMC no canto superior esquerdo.
No painel de navegação da console do Oracle Management Cloud, clique em Administração e, em seguida, clique em Agentes .
Clique no menu à direita e selecione Fazer Download de Agentes .
Clique em Tipo de Agente e selecione Gateway .
Clique em Sistema Operacional e, em seguida, selecione o sistema operacional em que deseja instalar o agente.
Anote os valores dos parâmetros TENANT_NAME e OMC_URL exibidos no link do agente. Ao instalar o agente de gateway, você precisará atualizar o arquivo de resposta com esses valores.
Clique no link do software do agente para que seu sistema operacional faça download do arquivo ZIP do software de gateway.
Verifique se o arquivo ZIP transferido por download foi concluído comparando o valor de checksum do SHA1 do arquivo submetido a download com o listado para o agente na página de download do agente:
```
sha1sum <agent_binary_filename>.zip
```
O valor da coluna Checksum de SHA1 na interface do usuário deve corresponder à saída.
Navegue até o diretório em que você fez download do pacote de software e descompacte-o.
```
unzip <agent_binary_filename>.zip
```

Faça download do Cloud Agent

Use a console do Oracle Management Cloud para fazer download dos arquivos ZIP do pacote de instalação do software do agente na nuvem para seu host.

Quando você extrai o arquivo ZIP do agente, um arquivo de resposta de amostra, agent.rsp, é fornecido como um modelo.

Faça log-in no console do Oracle Management Cloud como um Administrador do Oracle Management Cloud.
Se o painel de navegação do Management Cloud não for exibido, clique no ícone Navegação OMC no canto superior esquerdo.
No painel de navegação da console do Oracle Management Cloud, clique em Administração e, em seguida, clique em Agentes .
Clique no menu à direita e selecione Fazer Download de Agentes .
Clique em Tipo de Agente e selecione Agente em Nuvem.
Clique em Sistema Operacional e, em seguida, selecione o sistema operacional em que deseja instalar o agente.
Anote os valores dos parâmetros TENANT_NAME e OMC_URL exibidos no link do agente. Ao instalar o agente de gateway, você precisará atualizar o arquivo de resposta com esses valores.
Clique no link do software do agente para que seu sistema operacional faça download do arquivo ZIP do software de gateway.
Verifique se o arquivo ZIP transferido por download foi concluído comparando o valor de checksum do SHA1 do arquivo submetido a download com o listado para o agente na página de download do agente:
```
sha1sum <agent_binary_filename>.zip
```
O valor da coluna Checksum de SHA1 na interface do usuário deve corresponder à saída.
Navegue até o diretório em que você fez download do pacote de software e descompacte-o.
```
unzip <agent_binary_filename>.zip
```

Instalar o Agente do Gateway

Um agente de gateway atua como um canal protegido entre o Oracle Management Cloud e todos os outros agentes Oracle Management Cloud.

Para instalar um agente de gateway:

Edite o arquivo de resposta do gateway, gateway.rsp (que você obteve quando fez download e extraiu o arquivo ZIP do gateway), em um editor de texto e forneça valores para os parâmetros necessários para instalar um gateway.

A tabela a seguir lista os parâmetros necessários para a instalação do gateway.

Parâmetro	Descrição
`TENANT_NAME` ou `TENANT_ID` (suportado em versões mais antigas e permanece retrocompatível)	Nome do tenant onde o Oracle Management Cloud está sendo executado. Você pode obter o valor `TENANT_NAME` de um agente navegando para Administração > Agentes > Download e selecionando um tipo de agente na lista drop-down Tipo de Agente . O valor `TENANT_NAME` é exibido na parte inferior da página.
`OMC_URL` ou `UPLOAD_ROOT` (suportado em versões mais antigas e permanece retrocompatível)	O URL absoluto, incluindo o protocolo necessário para estabelecer conexão com o Oracle Management Cloud para fazer upload de dados para o `TENANT_NAME` específico. Para obter esse valor, navegue até Administração > Agentes > Download e selecione um tipo de agente na lista drop-down Tipo de Agente . O valor `OMC_URL` é exibido na parte inferior da página.
`AGENT_REGISTRATION_KEY`	Chave para validar a identidade do tenant e a autenticidade da instalação. Você pode obter a chave de registro no Painel de Controle do Oracle Management Cloud, navegando para Administração > Agentes > Chaves de Registro.
`AGENT_BASE_DIRECTORY`	Diretório vazio no qual o agente deve ser instalado na máquina host. Se o diretório especificado não estiver presente, um diretório será criado durante a instalação. Observação: no Windows, o tamanho do caminho do diretório incluindo a letra de unidade deve ser menor que 23 caracteres.

Salve o arquivo de resposta.
Execute uma verificação de pré-requisito para validar os parâmetros. Use a interface da linha de comando para executar o script AgentInstall.sh especificando o parâmetro EXECUTE_PREREQ=true.
```
$ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed for [Gateway]. 
```
O script executa a verificação de pré-requisitos. Se a verificação de pré-requisitos falhar, o script será interrompido com a mensagem de erro relevante.

Consulte o arquivo de log localizado em <AGENT_ZIP_FILE_EXTRACTED_DIRECTORY>/AgentInstall_<timestamp>.log para obter mais detalhes. Corrija os erros antes de instalar o gateway.
Instale o agente executando o script AgentInstall.sh com o nome do arquivo de resposta como um parâmetro.
./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the gateway.rsp file>

Instalar o Agente em Nuvem

Um agente em nuvem coleta os dados da entidade do host onde você implanta o agente em nuvem.

A instalação do agente da nuvem requer nomes de domínio totalmente qualificados (FQDN) para seus hosts. Para ambientes UNIX, adicione o FQDN no arquivo /etc/hosts e certifique-se de que ele mapeie para o nome de host e o endereço IP corretos do host.

Observação: Instale o agente de nuvem em cada um dos hosts da camada de aplicativos e dos hosts do banco de dados.

Para instalar um agente de nuvem:

Edite o arquivo de resposta do agente de nuvem, agent.rsp (que você obteve quando fez download e extraiu o arquivo ZIP do agente de nuvem), em um editor de texto e forneça valores para os parâmetros necessários para instalar um agente de nuvem.

A tabela a seguir lista os parâmetros exigidos sobre e acima dos parâmetros de instalação de gateway listados anteriormente para uma instalação do agente de nuvem que usa um gateway para comunicar-se com o Oracle Management Cloud por meio de um servidor proxy.

Parâmetro	Descrição
`GATEWAY_HOST`	Se o agente de nuvem estiver se comunicando com o Oracle Management Cloud usando um gateway, forneça o FQDN (Nome do Domínio Totalmente Qualificado) do gateway. Ao instalar o agente de nuvem, certifique-se de fornecer o mesmo nome de host de gateway que foi usado para instalar o gateway. Por exemplo, ao implantar o gateway, se você especificar `ORACLE_HOSTANME=abc.xyz.com` e ao instalar o agente de nuvem, você especifica `GATEWAY_HOST=abc`, isso resultará em falhas de registro do agente de nuvem. Um agente de gateway deve ser instalado no host e estar ativo e em execução.
`GATEWAY_PORT`	Quando um agente de nuvem usa um gateway para se comunicar com o Oracle Management Cloud, você deve especificar a porta do gateway. Você pode obter o número da porta executando o seguinte comando: `$Gateway_Agent_Home/agent_inst/bin/omcli status agent`
`OMC_PROXYHOST`	Endereço do seu servidor proxy a ser usado para conexão. Certifique-se de não informar o valor `https://` com os detalhes do host proxy.
`OMC_PROXYPORT`	A porta do seu servidor proxy.
`OMC_PROXYUSER`	Nome do usuário necessário para acessar seu servidor proxy.
`OMC_PROXYPWD`	Senha necessária para acessar seu servidor proxy.
`OMC_PROXYREALM`	Realm de autenticação (se houver) a ser usado para acessar seu servidor proxy.
`AGENT_PORT`	O número da porta à qual o processo do agente será vinculado. O script `AgentInstall` interrompe o processo de instalação se esta porta estiver ocupada no momento da instalação.

Salve o arquivo de resposta.
Execute uma verificação de pré-requisito para validar os parâmetros. Use a interface da linha de comando para executar o script AgentInstall.sh especificando o parâmetro EXECUTE_PREREQ=true.
```
$ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed. 
```
O script executa a verificação de pré-requisitos. Se a verificação de pré-requisitos falhar, o script será interrompido com a mensagem de erro relevante.
Instale o agente executando o script AgentInstall.sh com o nome do arquivo de resposta como um parâmetro.
./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the agent.rsp file>

Verificar Instalação do Agente

Após instalar o gateway e o agente de nuvem, verifique se os agentes foram implantados com sucesso.

Faça log-in no console do Oracle Management Cloud como um Administrador do Oracle Management Cloud.
Se o painel de navegação do Management Cloud não for exibido, clique no ícone Navegação OMC no canto superior esquerdo.
No painel de navegação da console do Oracle Management Cloud, clique em Administração e, em seguida, clique em Agentes .
Clique na guia do tipo de agente, como Gateways ou Agentes de Nuvem.
Verifique se o nome do host do seu gateway ou agente de nuvem implantado existe na lista de agentes disponíveis.