APPLIES TO:
Enterprise Manager Base Platform - Version 12.1.0.1.0 to 12.1.0.5.0 [Release 12.1]
Information in this document applies to any platform.

SYMPTOMS:
This note is written for the 12.1.0 1.0 agent version, but applies similarly to other EM Cloud Control Agent versions.

Installing the Enterprise Manager (EM) 12c Cloud Control Agent fails at the configuration step while starting the Agent:

Performing the agent configuration...
Executing command: <AGENT_BASE_DIR>/agent12c/core/12.1.0.1.0/oui/bin/runConfig.sh ORACLE_HOME=<AGENT_BASE_DIR>/agent12c/core/12.1.0.1.0 RESPONSE_FILE=<AGENT_BASE_DIR>/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:<AGENT_BASE_DIR>/agent12c/core/12.1.0.1.0/cfgtoollogs/cfgfw/CfmLogger<timestamp>.log
ERROR: Agent Configuration Failed SEVERE: emctl start agent command has failed with status1

These additional messages are logged:

From <AGENT_BASE_DIR>/core/<version>/cfgtoollogs/cfgfw/Cfmlogger<timestamp>.log:
INFO: oracle.sysman.top.agent:Executing the command:<AGENT_BASE_DIR>/agent12c/agent_inst/bin/emctl start agent
INFO: oracle.sysman.top.agent:Oracle Enterprise Manager 12c Cloud Control 12.1.0.1.0
INFO: oracle.sysman.top.agent:Copyright (c) 1996, 2011 Oracle Corporation. All rights reserved.
INFO: oracle.sysman.top.agent:Starting agent .....Consult the log files in: <AGENT_BASE_DIR>/agent12c/agent_inst/sysman/log
....
SEVERE: oracle.sysman.top.agent:emctl start agent command has failed with status1
INFO: oracle.sysman.top.agent:

Follow the below steps to manually start the agent and add the host and agent targets:
1. Start the agent by executing the command: <AGENT_BASE_DIR>/agent12c/agent_inst/bin/emctl start agent
2. Add the targets by executing the command:<AGENT_BASE_DIR>/agent12c/agent_inst/bin/emctl config agent addinternaltargets.
3. Perform the plugin configuration by running the command: <AGENT_BASE_DIR>/agent12c/core/12.1.0.1.0/perl/bin/perl

<AGENT_BASE_DIR>/agent12c/core/12.1.0.1.0/bin/AgentPluginDeploy.pl -oracleHome <AGENT_BASE_DIR>/agent12c/core/12.1.0.1.0

-agentDir <AGENT_BASE_DIR>/agent12c -pluginIdsInfoFile <AGENT_BASE_DIR>/agent12c/plugins.txt -action configure -emStateDir <AGENT_BASE_DIR>/agent12c/agent_inst

SEVERE: oracle.sysman.top.agent:Agent configuration has failed

INFO: AgentConfiguration:agent configuration finished with status = false

 

From AGENT_INST/sysman/log/emagent.nohup:
----- Wed Jul 25 08:08:02 2012::446504::Agent Launched with PID 532652 at time Wed Jul 25 08:08:02 2012 -----
----- Wed Jul 25 08:08:02 2012::532652::Time elapsed between Launch of Watchdog process and execing EMAgent is 5 secs -----
log4j:ERROR Could not find value for key log4j.appender.QA
log4j:ERROR Could not instantiate appender named "QA".
----- Wed Jul 25 08:08:12 2012::446504::Checking status of EMAgent : 532652 -----
----- Wed Jul 25 08:08:12 2012::446504::EMAgent exited at Wed Jul 25 08:08:12 2012 with return value 55. -----

 

From AGENT_INST/sysman/log/gcagent.log:
2012-07-25 08:08:56,365 [1:3305B9] INFO - Agent is starting up
2012-07-25 08:08:58,504 [1:3305B9] INFO - *jetty*: Logging to oracle.sysman.gcagent.comm.agent.http.HTTPListenerLogger@6ce46ce4 via oracle.sysman.gcagent.comm.agent.http.HTTPListenerLogger
2012-07-25 08:08:58,654 [1:3305B9] INFO - *jetty*: jetty-7.0.1.v20091125
2012-07-25 08:08:58,803 [1:3305B9] WARN - *jetty*: FAILED SslSelectChannelConnector@aix-agent60.mydomain.com.mydomain.com:3872: java.net.SocketException: Unresolved address
2012-07-25 08:08:58,808 [1:3305B9] WARN - *jetty*: FAILED org.eclipse.jetty.server.Server@13851385: java.net.SocketException: Unresolved address
2012-07-25 08:08:58,812 [1:3305B9] WARN - Agent failed to Startup for TM Listener in step 0
2012-07-25 08:08:58,815 [1:3305B9] INFO - Agent exiting with exit code 55

 

CAUSE:
Below are some of the common reasons for Agent Startup failures

Incorrect Hostname resolution
Provided Agent port in use
Insufficient ulimit settings
Incorrect Timezone at Operating System

 

SOLUTION:
1. Correct the host entries in /etc/hosts file and also ensure that host name resolves to the right ip address.

a.) Run the ifconfig command to get the IP address of the Agent host
Unix: $ /sbin/ifconfig -a
Windows: C:\> ipconfig /all 

b.) Update the /etc/hosts file to add an entry in the below format
<IP address listed in above output> <hostname.domain> <short hostname>

2. Ensure that the Agent port provided during installation is not in use
Unix: netstat -an | grep 3872
Windows: netstat -an | findstr 3872 

3. Edit the agent_inst/sysman/config/emd.properties file
Change: AgentListenOnAllNICs=TRUE
To: AgentListenOnAllNICs=FALSE

4. Ensure that the openfiles and Max User processes shell limits are set to sufficiently higher values
ulimit -n --- should be set to 8192 or higher
ulimit -u --- should be set to 65535 or higher

5. Set Timezone correctly on the Agent machine
export TZ=America/New_York --- This should be in region format; which should be listed in <AGENT_BASE_DIR>/core/<version>/sysman/admin/supportedtzs.lst

6. Start the Agent
<agent_inst>/bin/emctl start agent

7. Add the Internal targets using:
agent_inst/bin/emctl config agent addInternaltargets

 

Recent Posts

Start typing and press Enter to search