This chapter describes how you can install Oracle Management Agents (Management Agent) with the help of a central, shared Oracle home location of an existing Oracle Management Agent (Management Agent).
Note:This installation method is not supported on Solaris Express 5.11 x86-64 and Solaris SPARC Express 5.11 (64 bit). To install Oracle Management Agents on these operating systems, follow the silent method mentioned in Part III, "Installing Oracle Management Agent".
If you want to install additional Management Agents on hosts that share a mounted drive where a Management Agent is already installed, then the best option is to use the software binaries of the shared Oracle home from that mounted drive and configure the remote hosts to be managed by that Management Agent, thus capitalizing on the network visibility and saving hard disk space on the remote hosts. You can achieve this by using the Shared Agent Deployment Wizard, which is a GUI-rich, interactive wizard built into Enterprise Manager Grid Control.
The Shared Agent Deployment Wizard uses the software binaries from the shared Oracle home, and configures an
EMSTATE directory on each of the remote hosts for storing configuration files such as
log files, and so on. For more information about the
EMSTATE directory, see What Is EMSTATE Directory?.
The Management Agent that shares its software binaries, in this context, is called the Master Agent, and the one that is configured with an
EMSTATE directory on the remote host is called the Shared Agents or NFS Agents. Technically, the Shared Agent Deployment Wizard does not install a Management Agent; it only uses the software binaries from the shared Oracle home and configures an
EMSTATE directory on each of the remote hosts.
Much like the Agent Deployment Wizard, the Shared Agent Deployment Wizard also can be used for installing multiple Management Agents, as a mass deployment. The only difference here is that the Shared Agent Deployment Wizard does not actually install Management Agents on the destination hosts, but it configures those remote hosts to use the software binaries from the shared, already-installed Management Agent location, and hold only the configuration files. The configuration files can be
targets.xml, log files, and so on. The location on a host where the configuration files are placed is called
Before you begin, keep these points in mind:
You can install only on UNIX-based platforms.
You CANNOT use a shared Oracle home of a Management Agent to install a Management Agent on a cluster. If you want to install a Management Agent on a cluster, follow the instructions outlined in Chapter 9, "Installing Oracle Management Agent on a Cluster Using Agent Deployment Wizard".
Navigate to the following location in the Oracle home of the OMS:
Change the value of
oracle.sysman.prov.agentpush.step2 to "false", that is
If you want to view the status of an installation or upgrade session that was previously run, click Agent Installation Status in the Deployments screen. However, do not attempt to view the installation status until the installation is complete. If you do, you will see an error.
For accessing the Enterprise Manager Grid Control console, ensure that you use only certified browsers as mentioned in My Oracle Support note 412431.1.
Before installing the Management Agent using a shared Oracle home, 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.
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 only on certified operating systems as mentioned in the Enterprise Manager Certification Matrix available on My Oracle Support.
To access this matrix, follow these steps:
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".
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.
EMSTATE Directory Requirements
Ensure that the EMSTATE directory you specify is empty and has write permission.
Existing Management Agent Software Requirements
Ensure that you install a Management Agent (Master Agent) on the shared, mounted location.
To install a Management Agent on the shared, mounted location, you can use any of the other Management Agent Deployment methods described in this guide.
Existing Management Agent Status Requirements
Ensure that the existing Management Agent (Master Agent) on the shared, mounted location is shut down always and not used for monitoring any targets. This installation is purely for sharing the software binaries with the Shared Agents.
If the shared Management Agent is not the first Oracle product installation but its Oracle home is shared, then ensure that you verify the
Software Availability Requirements
Although the installation actually is done using a shared Oracle home of an installed Management Agent that might be running on a different host, the Shared Agent Deployment Wizard uses some scripts and files that are available in the Management Agent software package. Therefore, you are expected to maintain a copy of the Management Agent software for the required platform on the OMS host.
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.
Shared Oracle Home Requirements
Ensure that the shared, mounted location is accessible from all destination hosts where you want to install additional Management Agents.
Path Validation Requirements
Validate the path to all command locations. For more information, see Appendix E, "Validating Command Locations".
Destination Host List Requirements
Ensure that you identify the hosts where you want to install the Management Agent. Otherwise, maintain a host list file that contains a list of hosts as described in What Is a Host List File?.
Destination Host Credentials Requirements
Ensure that the destination hosts have the same operating system credentials and file system structure, including the following:
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
Preinstallation/Postinstallation Scripts Requirements
Ensure that the preinstallation and postinstallation scripts that you want to run along with the installation are available on all the destination hosts.
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.
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 /etc/sudoers file so that while running a command using SUDO, you are always prompted for a password.
If /etc/sudoers file is configured in such a way that SUDO never prompts for a password, then a directory with the host password as the title gets created in the invoking users home directory.
Default SSH Port Requirements
Ensure that the SSH daemon is running on the default port (that is, 22) on all the destination hosts.
If the port is a non-default port, that is, any port other than 22, then update the SSH_PORT property in the following file present in the OMS Instance Base location:
PubkeyAuthentication Parameter Requirements
Ensure that the
To verify the value of this parameter, run the following command:
grep PubkeyAuthentication /etc/ssh/sshd_config
The result of this command must be Yes. If the result is No, then edit the
To install a new Management Agent using a shared Oracle home of a Management Agent, follow these steps:
In Grid Control, click Deployments.
On the Deployments page, from the Agent Installation section, click Install Agent.
On the following page, select Add Hosts to Shared Agent.
In the Hosts section, do the following:
From the Platform list, select the platform (operating system) on which you want to install the Management Agent.
For Provide Host List, specify the host names or IP addresses of the hosts on which you want to install the Management Agent.You can use a comma (,) or a white space as a separator when specifying multiple hosts.
Alternatively, if you already have a list maintained in a file, then click Get Host Names From File and select that file.
For information about host list file, see What Is a Host List File?.
In the OS Credentials section, do the following:
Specify the appropriate operating system user credentials of the destination hosts. The OS credentials that you specify here must be the same for all the selected hosts
Select Run root.sh (on UNIX machines only) if you want the application to run this script.
root.sh script runs after the configuration assistants are run and before the postinstallation scripts (if any) are run. If you do not select this option here, you must manually run
root.sh on each node.
In the Destination section, do the following:
For NFS Agent Location, specify the complete path to the shared, mounted, shared directory where the Management Agent software is available. This location must be visible on all remote hosts.
For State Directory Location, specify the complete path to an appropriate EMSTATE directory for storing configuration files such as
log files, and so on, on each host. Every host that shares the Management Agent has its own
For information about EMSTATE directory, see What Is EMSTATE Directory?.
In the Port section, specify the appropriate port on which the Management Agent will communicate.
Note:Ensure that the port you specify is not busy, otherwise the prerequisite check fails. If you do not specify a port here, then the Agent Deploy application automatically picks up a free port (3872 or in the range of 1830 - 1849).
In the Additional Parameters section, do not specify any value.
In the Management Server Security section, specify the Management Service Registration Password if you want to secure communications between the Shared Agent and the OMS. This password is mandatory if the Master Agent is secure. Alternatively, the super administrator can approve the addition of new agents to Grid Control after the installation is complete.
Note:If the OMS is secure in a locked state, then only secure Management Agents can upload data to the OMS.
In the Additional Scripts section, do the following:
Specify any preinstallation and/or postinstallation scripts that you want to run. These scripts are optional. If you do not want to customize your installation, leave these fields blank and continue.
Select Run as Superuser if you want to run these scripts as
As part of this process, the application performs some prerequisite checks before proceeding with the installation. When all the prerequisite checks are complete, the application displays the results. The results include the name, type, and status for all prerequisite checks designed for the installation.
Besides the successfully run prerequisite checks, the prerequisite checks can return either Warning or Failed status messages. For these status messages, you may choose to ignore and continue with the installation (though this is not recommended).
To fix the failed prerequisites, you can either click Retry. The Fixup screen displays the prerequisites that can be automatically fixed, and those that require manual fixes.
Note:If the installation fails, then review the log files described in Appendix L, "Installation and Configuration Log Files".
After you install the Management Agent, do these:
The targets that were already installed on the host before installing the Management Agent are automatically discovered in Enterprise Manager Grid Control. However, the new targets installed after installing the Management Agent are not automatically discovered. Therefore, if you install any new target, and if you want to discover and monitor it in Enterprise Manager Grid Control, then run the
agentca script from the