Oracle® Enterprise Manager

About agentDownload Script

The agentDownload script uses pull technology. That is, 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 to install the Management Agent. Because the installation is scripted, it is possible to use a wrapper script, cron job, rdist, or a combination of operating system features to fully automate this process for mass deployments.

Benefits of the agentDownload Script

The download script deploys the standard Management Agent installation with some additional benefits:

• Can be modified for specific user environments.

• Non-interactive, silent, installations.

• 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.

• Simplifies deploying Management Agents in secure Web environments that are configured to provide HTTP access.

• Provides useful install options via the command line (including the ability to control target auto-discovery, auto-starting of the agent, and so on).

• Allows installation onto clustered environments. See the Cluster Installation section for more information.

Obtaining the agentDownload Script

The downloadable Agent software for the operating system of the OMS platform is available from inside an installed Oracle Management Service Oracle home, and from the following Oracle Technology Network Web site under Mass Agent Deployment:

http://www.oracle.com/technology/software/products/oem/htdocs/agentsoft.html

There is a separate downloadable agent for each operating system platform. See Uploading Agent Installation Software for Different Platforms for more information on obtaining agent installables for different platforms.

Using the agentDownload Script

In use, the agentDownload script is downloaded to a target node and executed to initiate a silent Oracle Universal Install session. The agent files are copied from the staging area in the OMS home to the target node via HTTP.

To deploy multiple Management Agents using the agentDownload script, you must do the following:

1. Install the Oracle Management Service.

   Install the Management Service using the Oracle Universal Installer. The Management Service is installed and deployed into its own Oracle Application Server home directory.

   See Also:

   For more information about the directory structure of a typical Management Service installation, see Oracle Enterprise Manager Advanced Configuration.

2. The download stage for the Management Service platform is installed with the Management Service. For example, for Linux operating systems, the download stage can be found in:

   OMS_HOME/sysman/agent_download/<version>/linux
   
   

   • The agentDownload script is located at OMS_HOME/sysman/agent_download/<version>/<platform>

     For example, for Enterprise Manager 10g R4, the <version> value in the above syntax will be 10.2.0.4.0.

   • The readme file is available at OMS_HOME/sysman/agent_download/agent_install_readme.html.

   Important:

   If the Management Service is using a load balancer, you must modify the OMShost and httpPort values in the download script file to reflect the load balancer host and port before using the agentDownload script.

3. 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 Oracle Application Server home directory where the Management Service is installed and deployed. 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/<version>/<platform>
   
   

   Note:

   Port 4889 is the default port for Grid Control. This should be available after you install the Management Service.

   Using this Web server alias, you can download the script to the target host computer using the following URL. Save the script locally as agentDownload.

   http://mgmthost27.acme.com:4889/agent_download/<version>/<platform>/agentDownload.<OS>
   
   

   Where OS represents the operating system platform. For example, for Linux operating systems, the script is named agentDownload.linux. For Enterprise Manager 10g R4, the <version> value in the above syntax will be 10.2.0.4.0.

   Any method of retrieving the file is acceptable: cp, rcp, scp, FTP, and so on. The script can also be retrieved by launching a browser on the target machine and saving the link to a local file.

   Note:

   If you opt to perform the installation using a file-based protocol rather than HTTP, you need to modify the $AgentDownload URL variable in the script to access the file system on the Management Server host instead of a URL.The URL:

   http://${OMShost}:${httpPort}/agent_download/
   
   

   is a Web alias for:

   $OMS_HOME/sysman/agent_download/
   

4. 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 base directory is specified at the command line. This will be the location of the Management Agent home on the target host. If the directory does not exist, it is created during the installation. If it exists, ensure it is empty. If the variable is not set, the script exits with an error.

     Note:

     The base directory for the agent installation must be specified using the -b option. For example, if you specified the parent directory to be agent_download (/scratch/agent_download), then the command to be specified is:

     -b /scratch/agent_download
     
     

     The agent Oracle home (agent10g) is created as a sub-directory under this parent directory.

   • The jar executable file is in the PATH environment variable. If the file is not found, the script exits with an error.

   • The wget (or other file transfer mechanism) has been defined in the script. The script checks for the existence of wget in /usr/local/bin/wget, followed by /usr/bin/wget. If wget is not found in either of those locations, then it must be included in the $PATH or the script will exit with an error.

   • The $AGENT_INSTALL_PASSWORD environment variable is set in the environment if the Management Agent is uploading to a secure Management Service.

     ATTENTION:

     The agent that you are installing is not secure by default. If you want to secure the agent, you must specify the password using the AGENT_INSTALL_PASSWORD environment variable, or by executing the following command after the installation is complete:

     <Agent_Home>/bin/emctl secure agent <password>
     

     See Also:

     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.

5. After the Management Agent installation is complete, change the 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 or with sudo privileges; otherwise, it exits and the Enterprise Manager job system will not be available. The job system is required for some Enterprise Manager features, such as hardware and software configuration tasks and configuring managed database targets.

./agentDownload.<platform> -b /scratch/agentInstall -c "host1,host2,host3" -n myCRS -l

./agentDownload.<platform> [-bcdhilmnoprstux]

./agentDownload.<platform> -b /scratch/agentInstall -c "host1,host2,host3" -n myCRS -l

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.xml 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

http://www.gnu.org/software/wget/wget.html

Uploading Agent Installation Software for Different Platforms

To obtain the agent download for other platforms, you must complete the following steps to make the Management Agent installable from the Management Service Oracle home.

For example:

To obtain the agentdownload for Linux:

1. Download the Linux_Grid_Control_agent_download_<version>.cpio.gz file from OTN:

   http://www.oracle.com/technology/software/products/oem/htdocs/agentsoft.html

   For example, for Enterprise Manager 10g R4, the <version> value in the above syntax will be 10.2.0.4.0 and the agentdownload file will be Linux_Grid_Control_agent_download_10_2_0_4.cpio.gz.

2. Copy the downloaded file to the <OMS_HOME>/sysman/agent_download/<version> directory.

   Note:

   Create the <OMS_HOME>/sysman/agent_download/<version> directory, if it does not exist.

3. Go to this directory by executing the following:

   cd <OMS_HOME>/sysman/agent_download/<version>
   
   

   For example, for Enterprise Manager 10g R4, the <version> value in the above syntax will be 10.2.0.4.0. When you are here, confirm that the size and checksum calculation of the downloaded file match the information specified on the OTN download page.

4. Run gunzip by executing the following:

   gunzip Linux_Grid_Control_agent_download_<version>.cpio.gz
   
   

5. Execute the following command to extract the archive:

   cpio -idcmv < Linux_Grid_Control_agent_download_<version>.cpio
   
   

6. Edit the <OMS_HOME>/sysman/agent_download/<version>/linux/agentDownload.linux file and modify OMShost=REPLACE_WITH_OMS_HOST and httpPort=REPLACE_WITH_OMS_PORT with the correct OMSHost and OMSPort.(Even if you are specifying a secure Management Service, you must still enter the non-secure port number here.) For example:

   OMShost=stadv26.us.oracle.com
   httpPort=4889
   

To obtain the agentdownload for Windows:

1. Download the Linux_Grid_Control_agent_download_<version>.zip file from OTN:

   http://www.oracle.com/technology/software/products/oem/htdocs/agentsoft.html
   
   

2. Copy the downloaded file to the <OMS_HOME>/sysman/agent_download/<version> directory.

   Note:

   Create the <OMS_HOME>/sysman/agent_download/<version> directory, if it does not exist.

3. Go to this directory by executing the following:

   cd <OMS_HOME>/sysman/agent_download/<version>
   
   

   When you are here, confirm that the size and checksum calculation of the downloaded file match the information specified on the OTN download page.

4. Unzip this file by executing the following:

   unzip Linux_Grid_Control_agent_download_<version>.zip
   
   

5. After unzipping, the agentdownload.vbs will be available at <OMSHOME>/sysman/agent_download/<version>/win32/agentdownload.vbs.

6. Download the agentDownload.vbs on the machine where you want to install the Management Agent.

7. Run agentDownload.vbs by executing the following:

   cscript.exe agentDownload.vbs (followed by the appropriate options to specify the OMS Oracle home and port)