Oracle® Enterprise Manager Grid Control Advanced Installation and Configuration Guide 11g Release 1 (11.1.0.1.0) Part Number E16847-10 |
|
|
PDF · Mobi · ePub |
This chapter explains how you can install Oracle Management Agent (Management Agent) using the agentDownload
script. In particular, this section covers the following:
The agentDownload script is a script that helps you install Management Agents on destination hosts, silently without having to use the GUI screens of Enterprise Manager Grid Control. The script is available on the source host where Oracle Management Service (OMS) is installed, and it is run from the destination host where the Management Agent needs to be installed.
This installation type is best suited when you want to install additional Management Agents on the destination hosts, from the destination hosts itself without having to access the source host, and without having to use the Enterprise Manager Grid Control console.
The following are the basic differences between Agent Deployment Wizard and agentDownload Script.
While the Agent Deployment Wizard is GUI-based, the agentDownload script is script-based. Therefore, using the script is a silent, non-GUI way of installing Management Agents.
While the Agent Deployment Wizard can be run from a source or destination host, the agentDownload script must be run only from a destination host.
While the Agent Deployment Wizard enables you to install multiple Management Agents at a time, the agentDownload script enables you to install only one Management Agent at a time.
The Agent Deployment Wizard pushes the software binaries from a central source location to the destination hosts. The agentDownload script pulls the software binaries from the source host to the destination hosts.
Before installing the Management Agent, ensure that you meet the following prerequisites.
If you want, you can print out this section and write 'Yes' or 'No' against each prerequisite. This will help you to track the prerequisites you have met and the prerequisites you have not met.
Table 13-1 Prerequisites for Installing Oracle Management Agent Using agentDownload Script
Requirement | Description | Yes/No |
---|---|---|
Hardware Requirements |
Ensure that you meet the hard disk space and physical memory requirements as described in Appendix A, "Meeting Hardware Requirements". |
|
Operating System Requirements |
Ensure that you install the Management Agent only on certified operating systems as mentioned in My Oracle Support note 412431.1. |
|
Package Requirements |
Ensure that you install all the platform-specific packages as described in Appendix B, "Meeting Package, Kernel Parameter, and Library Requirements ". |
|
User and Operating System Group Requirement |
Ensure that the destination host where you want to install the Management Agent has the appropriate users and operating system groups created. For information about creating operating system groups and users, see Appendix C, "Creating Operating System Groups and Users Requirements". |
|
Software Availability Requirements |
By default, the software for Oracle Management Agent 11g Release 1 is available on the host where Oracle Management Service 11g Release 1 is running. Note that this Management Agent software is for the platform on which the OMS is running. Therefore, if you want to install Oracle Management Agent 11g Release 1 on a platform that is the same as the one on which the OMS is running, then you already meet this prerequisite; you do not have to take any action. However, if you want to install Oracle Management Agent 11g Release 1 on a platform that is different from the one on which the OMS is running, then ensure that you download the Management Agent software for that platform. For more information about downloading the Management Agent software, see Procuring Oracle Management Agent Software. |
|
OMS Requirements |
Ensure that you already have an OMS running in your enterprise because the agentDownload script needs to be downloaded from the OMS host. |
|
Temporary Directory Space Requirements |
Ensure that you allocate 400 MB of space for a temporary directory where the executables can be copied. For example, |
|
Central Inventory Requirements |
Ensure that you allocate 100 MB of space for the central inventory directory. Also ensure that the central inventory directory is not on a shared file system.If it is already on a shared file system, then switch over to a non-shared file system by following the instructions outlined in My Oracle Support note 1092645.1. |
|
Installation Base Directory Requirements |
Ensure that the Installation Base Directory is writable and is empty. |
|
Destination Host Requirements |
Ensure that all the destination hosts have the same operating system credentials and file system structure. |
|
|
If the destination host and the host on which OMS is running belong to different network domains, then ensure that you update the For example, if the fully-qualified host name is
|
|
|
Ensure that the For example, if you want to run the script on a Linux host, then ensure that the script available on the OMS host is a script for Linux operating system. |
|
|
Ensure that the execute binary is set and the script file has proper file-protection settings. You can use chmod to ensure the file has the correct privileges. |
|
Load Balancer Requirements |
If the OMS is using a load balancer, you must modify the |
|
Wget Defined in the agentDownload Script |
Ensure that the wget software has been defined in the agentDownload script. The script checks for the existence of wget in If wget is not found in these locations, then it must be included in the $PATH or the script will exit with an error. |
|
Environment Variable Settings |
Ensure that the Alternatively, you can secure the Management Agent by running the following command from the Oracle home of the Management Agent:
|
|
Installing User Requirements |
If the central inventory owner and the user installing the Management Agent are different, then ensure that they are part of the same group. Also ensure that the inventory owner and the group to which the owner belongs have read and write permissions on the inventory directory. For example, if the inventory owner is user1, and user installing the Management Agent is user2, then ensure that user1 and user2 belong to the same group, and they have read and write access to the inventory. |
|
Permission Requirements |
|
|
Oracle Inventory Location Requirements |
Ensure that the Oracle Inventory ( |
|
SUDO Privilege Requirement |
Ensure that you have SUDO privileges to run To verify whether you have SUDO privileges to run these files, access the
|
|
SUDOERS File Configuration Requirements |
Ensure that you configure If |
To install a Management Agent using the agentDownload script, follow these steps:
Edit the SECURITY_UPDATES_VIA_MYORACLESUPPORT
and DECLINE_SECURITY_UPDATES
parameters in the following file that is available in the Oracle home of the OMS:
<ORACLE_HOME>/sysman/agent_download/agent_download.rsp
If you want to download and install security updates, then do the following:
Set the SECURITY_UPDATES_VIA_MYORACLESUPPORT
parameter to TRUE
.
Specify the credentials for the following parameters:
MYORACLESUPPORT_USERNAME
MYORACLESUPPORT_PASSWORD
Set the DECLINE_SECURITY_UPDATES
parameter to False
.
If you do not want to download and install security updates, then do the following:
Set the SECURITY_UPDATES_VIA_MYORACLESUPPORT
parameter to False
.
Set the DECLINE_SECURITY_UPDATES
parameter to TRUE.
On the destination host where you want to install the Management Agent, open a browser to access the OMS URL and download the agentDownload script.
UNIX Platform | Microsoft Windows Platforms |
---|---|
Using Browser
http://<oms_host>:<oms_port>/agent_download/<version>/<platform>/agentDownload.<platform> For example: http://host1.servers.com:4889/agent_download/11.1.0.0.0/linux/agentDownload.linux Using Command Line wget http://<oms_host>:<oms_port>/agent_download/<version>/<platform>/agentDownload.<platform> For example: wget http://host1.servers.com:4889/agent_download/11.1.0.0.0/linux/agentDownload.linux If you are using HTTPS protocol, then run the following command:
(wget 1.10 and higher versions support the option --no-check-certificate) |
Using Browser
http://<ons_host>:<oms_port>/agent_download/<version>/<platform>/agentDownload.vbs For example: http://host1.servers.com:4889/agent_download/11.1.0.0.0/win32/agentDownload.vbs Using Command Line wget http://<oms_host>:<oms_port>/agent_download/<version>/<platform>/agentDownload.vbs For example: wget http://host1.servers.com:4889/agent_download/11.1.0.0.0/win32/agentDownload.vbs |
Run the agentDownload script on the destination host using the following command. For other options you can use with the command, see Table F-1.
UNIX Platform | Microsoft Windows Platforms |
---|---|
./agentDownload.<platform> -b <absolute_path_to_installation_base_directory> -m <OMS_Host> -r <OMS_port>For example: ./agentDownload.linux -b /john/OracleHomes -m host1.servers.com -r 4889 |
cscript.exe agentDownload.vbs b <absolute_path_to_installation_base_directory> m <OMS_Host> r <OMS_port>For example: cscript.exe agentDownload.vbs b C:\scratch\OracleHomes m host1.servers.com r 4889 |
Note:
If the installation fails, then review the log files described in Appendix L, "Installation and Configuration Log Files".
If the installation base directory does not exist, then it is created during the installation. If it exists, then ensure that it is empty. If the variable is not set, then the script exits with an error.
After you install the Management Agent, follow these steps outlined in After You Install.