转 11g Grid Control: Overview of the EMCTL Options Available for Managing the Agent

Posted 2020-10-16 feiyun8616的作坊 (半个程序员and dba)

 

 

Please set the ORACLE_HOME to your Agent Home location using

For Unix:
export ORACLE_HOME=/oracle/product/agent11g

For Windows:

set ORACLE_HOME=C:\oracle\product\agent11g

The emctlutility can be executed from the <AGENT_HOME>/bin directory.

emctl.log file

The emctl.log file is a file that captures the results of all emctl commands you run. The log file resides in the $ORACLE_HOME/sysman/log directory of the Management Agent, and is updated every time you run an emctl command. If your emctl command fails for some reason, access this log file to diagnose the issue.

For more information On how to debug emctl.log file Please refer to Oracle Enterprise Manager Administration 11g Release 1 (11.1.0.1), Chapter 7 - Starting and Stopping Enterprise Manager Components, Topic: Using emctl.log File.

Description of EMCTL Commands:

 

Command	Description
emctl start agent	Starts the Management Agent
emctl stop agent	Stops the Management Agent
emctl status agent	If the Management Agent is running, this command displays status information about the Management Agent, including the Agent Home, the process ID, and the time and date of the last successful upload to the Management Repository
emctl upload (agent)	Use this command to force an immediate upload of the current management data from the managed host to the Management Service.
emctl clearstate	Clears the state directory contents. The files that are located under $ORACLE_HOME/sysman/emd/state will be deleted if this command is run.
emctl getemhome	Prints the Agent home directory
emctl config agent getLocalHost	Prints the hostname where the Agent is running
emctl pingOMS [agent]	Pings the OMS to check if the agent is able to connect to the OMS. Agent will wait for the reverse ping from the OMS so that Agent can say the pingOMS is successful.
emctl verifykey	Verifies the communication between the OMS and agent by sending pingOMS.
emctl reload agent	Reloads the agent by reading the emd.properties and targets.xml files again.
emctl status agent scheduler	Lists all Running, Ready, and Scheduled Collection threads
emctl status agent jobs	Lists the status of the jobs that are running at present on the agent.
emctl status agent target	Lists the detailed status of the specified targets in the order of target name, target type
Agent Secure Commands
emctl status agent -secure	Check if the Agent is secured in https mode.
emctl secure agent agent_registration_pwd	Configures the Agent to communication with the OMS in the HTTPS mode.
emctl unsecure agent	Unsecures the agent. This will make the agent unsecure and the Agent‘s port will be changed to http port.
emctl secure setpwd [-sysman_pwd] [new registration pwd]	To add a new Agent Registration Password
Blackouts
emctl start blackout <Blackoutname> [<Target_name>[:<Target_Type>]].... [-d <Duration>] [-nowait]	Set an immediate blackout on a particular target or on list of targets.
emctl stop blackout <Blackoutname> [-nowait]	Stops an immediate blackout
emctl start blackout [-nodeLevel] [-d ]	Set an immediate blackout for all targets on a host
emctl status blackout [<Target_name>[:<Target_Type>]]	Check the status of a blackout
Timezone commands
emctl config agent getTZ	Prints the current timezone of the agent.
emctl resetTZ agent	This command will correct the Management Agent side time zone and specify an additional command to be run against the Management Repository to correct the value there.
emctl config agent updateTZ	Updates the current timezone of the agent in emd.properties file.
emctl config agent getSupportedTZ	Prints the supported timezones for the agent.
Memory And CPU commands
emctl status agent memory	Used for debugging agent memory. You will need to set enableMemoryTracing=TRUE in emd.properties for memory profiling agent.
emctl status agent cpu	Dumps the agent Thread CPU usage into a .trc file. This file contains the list of all the threads that are running at present and their CPU usage
emctl dumpstate agent	Generates the dumps for the agent. This command allow you to analyze the memory/cpu issues of the agent.
emctl status agent memclean	Clears the memory hash table. Note that by default, the memory tracing will not be enabled by the agent. So, if the memory tracing is not enabled, then emctl status agent memclean will not clear the hashtable.
Target Configuration
emctl config agent listtargets	Lists the target names and target types on specified host
emctl config agent listtargetsfully	lists the targets fully
emctl config agent credentials [<Target_name>[:<Target_Type>]]	Provides the option to change the credentials for a particular target.target name and target type can be obtained from output of command: emctl config agent listtargets
emctl config [agent] addtarget [-f-force] []	Allows you to configure agent. contains a definition of target to add and where -f or -force allows to overwrite an existing target.
emctl config [agent] modifytarget [][][-mergeProps]	Allows you to configure agent. contains a definition of target to modify and -mergeProps is used when only target properties are to be updated.
emctl config [agent] deletetarget []	Allows you to delete target. Specify target type and name to delete.
Miscellaneous
emctl gensudoprops	Generates the sudo properties of the agent.
emctl clearsudoprops	Clears the sudo properties
emctl secure add_trust_cert -trust_certs_loc file>	Adds the trusted new certificate on all agents to communicate with the OMS
emctl relocate_target agent [=]* [-force]	Used to relocate target
emctl getversion	Prints the version of the agent. Sample output: $ emctl getversion  Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0.  Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved.

 

 

 

 Kindly review the following :

1. Make sure the hostname is resolvable.

2. /etc/hosts should have a recommended format:
<IPAddress>      <Fully Qualified Hostname>        <Short Name>

3. Start the agent

./emctl start agent

Now the agent starts without any issues.

 

References :

12.1.0.2 agent fails to start with error "HTTP Listener failed at Startup" after new installation. [ID 1519682.1]

 

Or 

 

1. Stop the agent:
     <AGENT_INST_HOME>/bin>./emctl stop agent

2. Ensure that none of the agent process is running:
          $ ps -ef | grep -i TMMain

3. Kill the agent process that are still running

4.Start the agent
     <AGENT_INST_HOME>/bin>./emctl start agent
 

References :

12.1.0.2 Agent Startup Fails With Error "Possible port conflict on port" [ID 1509575.1]

 

Please mark the thread as Helpful or Correct to help other users to find questions that were answered. 

 

     

emctl status oms