10g Agent mass deployment using the clone method.

The oracle 10g management agent needs to be installed on all the remote services which we wish to monitor and administer using the Enterprise Manager Grid Control product.

If we are faced with deploying the agent on hundreds of servers which is very likely in case of large organizations, we need to be able to automate the process of installing the agent on each of these nodes rather than have to do it manually on each machine.

There are a number of methods of mass deploying the agent which is outlined in this white paper 10g R2 Management Agent Deployment Best Practices.

Let us have a quick look at how we can deploy the agent using the clone method.

Source machine is sunos1 and target machine is sunos2. The agent Oracle Home on both machines is /u01/app/oracle/product/agent10g

Tar the source Agent Oracle Home, copy to target machine and untar the same.

sunos1:/u01/app/oracle/product $ tar -cvf agent10g.tar agent10g

sunos1: scp -rp agent10g.tar oracle@sunos2:/u01/app/oracle

sunos2:/u01/app/oracle/product $ tar -xvf agent10g.tar

On the target machine in the now unpacked Oracle Home, execute the following command

sunos2:./runInstaller -clone -forceClone ORACLE_HOME=/u01/app/oracle/product/agent10g ORACLE_HOME_NAME==Agent10g_Home -noconfig -silent

Starting Oracle Universal Installer…

No pre-requisite checks found in oraparam.ini, no system pre-requisite checks will be executed.
Preparing to launch Oracle Universal Installer from /tmp/OraInstall2010-09-20_09-39-39AM. Please wait …sunos2:/u01/app/oracle/product/agent10g/oui/bin $ Oracle Universal Installer, Version 10.2.0.5.0 Production
Copyright (C) 1999, 2009, Oracle. All rights reserved.

You can find a log of this install session at:
/u01/app/oracle/oraInventory/logs/cloneActions2010-09-20_09-39-39AM.log
………………………………………………………………………………………. 100% Done.

Installation in progress (Monday, September 20, 2010 9:40:05 AM WST)
………………………………………………………… 66% Done.
Install successful

Linking in progress (Monday, September 20, 2010 9:40:20 AM WST)
. 67% Done.
Link successful

Setup in progress (Monday, September 20, 2010 9:41:37 AM WST)
………………… 100% Done.
Setup successful

End of install phases.(Monday, September 20, 2010 9:41:56 AM WST)
WARNING:
The following configuration scripts need to be executed as the “root” user.
#!/bin/sh
#Root script to run
/u01/app/oracle/product/agent10g/root.sh
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 following reasons – either root.sh is to be run before config or Oracle Universal Installer was invoked with the -noConfig option.
————————————–
The “/u01/app/oracle/product/agent10g/cfgtoollogs/configToolFailedCommands” script contains all commands that failed, were skipped or were cancelled. This file may be used to run these configuration assistants outside of OUI. Note that you may have to update this script with passwords (if any) before executing the same.
The “/u01/app/oracle/product/agent10g/cfgtoollogs/configToolAllCommands” script contains all commands to be executed by the configuration assistants. This file may be used to run the configuration assistants outside of OUI. Note that you may have to update this script with passwords (if any) before executing the same.

————————————–
The cloning of Agent10g_Home was successful.
Please check ‘/u01/app/oracle/oraInventory/logs/cloneActions2010-09-20_09-39-39AM.log’ for more details.

Run the root.sh

root@sunos2 > /u01/app/oracle/product/agent10g/root.sh
Running Oracle10 root.sh script…

The following environment variables are set as:
ORACLE_OWNER= oracle
ORACLE_HOME= /u01/app/oracle/product/agent10g

Enter the full pathname of the local bin directory: [/usr/local/bin]:
The file “dbhome” already exists in /usr/local/bin. Overwrite it? (y/n) [n]:
The file “oraenv” already exists in /usr/local/bin. Overwrite it? (y/n) [n]:
The file “coraenv” already exists in /usr/local/bin. Overwrite it? (y/n) [n]:

Entries will be added to the /var/opt/oracle/oratab file as needed by
Database Configuration Assistant when a database is created
Finished running generic part of root.sh script.
Now product-specific root actions will be performed.
Finished product-specific root actions.

Run the agentca command to configure the targets

sunos2:/u01/app/oracle/product/agent10g/bin $ ./agentca -f

Stopping the agent using /u01/app/oracle/product/agent10g/bin/emctl stop agent
Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0.
Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved.
Running agentca using /u01/app/oracle/product/agent10g/oui/bin/runConfig.sh ORACLE_HOME=/u01/app/oracle/product/agent10g ACTION=Configure MODE=Perform RESPONSE_FILE=/u01/app/oracle/product/agent10g/response_file RERUN=TRUE INV_PTR_LOC=/u01/app/oracle/product/agent10g/oraInst.loc COMPONENT_XML={oracle.sysman.top.agent.10_2_0_1_0.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/configActions2010-09-20_09-46-02-AM.log

Secure the agent (optional) if running the OMS in secure mode

sunos2:/u01/app/oracle/product/agent10g/bin $ ./emctl secure agent

Enter Agent Registration Password :
Agent successfully restarted… Done.

Securing agent… Successful.

Check the status of the agent and confirm that it has uploaded XML files to the OMS repository

sunos2:/u01/app/oracle/product/agent10g/bin $ ./emctl status agent
Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0.
Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved.
—————————————————————
Agent Version : 10.2.0.5.0
OMS Version : 10.2.0.5.0
Protocol Version : 10.2.0.5.0
Agent Home : /u01/app/oracle/product/agent10g
Agent binaries : /u01/app/oracle/product/agent10g
Agent Process ID : 12137
Parent Process ID : 12130
Agent URL : https://sunos2:3872/emd/main/
Repository URL : https://sunoms01:1159/em/upload
Started at : 2010-09-20 10:01:49
Started by user : oracle
Last Reload : 2010-09-20 10:01:49
Last successful upload : 2010-09-20 10:23:05
Total Megabytes of XML files uploaded so far : 17.68
Number of XML files pending upload : 0
Size of XML files pending upload(MB) : 0.00
Available disk space on upload filesystem : 84.02%
Last successful heartbeat to OMS : 2010-09-20 10:24:08
—————————————————————
Agent is Running and Ready