Instalar agente do Oracle EM 12c no Windows manualmente

This post is also available in: English

Nesse tutorial irei explicar como aplicar o agente do Oracle Enterprise Manager Cloud 12 no Windows. O método via o website do Cloud Control nem sempre é intuitivo e aconselhável, já que é preciso ter um SSH para Windows rodando no seu servidor.

1) Verificando se o agente existe no OMS.

Para começar, abra o seu Cloud Control e vá em "Setup -> Extensibility -> Self Update". Abra a pasta "Agent Software" e verifique se o Agent Software do Windows x64 está com o status "Applied", como na imagem abaixo:

Se o agente ainda não estiver, você precisará fazer o download dele, o deploy e depois ativá-lo.

2) Fazer download do instalador do Agent

Com o seu agente ativado, vamos agora fazer download dele no seu servidor OMS. Acesse o seu OMS Server e baixe o pacote para posteriormente instalarmos ele manualmente no Windows.

Primeiro, faça login com o emcli:

[oracle@ec12mntrjr001 ~]$ emcli login -username=sysman
Enter password :

Login successful
[oracle@ec12mntrjr001 ~]$

Vamos verificar se o agente está realmente disponível (já fizemos esta verificação pela etapa 1):

[oracle@ec12mntrjr001 ~]$ emcli get_supported_platforms
Getting list of platforms ...
Check the logs at /opt/app/oracle/em12cR2/Middleware/gc_inst/em/EMGC_OMS1/sysman/emcli/setup/.emcli/agent.log
About to access self-update code path to retrieve the platforms list..
Getting Platforms list  ...
-----------------------------------------------
Version = 12.1.0.2.0
 Platform = Linux x86-64
-----------------------------------------------
Version = 12.1.0.1.0
 Platform = Linux x86-64
-----------------------------------------------
Version = 12.1.0.1.0
 Platform = Oracle Solaris on SPARC (64-bit)
-----------------------------------------------
Version = 12.1.0.1.0
 Platform = Oracle Solaris on x86-64 (64-bit)
-----------------------------------------------
Version = 12.1.0.1.0
 Platform = Microsoft Windows x64 (64-bit)
-----------------------------------------------
Version = 12.1.0.1.0
 Platform = HP-UX Itanium
-----------------------------------------------
Platforms list displayed successfully.
[oracle@ec12mntrjr001 ~]$

Ótimo, vamos então baixar o instalador para a pasta local. Essa pasta precisa estar vazia. Da versão 12.1.0.3 em diante, serão gerados 2 arquivos, um para o agent e outra para o plugin:

[oracle@ec12mntrjr001 ~]$ emcli get_agentimage -destination=/home/oracle -platform="Microsoft Windows x64 (64-bit)" -version="12.1.0.1.0"
Platform:Microsoft Windows x64 (64-bit)
Destination:/home/oracle
 === Partition Detail ===
Space free : 13 GB
Space required : 1 GB
Check the logs at /opt/app/oracle/em12cR2/Middleware/gc_inst/em/EMGC_OMS1/sysman/emcli/setup/.emcli/get_agentimage_2013-11-08_16-04-37-PM.log
Setting property ORACLE_HOME to:/opt/app/oracle/em12cR2/Middleware/oms
calling pulloneoffs with arguments:/opt/app/oracle/em12cR2/Middleware/oms/opt/software/72/C1D0CDE7DD23F299E040DD0AEF3F63BD12.1.0.1.0windows_x64
Check this logs for more information: /opt/app/oracle/em12cR2/Middleware/oms/sysman/prov/agentpush/logs
[oracle@ec12mntrjr001 ~]$ ls -la
total 472424
drwx------ 10 oracle oinstall      4096 Nov  8 16:04 .
drwxr-xr-x  3 root   root          4096 May  8  2012 ..
-rw-r-----  1 oracle oinstall 243272366 Nov  8 16:04 12.1.0.1.0_AgentCore_233.zip
[oracle@ec12mntrjr001 ~]$

Por fim, faça a transferência do arquivo gerado "12.1.0.1.0_AgentCore_233.zip" (ou qualquer outra versão semelhante) do seu servidor para o cliente rodando Windows. No meu caso, eu fiz download para um servidor temporário via SFTP e depois enviei para o cliente usando Remote Desktop.

4) Alterar o arquivo hosts do seu servidor

Edite o arquivo "C:\Windows\System32\drivers\etc\hosts" e inclua (ou descomente) as linhas, de forma que fique no seguinte formato:

#Your host
127.0.0.1       localhost.local localhost
10.192.12.77	YOURMACHINENAME.local YOURMACHINENAME
#EMC 12C
10.221.63.239   ec12mntrjr001.local ec12mntrjr001

5) Criar um agent registration password

Abra o seu OEM Cloud Control, e acesse o menu "Setup -> Security -> Registration Passwords":

Adicione uma senha nova e anote em algum lugar. No meu caso, criei uma senha "abc123" que expira no dia seguinte.

6) Gerar o arquivo agent.rsp

Crie um arquivo novo "agent.rsp" e defina nele alguns parâmetros básicos da instalação:
Exemplo:

OMS_HOST=ec12mntrjr001
EM_UPLOAD_PORT=4901
AGENT_REGISTRATION_PASSWORD=abc123
AGENT_PORT=3872
ORACLE_HOSTNAME=10.192.12.77

O campo "ORACLE_HOSTNAME", irá definir o nome do servidor que será apresentado na interface de "hosts" do seu painel do OEM Cloud Control. No meu caso, eu adoto o padrão de apresentar os IPs.

7) Descompactar e instalar o agente

Descompacte em algum diretório o arquivo transferido e zipado "12.1.0.1.0_AgentCore_233.zip". Crie um diretório onde será feita a instalação do agente, no meu caso, optei por "C:\agent12c" (não pode conter espaços).

OBS: Na versão 12.1.0.3, será necessário deixar o arquivo de plugin "12.1.0.3.0_PluginsOneoffs_233.zip", zipado mesmo, no mesmo local onde foi descompactado o arquivo acima, junto ao arquivo "agentDeploy.bat" . Observe:

Caso isso não seja feito, durante a instalação você receberá o erro:

"The Management Agent configuration failed. The plug-in configuration for the oracle.sysman.oh monitoring plug-in may have failed, or this plug-in may not be present in the Management Agent software. Ensure that the Management Agent software has the oracle.sysman.oh monitoring plug-in, if not then retry the operation. If the agent software has the oracle.sysman.oh monitoring plug-in, view the plug-in deployment log E:\app\Administrator\agent12c\agent_inst\install\logs to check if the plug-in configuration for the oracle.sysman.oh monitoring plug-in failed."

Agora abra um command prompt e execute a partir da pasta onde foi descompactado o zip:
- agentDeploy.bat AGENT_BASE_DIR=C:\agent12c RESPONSE_FILE=C:\Users\Administrator\Desktop\agent\agent.rsp

Microsoft Windows [Version 6.1.7600]
Copyright (c) 2009 Microsoft Corporation.  All rights reserved.

C:\Users\Administrator>cd Desktop\agent\12.1.0.1.0_AgentCore_233

C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233>agentDeploy.bat AGENT_BASE_DIR=C:\agent12c RESPONSE_FILE=C:\Users\Administrator\Desktop\agent\agent.rsp
C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233
Present working directory:C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233
Archive location:C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233
directory
AGENT_BASE_DIR
AGENT_BASE_DIR
C:\agent12c
Agent base directory:C:\agent12c
C:\agent12c
RESPONSE_FILE
C:\Users\Administrator\Desktop\agent\agent.rsp
Agent base directory:C:\agent12c
OMS Host:
Agent image loc : "C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233"
C:\agent12c configonlyfalse
Reading the properties file: "C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233"\agentimage.properties
        1 file(s) copied.
This is the version 12.1.0.1.0
This is the type core
This is the aru id 233
"Validating the OMS_HOST & EM_UPLOAD_PORT"
"C:\agent12c\core\12.1.0.1.0"
"Executing command : C:\agent12c\core\12.1.0.1.0\jdk\bin\java -classpath C:\agent12c\core\12.1.0.1.0\jlib\agentInstaller.jar:C:\agent12c\core\12.1.0.1.0\oui\jlib\OraInstaller.jar oracle.sysman.agent.installer.AgentInstaller C:\agent12c\core\12.1.0.1.0 "C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233" C:\agent12c -prereq"

Validando o host e a porta de oms com o url: http://ec12mntrjr001:4901/empbs/genwallet
Validando o host e a porta de oms com o url: https://ec12mntrjr001:4901/empbs/genwallet
Return status:3
"C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233"\12.1.0.1.0_PluginsOneoffs_233.zip
"Executing command : C:\agent12c\core\12.1.0.1.0\jdk\bin\java -classpath C:\agent12c\core\12.1.0.1.0\jlib\OraInstaller.jar:C:\agent12c\core\12.1.0.1.0\sysman\jlib\emInstaller.jar:C:\agent12c\core\12.1.0.1.0\jlib\xmlparserv2.jar:C:\agent12c\core\12.1.0.1.0\jlib\srvm.jar:C:\agent12c\core\12.1.0.1.0\jlib\emCfg.jar:C:\agent12c\core\12.1.0.1.0\sysman\jlib\agentInstaller.jar oracle.sysman.agent.installer.AgentInstaller C:\agent12c\core\12.1.0.1.0"

Executando prÚ-requisitos de instalaþÒo do agente...
Executando comando: C:\agent12c\core\12.1.0.1.0\oui\bin\setup.exe -ignoreSysPrereqs -prereqchecker -silent -ignoreSysPrereqs -waitForCompletion  -prereqlogloc C:\agent12c\core\12.1.0.1.0\cfgtoollogs\agentDeploy -entryPoint oracle.sysman.top.agent_Complete -detailedExitCodes PREREQ_CONFIG_LOCATION=C:\agent12c\core\12.1.0.1.0\prereqs  -J-DORACLE_HOSTNAME=10.192.12.77
Prereq Logs Location:C:\agent12c\core\12.1.0.1.0\cfgtoollogs\agentDeploy\prereq<timestamp>.log
PrÚ-requisitos de instalaþÒo do agente concluÝdos com sucesso

Clonando o home do agente...
Executando comando: C:\agent12c\core\12.1.0.1.0\oui\bin\setup.exe -ignoreSysPrereqs -clone -forceClone -silent -waitForCompletion -nowait ORACLE_HOME=C:\agent12c\core\12.1.0.1.0 -responseFile C:\Users\Administrator\Desktop\agent\agent.rsp AGENT_BASE_DIR=C:/agent12c AGENT_BASE_DIR=C:/agent12c RESPONSE_FILE=C:\Users\Administrator\Desktop\agent\agent.rsp -noconfig  ORACLE_HOME_NAME=agent12c2 -force
Clone Action Logs Location:C:\Program Files\Oracle\Inventory\logs\cloneActions<timestamp>.log
Clonagem do home do agente concluÝda com sucesso

Anexando home do sbin...
Executando comando: C:\agent12c\core\12.1.0.1.0\oui\bin\setup.exe -ignoreSysPrereqs -attachHome -waitForCompletion -nowait ORACLE_HOME=C:\agent12c\sbin ORACLE_HOME_NAME=sbin12c2 -force
Attach Home Logs Location:C:\agent12c\core\12.1.0.1.0\cfgtoollogs\agentDeploy\AttachHome<timestamp>.log
AnexaþÒo do home do sbin concluÝda com sucesso.

Updating home dependencies...
Executando comando: C:\agent12c\core\12.1.0.1.0\oui\bin\setup.exe -ignoreSysPrereqs -updateHomeDeps -waitForCompletion HOME_DEPENDENCY_LIST="C:\agent12c\sbin:C:\agent12c\core\12.1.0.1.0" -invPtrLoc C:\agent12c\core\12.1.0.1.0\oraInst.loc -force
Update Home Dependencies Location:C:\agent12c\core\12.1.0.1.0\cfgtoollogs\agentDeploy\UpdateHomeDeps<timestamp>.log
AtualizaþÒo da dependÛncia do home concluÝda com sucesso.

Executando a configuraþÒo do agente...
Executando comando: C:\agent12c\core\12.1.0.1.0\oui\bin\runConfig.bat ORACLE_HOME=C:\agent12c\core\12.1.0.1.0 RESPONSE_FILE=C:\agent12c\core\12.1.0.1.0\agent.rsp ACTION=configure MODE=perform COMPONENT_XML={oracle.sysman.top.agent.11_1_0_1_0.xml} RERUN=true
Configuration Log Location:C:\agent12c\core\12.1.0.1.0\cfgtoollogs\cfgfw\CfmLogger<timestamp>.log
Agent Configuration completed successfully
Agent deployment log location:
C:\agent12c\core\12.1.0.1.0\cfgtoollogs\agentDeploy\agentDeploy_<timestamp>.log
Agent deployment completed successfully.
C:\Users\Administrator\Desktop\agent\12.1.0.1.0_AgentCore_233>

Pronto, o seu agente foi instalado e implantado com sucesso.

OBS: Na versão 12.1.0.3, poderá aparecer uma tela de erro do Windows conforme abaixo. Caso apareça, clique em "Fechar o Programa" e ignore:

8) Adicione os alvos no OEM

Por fim, acesse a interface web do seu OEM novamente e adicione os alvos do seu novo host monitorado!

+10