How To Run The Discovery Of The 10.2 Agent Manually

Applies to: 
Enterprise Manager Grid Control - Version: 10.2.0.1 to 10.2.0.3
Information in this document applies to any platform.

Goal
The Agent Configuration Assistant (agentca) script is used to reconfigure the agent and rediscover the targets on the machine. This script is useful when you want to rediscover a newly added target on the machine and/or to convert a standalone agent to a RAC Agent.

This article gives the steps to rediscover targets with the option -d



Solution

1. Check that the ENV is set for the Management Agent
- ORACLE_HOME set
- $ORACLE_HOME/bin in $PATH
The Agentca utility is expecting the oraInst.loc to be located in the Oracle Home.
For example: agent is installed into the following directory
/home/oracle/OracleHomes/agent10g
The Agentca is looking for the oraInst.loc in /home/oracle/OracleHomes/agent10g.
This is fine for all UNIX platforms except Solaris. Solaris puts the oraInst.loc in /var/opt/oracle
The Agentca will not fine the oraInst.loc on a Solaris platform.
The Agentca does not use the command line parameter ?-invPtrLoc? like the OUI.
For Solaris platforms you need to create a soft link:
?/home/oracle/OracleHomes/agent10g/oraInst.loc? to ?/var/opt/oracle/oraInst.loc?
2. Backup Agent’s $ORACLE_HOME/sysman/emd/targets.xml
2.A - Copy the file Agent’s $ORACLE_HOME/sysman/emd/targets.xml to targets.xml.orig . The original and a backup targets.xml will exist.
or
2.B - Rename Agent’s $ORACLE_HOME/sysman/emd/targets.xml to
$ORACLE_HOME/sysman/emd/targets.xml.bck.
Create a stub targets.xml file.
Open Agent’s $ORACLE_HOME/sysman/config/emd.properties file. Copy the values for:
…
agentSeed=55555555
…
EMD_URL=http://hostname.oracle.com:1830/emd/main
…
Create the targets.xml file
Edit the new targets.xml and add the following the:

 

For example based on the example from the Agent’s $ORACLE_HOME/sysman/config/emd.properties file:

3. Run agentca -d. from the Agent’s $ORACLE_HOME/bin
4. Check that the targets.xml has been created in $ORACLE_HOME/sysman/emd directory
Check that the Management Agent uploads successfully to the Management Service with emctl status agent
5. For any agentca issue consult the following log files in the Agent home:

- $ORACLE_HOME/cfgtoollogs/oui/configActions.log
- $ORACLE_HOME/cfgtoollogs/oui/configActions.err
- $ORACLE_HOME/cfgtoollogs/cfgfw/CfmLogger__.log

REFERENCES
Oracle® Enterprise Manager
Grid Control Installation and Basic Configuration
10g Release 2 (10.2) B16228-02
Chapter 6.5 Agent Reconfiguration and Rediscovery