Grid Control Agent Cloning

Agent Cloning in Grid Control – Finally Oracle came up with a simple elegant solution for deploying GC agents!

By far the biggest challenge with Oracle Management Server is implementing the agent- push, pull, manual installs/upgrades/migrations and the cloning method (new in

Overview of Common Known Issues Associated with the Agent Push Installation Method Doc ID: 376355.1

How to Deploy the Agent Using the Agent Push Installation Method  Doc ID: 376262.1

How to Clone a Management Agent And Known Issues Doc ID:  579156.1

agent cloning – new in

  • Zip an already installed agent home. (I personally used tar and gzip)
  • Scp or ftp to standalone host you want it installed on, uncompress in the same location. (at this point I uninstalled the older agent, removed any leftover files, unzipped, untarred new agent in the same directory).
  • $AGENT_HOME/oui/bin/runInstaller -clone -forceClone ORACLE_HOME=<full path of Oracle home> ORACLE_HOME_NAME=<Oracle home name> -noconfig -silent
  • $AGENT_ORACLE_HOME/bin/agentca –f  (configures the agent)
  • $AGENT_ORACLE_HOME/ (as root)
  • Results are as follows:

> acle/product/agent10g ORACLE_HOME_NAME=agent10g -noconfig -silent           <
Starting Oracle Universal Installer…

No pre-requisite checks found in oraparam.ini, no system pre-requisite checks wll be executed.
Preparing to launch Oracle Universal Installer from /tmp/OraInstall2009-05-27_0-43-15AM. Please wait …unixaccount@host:/u01/app/oracle/product[EA]
> Oracle Universal Installer, Version Production
Copyright (C) 1999, 2009, Oracle. All rights reserved.

You can find a log of this install session at:
……………………………………………………………………………………… 100% Done.


Installation in progress (Wednesday, May 27, 2009 8:43:25 AM MDT)
…………………………………………………………                                                             66% Done.
Install successful

Linking in progress (Wednesday, May 27, 2009 8:43:27 AM MDT)
.                                                                67% Done.
Link successful

Setup in progress (Wednesday, May 27, 2009 8:43:36 AM MDT)
………………..                                            100% Done.
Setup successful

End of install phases.(Wednesday, May 27, 2009 8:43:38 AM MDT)
The following configuration scripts need to be executed as the “root” user.
#Root script to run
To execute the configuration scripts:
    1. Open a terminal window
    2. Log in as “root”
    3. Run the scripts

Starting to execute configuration assistants
The following configuration assistants have not been run. This can happen for fllowing reasons – either is to be run before config or Oracle UniversalInstaller was invoked with the -noConfig option.
The “/u01/app/oracle/product/agent10g/cfgtoollogs/configToolFailedCommands” scrpt contains all commands that failed, were skipped or were cancelled. This filemay be used to run these configuration assistants outside of OUI. Note that youmay have to update this script with passwords (if any) before executing the sam.
The “/u01/app/oracle/product/agent10g/cfgtoollogs/configToolAllCommands” scriptcontains all commands to be executed by the configuration assistants. This filemay be used to run the configuration assistants outside of OUI. Note that you my have to update this script with passwords (if any) before executing the same.

The cloning of agent10g was successful.
Please check ‘/u01/app/oracle/oraInventory/logs/cloneActions2009-05-27_08-43-15M.log’ for more details.

> $ORACLE_HOME/bin/agentca -f

Stopping the agent using /u01/app/oracle/product/agent10g/bin/emctl  stop agent
Oracle Enterprise Manager 10g Release 5 Grid Control
Copyright (c) 1996, 2009 Oracle Corporation.  All rights reserved.
Running agentca using /u01/app/oracle/product/agent10g/oui/bin/ ORALE_HOME=/u01/app/oracle/product/agent10g ACTION=Configure MODE=Perform RESPONSEFILE=/u01/app/oracle/product/agent10g/response_file RERUN=TRUE INV_PTR_LOC=/u01app/oracle/product/agent10g/oraInst.loc COMPONENT_XML={}
Perform – mode is starting for action: Configure
Perform – mode finished for action: Configure

You can see the log file: /u01/app/oracle/product/agent10g/cfgtoollogs/oui/confgActions2009-05-27_08-44-07-AM.log
> emctl upload agent
Oracle Enterprise Manager 10g Release 5 Grid Control
Copyright (c) 1996, 2009 Oracle Corporation.  All rights reserved.
EMD upload completed successfully


Other Methods of Installation


Push Method

  • Entire set of binaries transferred to all target hosts. 
  • Mounted location common to all hosts.
  • For a limited number of hosts.
  • Deployments tab of OMS, patch agent link, patch number, platform and release.

Pull Method

  • Only a script is transferred and patch installed over HTTP.
  • Large number of target hosts


Default agent installed with OMS install is not at that the latest version and will need to be upgraded and maintained.

MAA practices for the Agent component of OMS include a front-end load balancer for the OMS servers so that if they go down no need to reconfigure and also helps to create pools of node targets.  Metalink Note: 353074.1

10gR2 Management Agent Deployment Best Practices – White Paper, July 2006, see URL section for OTN – Architecture


8 Responses to Grid Control Agent Cloning

  1. Manish Patil says:


    Sorry for pasting this question in this section. I think you might help me.

    We upgraded our Grid to on Linux X86-64. GC is installed on the server which is in USA.

    There is some strange issue we are seeing from grid. We are having database targets from different locations like USA, Dublin..

    When we navigate to Database target > One of the database located outside USA – Say Dublin Database > Performance Tab
    It shows Active sessions and other graphs for that database. I am in USA and I am able to see the graph with correct timings on the graph with Dublin time. But when Dublin user tries to see the same graph, for him its not showing the correct time. Its showing something 5hrs different.

    Have you seen this issue?

    Thanks in Advance!

    • aprilcsims says:

      Our sites are not so diverse in time zones so I have not personally experienced this problem. I would start by verifying all time zone settings from the Operating System, Grid Control and Agents for all nodes involved. Also entering a SR through Metalink would get you more help than me.

  2. Manish Patil says:

    Thanks! for last reply. I am opening SR with oracle.

    Regarding cloning Agent

    I upgraded one of my agent on solaris from to Oracle Application management pack 2.0.2 is already installed on

    I took the backup of agent home and unzipped it at new location. From
    $AGENT_HOME/oui/bin/ , I ran below command

    runInstaller -clone -forceClone ORACLE_HOME=/u02/app/applmgr/OEMAGENT_itebsapd2/agent10g ORACLE_HOME_NAME=agent10g3 -noconfig -silent

    It failed with below errors..
    acceptCompatible = null
    INFO: Query Returned: false
    INFO: Setting the PRE_REQUISITE variable of ‘oracle.apps.agent_extn_2.’ to ‘false’. Received the value from the variable calculation.
    INFO: OUI-10080:The pre-requisite for the component Management Agent Plug-in for Oracle Applications has failed.
    INFO: EM Agent version or higher is not installed in this location specified. Please choose to install into a different location where EM Agent is i

    Please help


    • aprilcsims says:

      Sounds like you need to take a closer look at the response file…it seems to think this is an Oracle Apps Agent Install. If it is then the response file needs to be edited, look for ‘oracle.apps.agent_extn’ and set this to true.

      • Manish Patil says:

        Thanks for quick reply.

        Which response file I need to check for? Where it is located?

        Thanks in advance!


  3. aprilcsims says:

    Look for the following:


    Not sure of the exact syntax, see if you can figure out from the rest of the entries in this file. I think that Metalink needs a document on how to accurately edit this file.
    Good luck! I don’t have Oracle Apps in order to test this.

  4. Manish Patil says:


    I am unable to find the response file under Agent_Home. I searched for response* under agent home but unable to find that one.

    Appreciate your help!


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s