This document describes how to add additional Host targets to the Enterprise Manager Central Console by installing the Oracle Management Agent.
To add a Host target, you simply install the Oracle Management Agent on the host computer you want to manage. When the Management Agent on that host begins communicating with the Oracle Management Service, the Agent target and the Host target will appear in the list of targets. Refer to the information in this document for instructions on installing the Oracle Management Agent.
This document is available from two locations after you install Oracle Enterprise Manager. You can display this document by clicking Add on the Hosts page in the Enterprise Manager Central Console, or you can locate and display this document in a text editor at the following location after you install the Oracle Management Service:
IAS_HOME/sysman/agent_download/agent_install_readme.html
IAS_HOME is the home directory of the Application Server where the Oracle Management Service is installed and deployed. For more information about the directories and files installed by the Enterprise Manager installation, see Oracle Enterprise Manager Advanced Configuration.
After you install the Oracle Management Service, your next step is to install the Oracle Management Agent on each host computer that you want to manage. Enterprise Manager provides two Management Agent installation methods:
On each host computer, run the Oracle Universal Installer from the Enterprise Manager CD-ROM and select the Additional Oracle Management Agent installation type. Instructions for using this Management Agent installation method are included in Oracle Enterprise Manager Basic Installation and Configuration.
OR
Use the separate Management Agent installation CD-ROM to install and deploy Management Agents to many managed hosts.
This document describes how to use the Management Agent CD-ROM to install and deploy the Management Agent across multiple managed hosts across your Enterprise.
There are a number of ways to install Agents from the Agent Download CD:
Note: You must use the version of Oracle Universal Installer that is distributed on the Management Agent installation CD-ROM; otherwise, you cannot perform some of the procedures described in this document.
You can share the Agent Download CD-ROM—or copy the contents of the CD-ROM to a shared disk—and run Oracle Universal Installer from the shared location. You can install the Management Agent using the interactive, graphical installation screens of the Universal Installer, or you can install the Management Agent silently using the response file that is included on the Agent Download CD-ROM.
The Management Agent CD-ROM contains a sample script called agentDownload. This sample script is provided as an example of how you can deploy Multiple Agents using a silent, scripted installation. The agentDownload script is fully functional and self-documenting so it can be customized easily for specific environments.
The agentDownload script uses "pull" technology. In other words, even though the script does not have to exist on a local file system, it must always be executed from the target host computer. You must be logged into the target host to run the script. Files are not pushed from a central location to a list of target hosts. Instead, files are pulled to the local $ORACLE_HOME from the staged product installation location.
This means that the agentDownload needs to be launched from each target host where you want the Management Agent installed. Because the installation is scripted, it is possible to use a wrapper script, UNIX cron job, rdist, or a combination of operating system features to fully automate this process for mass deployments.
The download script deploys the standard Management Agent installation, with some additional benefits:
It can be modified for specific user environments
It is non-interactive
It's output is text-only (non-graphical)
Management Agents installed using the script are identical to Management Agents installed with the Oracle Universal Installer graphical installation.
The script invokes Oracle Universal Installer installation, but in silent mode
To deploy multiple Management Agents using the agentDownload script, you must do the following:
Install the Oracle Management Service.
You install the Management Service using the Oracle Universal Installer and the instructions in Oracle Enterprise Manager Basic Installation and Configuration. The Management Service is installed and deployed into its own Oracle9iAS home directory.
For more information about the directory structure of a typical Management Service installation, see Oracle Enterprise Manager Advanced Configuration.
Copy or mount the contents of the Management Agent CD-ROM to the following directory inside the Oracle9iAS home directory where the Management Service was installed and deployed:
IAS_HOME/sysman/agent_download/
Download the agentDownload script to the target host from the Management Service URL.
The Management Service installation creates a Web sever alias called agent_download that maps to a physical directory in the Oracle9iAS home directory where the Management Service is installed and deployed. OMS. For example, if you installed the Management Service on a host named mgmthost27.acme.com, you could access the following URL from a browser:
http://mgmthost27.acme.com:4889/agent_download/
Note: Port 4889 is the default port for the Enterprise Manager Central Console, and so it will always be available after you install the Management Service.
Using this Web server alias, you can download the agentDownload script to the target host computer using the following URL:
http://mgmthost27.acme.com:4889/agent_download/download_scripts/agentDownload
Any method of retrieving the file is acceptable: for example, cp, rcp, scp, or FTP. The script can also be retrieved by launching a browser on the target machine and saving the link to a local file.
Execute the agentDownload script on the target host.
Before launching the script ensure that:
The execute bit is set and the script file has the proper file protection settings (use chmod to ensure the file has the correct privileges).
The $ORACLE_HOME environment variable is set in the user environment. This will be the location of the Management Agent home on the target host; if the directory does not exist it will be created during the installation. If it exists, it must be empty.
The $AGENT_INSTALL_PASSWORD environment variable is set in the environment if the Management Agent will be uploading to a secure Management Service.
For more information about enabling Security for Enterprise Manager components, see Oracle Enterprise Manager Advanced Configuration.
The script user has the necessary file access permissions for the Management Agent home directory
After the Management Agent installation is complete, change directory to the Agent home directory and run the root.sh script as the root user.
For example:
$PROMPT>su root Password: root_password #./root.sh #exit $PROMPT>
The root.sh script must be run as root; otherwise, the Management Agent will not be able to use the Enterprise Manager job system. The job system is required for some Enterprise Manager features, such as hardware and software configuration tasks and configuring managed database targets.
The agentDownload script performs the following actions:
Creates home directories for the Management Agent and Oracle Universal Installer if they don't exist, based on the following environment variable:
$ORACLE_HOME
Downloads the agent_download.rsp response file from the Management Service Web server
The Management Service installs the response file with the name and port number of the Management Service. As a result, the Management Agent you install will be configured to use the Management Service from which the response file was downloaded.
Downloads a jarred Oracle Universal Installer for the target operating system from the Management Service Web server.
Unjars the Oracle Universal Installer and points the Oracle Universal Installer to the product definition (products.jar) hosted by the Management Service Web server
Launches the Oracle Universal Installer in silent mode from the local machine; the Universal Installer pulls files from the Web server to the target machine via HTTP.
The resulting installation and configuration (including the autodiscovery of managed targets on the Management Agent host) is identical to that provided by the Management Agent install on the Enterprise Manager CD set.
You can edit the contents of the agentDownload script so it uses a specific tool for transferring files from the Management Service Web server. The contents of the file contain instructions for doing so as shown below:
WGET="/usr/local/bin/wget --dot-style=mega --verbose --tries=5" InstallerDownloadCmd=$WGET # Define the command to be used to download the jarred installer from # the web server hosting the OMS. # Other download possibilities: ftp; cp/scp; use local browser to save # the link to a file on the target machine. # This example uses wget, a GNU tool for http and ftp file transfers. # If the products.jar referenced by the Oracle Installer is a URL, # then the Installer will download its files via http. This greatly # facilitates performing installs in a secure environment that may # include firewalls and servers with limited access (no ftp server, # NFS mounts not available, etc.). # Enterprise Manager version number. This is used to construct the # home name used by the installer EmVersion=400