6 Deploying the Management Agent

Fresh Installation of the Management Agent

This option helps you perform a new installation of the Management Agent. The Agent Deploy application runs a prerequisite checker to ensure the environment meets the requirements for this installation type. See AppendixC, "Prerequisite Checks Executed by Agent Deploy" for more information.

To perform a new Management Agent installation, complete the following steps:

1. Select Fresh Install on the Agent Deploy application home page. The Installation Details screen appears.

2. In the Source Software section, select an installation source directory. This directory can either be the default directory that exists within the Oracle Management Service (OMS), for example <OMS_HOME>/sysman/agent_download/10.2.0.2.0/<platform>, or any other location where the software is available.

   Note:

   At the time of downloading the agent installation software, if the agentDownload.rsp file is overwritten, ensure the s_OMSHost and s_OMSPort values are specified correctly in the response file (agentdownload.rsp) before proceeding with the installation steps.

   See Chapter6, "Downloading 10.2.0.3.0 Agent Installation Software for Different Platforms" for more information on obtaining agent binaries for different platforms.

   To choose a location other than the default location from the Management Service, select Another Location, and specify the full path to the software location that you want to use.

   Note:

   Ensure that the path of the software location that you specify is accessible from all remote hosts.

   The application does not copy the software to the remote hosts, but will only access the software from the specified location.

   After you download the agentDownload software, unzip and extract its contents into a new directory. Rename this new <directory>/$<platform>/agent to <directory>/$<platform>/Disk1 and use the <directory>/$<platform> as the source software location.

   Caution:

   The additional parameters that you specify later in the installation process depend on the source software location that you select here.

   if you select the default software location, you must specify additional parameters that are supported by the agentDownload script. See Table D-1, "Parameters Supported by agentDownload Script" for a list of parameters supported by this script.

   If you select an alternative location, you must specify additional parameters that are supported by Oracle Universal Installer (OUI). See Table D-2, "Parameters Supported by Oracle Universal Installer" for a list of parameters supported by OUI.

   Figure 6-1 Source Software Section of the Installation Details Page

   
   

3. In the Version section on this screen, select the appropriate version of the agent that you want to install. The values available in this list will depend on the staged software that are available on the Management Service host.

4. Select the appropriate platform on which you want to perform this installation.

5. In the Hosts section, do the following:

   Figure 6-2 Hosts Section of the Installation Details Page

   
   

   1. Select the appropriate platform on which you want to perform this installation.

   2. In the Provide Host List text box, specify all the hosts (host names or IP addresses) on which you want to perform the agent installation. Alternatively, click Get Host Names From File to browse and select the file that contains a list of all the required host names.

      WARNING:

      Ensure you do not specify duplicate entries of the host list. If there are duplicate host entries in this list, the application hangs.

      Also ensure that you use the same host names for which the SSH has been set.

      Note:

      You can use either a comma (,) or a new line as a separator when specifying multiple hosts.

      Caution:

      The Agent Deploy application picks up only the values in the first column of the Host List file that you specify/select.

      Ensure the host list format is appropriate, because the Agent Deploy application does not validate this format on the selected file.

      A sample host list format is provided in Table 6-1, "Sample Host List Format".

      Note:

      For Enterprise Manager 10.2.0.1 and 10.2.0.2, use the ÒPopulate DetailsÓ button to populate the cluster node list or provide a comma-separated list.

      Table 6-1 Sample Host List Format

      Fully Qualified Host Name	Host Name	Host IP Address
      host1.foo.com	host1	154.87.3.229
      host2.foo.com	host2	154.87.3.109
      host3.foo.com	host3	154.80.5.218

      
      

   3. Select Cluster Install if you want to install the Agent on a cluster.

   4. In the Cluster Node List text box, specify the cluster nodes. Alternatively, click Populate Defaults to populate this text box with all the host names that you had selected in step b.

      Note:

      The node names that you specify here are the machine short names.

      If you have set up the cluster over a vendor clusterware, the node names can be different from the machine names.

      You can confirm the node names by executing olsnodes from the <Oracle Clusterware home> on one of the cluster nodes. If you are using Oracle Cluster release 9.2, confirm the node names by executing lsnodes from the cluster Oracle home.

      See Chapter8, "Installing the Agent on Oracle Clusterware" for more information.

   5. In the Cluster Name text box, specify a unique cluster name. If you are extending a cluster, specify the existing cluster name here. The cluster name that you specify here identifies that cluster in the Grid Control console.

      Note:

      When you select the cluster installation option, Agent Deploy performs the agent installation only on those cluster nodes that you have specified, irrespective of the number of hosts that make up that cluster.

      For example, if you choose to perform a cluster installation on a cluster having 10 nodes, but specified only 5 nodes, Agent Deploy installs the agent only on the 5 nodes of the cluster that you have specified.

      If you are extending an existing cluster, ensure that the cluster name you specify is the same as the existing cluster. You must also specify all the nodes of the existing cluster along with the new node on which you are installing the cluster agent.

6. In the OS Credentials section, specify the appropriate operating system user credentials. Select Run root.sh (on UNIX machines only) if you want Agent Deploy to execute this script.

   Figure 6-3 OS Credentials Section of the Installation Details Page

   
   

   Note:

   The root.sh script executes after the configuration assistants are run, and before executing postinstallation scripts (if any).

   If you do not select this option here, you must manually run root.sh on each node.

   Agent Deploy uses sudo to run this script. You must specify the invoking user's password here. You must also ensure that the targetpw is not set in the /etc/sudoers file.

   Note:

   The OS credentials that you specify here must be the same for all the selected hosts.

7. In the Destination section, specify the absolute path for the Installation Base Directory. This directory is created on all the specified hosts, and the Agent Oracle home directory is created as a subdirectory under this directory.

   Note:

   For the Agent push to be successful, ensure that you extract the agentDownload kit before performing the Agent push.

   Figure 6-4 Destination Section of the Installation Details Page

   
   

   Note:

   Ensure you have write permissions on the installation Base Directory that you specify.

8. Specify the port on which the Agent will communicate. The default port value for 10.2 Management Agent is 3872.

   Figure 6-5 Port Section of the Installation Details Page

   
   

   Note:

   If the port that you specify is not available, you are prompted to specify an alternative port. If you do not specify a port here, the Agent Deploy application automatically picks up a free port (3872 or in the range of 1830 - 1849).

9. In the Additional Parameters text box, specify any additional parameters that you want to pass during installation.

   Figure 6-6 Additional Parameters Section of the Installation Details Page

   
   

   Caution:

   The additional parameters that you specify here depend on the software source location that you have selected.

   • Default Management Service Location: If you have selected the default software source directory, the additional parameters that you specify must be supported by the agentDownload script, as the Agent Deploy application uses the agentDownload.<platform> script to perform the installation. See Table D-0, "Additional Parameters Supported by agentDownload Script" for a list of all the parameters supported by the agentDownload script.

   • Another Location: If you have selected an alternative software location, the additional parameters that you specify must be supported by Oracle Universal Installer (OUI), as Agent Deploy then uses OUI to perform the installation. See Table D-1, "Additional Parameters Supported by Oracle Universal Installer" for a list of parameters supported by OUI.

   Note:

   If the same parameters that you specify here are also specified independently (from the command-line option), the value of the parameters that you specify here take precedence over the other.

   For example, if the installation base directory is specified independently, and -b option is specified here, the latter value (-b) is used in the installation.

   The important parameters for Agent Installation are -b, -c, -n, -z and optionally -i, -p, -t, -d.

10. Specify the Management Service Registration Password if you want to secure communications between the agent and Management Service. Alternatively, the super administrator can approve the addition of new agents to Enterprise Manager after the installation is complete.

    Figure 6-7 Management Server Security Section of the Installation Details Page

    
    

    Note:

    An unsecure agent cannot upload data to the secure Management Service. Oracle also recommends for security reasons that you change the Management Service password specified here after the installation is complete.

11. In the Additional Scripts section, specify any preinstallation and/or postinstallation scripts that you want to execute.

    Figure 6-8 Additional Scripts Section of the Installation Details Page

    
    

    Select Run as Superuser if you want to run these scripts as root.

    Note:

    The preinstallation and/or postinstallation scripts that you specify must be available on all the hosts. These files are not copied onto the hosts from the software source location during installation.

12. Click Continue to start the installation process. As part of this process, Agent Deploy performs some prerequisite checks before proceeding with the installation. When all the prerequisite checks are complete, the application displays the results. You can choose to either retry the prerequisite check on all those failed hosts, or ignore the result and proceed to install the Agent.

    Note:

    After the installation and configuration phase, the Agent Deploy application checks for the existence of the Central Inventory (located at /etc/oraInst.loc). If this is the first Oracle product installation, Agent Deploy executes the following scripts:

    1. orainstRoot.sh - UNIX Machines only: This creates oraInst.loc that contains the central inventory.

    2. root.sh - UNIX Machines only: This runs all the scripts that must be executed as root.

    If this is not the first Oracle product installation, Agent Deploy executes only the root.sh script.

Installation Using a Shared Agent Home

To deploy and install an agent on multiple hosts using an existing Shared Agent Installation, you must have already performed a complete Enterprise Manager product installation (including the agent). Another prerequisite when using this option is that the directory where the agent is installed should be NFS-mounted, meaning the directory must be a shared location on all remote hosts.

The Agent Deploy application runs a prerequisite checker to ensure the environment meets the requirements for this installation type. See AppendixC, "Prerequisite Checks Executed by Agent Deploy" for more information.

Concepts and Prerequisites

The following sections briefly discuss the shared agent home concepts, and also list the prerequisites before starting the installation.

Performing the Installation

To perform a new Management Agent installation:

1. Select Shared Agent Home on the Agent Deploy application home page. The Installation Details screen appears.

2. In the Hosts section:

   Figure 6-9 Hosts Section of the Installation Details Page

   
   

   1. Select the appropriate Platform on which you want to perform this installation.

   2. In the Provide Host List text box, specify all the hosts (host names or IP addresses) on which you want to perform the Agent installation. Alternatively, click Get Host Names From File to select the file that contains a list of all the required host names.

      WARNING:

      Do not specify duplicate entries of the host list. If there are duplicate host entries in this list, the application hangs.

      Use the same host names for which the SSH has been set.

      Note:

      You can use a comma (,) or just white space as a separator when specifying multiple host names.

      Caution:

      If the Installation Base Directory is shared among the hosts that you have specified in the host list, the installer is invoked from one of these hosts (typically, the first host in that list).

      While the installation is performed on only one host, the application executes the configurations on all nodes in the list. That is, the preinstallation, postinstallation, and collect logs are executed on all the nodes.

      After the installation is complete, the Installation Status screen displays the status of only this host (from which the installer was invoked). It may not necessarily list the status of all the hosts specified in the host list.

3. In the OS Credentials section:

   Figure 6-10 OS Credentials Section of the Installation Details Page

   
   

   1. Specify the appropriate operating system user credentials.

   2. Select Run root.sh (on UNIX machines only) if you want Agent Deploy to execute this script. Agent Deploy uses sudo to run this script. You must specify the invoking user's password here. You must also ensure that the targetpw parameter is not set in the /etc/sudoers file.

   Caution:

   If you do not want to execute the scripts as root during the installation, ensure you run these scripts manually before performing any other installation on that machine.

   Note:

   The OS credentials that you specify here must be the same for all the selected hosts.

4. In the Destination section:

   Figure 6-11 Destination Section of the Installation Details Page

   
   

   1. Specify the complete path to the NFS Agent Location. This is the shared directory location on the source agent host that must be visible (NFS-mounted) from all remote hosts.

   2. Specify an appropriate EMState Directory Location. This is a directory for storing configuration files such as emd.properties, targets.xml, log files, and so on, on each host. Every host that shares the agent has its own EMSTATE directory.

5. In the Port section, specify the appropriate port on which the agent will communicate. This is a mandatory field.

   Figure 6-12 Port Section of the Installation Details Page

   
   

   Note:

   If the port that you specify is busy (not available), you are prompted to specify an alternative port. If you do not specify a port value here, the installation will fail.

6. In the Additional Parameters section, specify the parameters that you may want to pass during installation. You can specify multiple parameters, separated by a space.

   Note:

   Besides the timezone parameter (-z), you can also specify all the parameters that are supported by the agentDownload script. See AppendixD, "Additional Parameters Supported by agentDownload Script" for more information.

7. In the Management Server Security section:

   Figure 6-13 Management Server Security Section of the Installation Details Page

   
   

   Specify the Management Service Registration Password if you want to secure communications between the Agent and Management Service. Alternatively, the super administrator can approve the addition of new agents to Enterprise Manager after the installation is complete.

   Note:

   An unsecure agent cannot upload data to the Management Service. Oracle also recommends for security reasons that you change the Management Service password specified here after the installation is complete.

8. In the Additional Scripts section:

   Figure 6-14 Additional Scripts Section of the Installation Details Page

   
   

   1. Specify any preinstallation and/or postinstallation scripts that you want to execute. These scripts are optional. If you do not want to customize your installation, leave these fields blank and continue.

   2. Click Continue to start the installation process.

      Caution:

      If the shared agent is the first Oracle product that is installed on the host, you must execute the following command from the EMSTATE directory after completing the installation:

      <EMSTATE Dir>/bin 
      ./emctl control agent runCollection <Host name>:host Inventory
      

      As part of this process, Agent Deploy 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 one of the following messages:

   • Warning: If there are warnings against certain prerequisite checks, you may choose to ignore these and continue with the installation (though this is not recommended).

   • Failed: If there are failed prerequisite checks, you cannot continue with the installation. A recommended course of action is to fix the failed prerequisites before proceeding with the installation.

   To fix the failed prerequisites, you can either click Retry, or go to the Fixup screen of the application. The Fixup screen displays the prerequisites that can be automatically fixed, and those that require manual fixes.

User Credentials

The shared agent (nfsagent) can be installed only with the same user credentials that were used to perform the master agent installation.

If Agent Is Not the First Oracle Product Installation

If this shared agent installation is not the first Oracle product installation and your home directory (of the master agent installation) is shared, you must verify the oraInst.loc location under the /etc directory.

If oraInst.loc and inventory_loc are located in the your home directory, you must change this entry point to a non-shared location.

The oraInst.loc entry should look like this:

inventory_loc=/<any location other than the home directory>/oraInventory
inst_group=<group to which the user belongs>

Usage of the nfsagentinstall Script

./nfsagentinstall  -s <EMSTATE Directory location> -p <port number>

In the preceding command syntax,

• <EMSTATE Directory location> is the full path where you want the state directory to be created by the script.

• <port number> is the port on which the agent runs.

  Note:

  Specifying the <port_number> argument is optional. If you do not specify the port number, the script will automatically select the next available port from that host.

<EMSTATE Dir>/bin 
./emctl control agent runCollection <Host name>:host Inventory

Cluster Installation

The agentDownload script can be used to install Management Agents onto clustered environments. In order to perform this type of installation, the command-line options to be used are listed in Table 6-2.

For example, to use the agentDownload script to install a Management Agent on just the local node of a cluster that consists of nodes host1, host2, and host3, with cluster name myCRS, you must execute the following:

./agentDownload.<platform> -b <name of the Oracle Homes> -m <fully-qualified Oracle Management Service host name> -r <Oracle Management Service ports> -c "host1,host2,host3" -n myCRS -l

For example for Linux operating system, the command would be as follows:

./agentdownload.linux - b /oracle/agentinstall -m foo.us.oracle.com -r 4889 -c "host1,host2,host3" -n myCRS -l

Script Details

The agentDownload script performs the following actions:

• Creates home directories for the Management Agent and Oracle Universal Installer if they do not exist, based on the $ORACLE_HOME path specified through the command line.

• Downloads the agent_download.rsp response file from the Management Service Web server.

  The Management Service instantiates the response file with the name and port number of the Management Service. As a result, the Management Agent you install is configured to use the Management Service from which the response file was downloaded.

• Downloads an Oracle Universal Installer JAR file for the target operating system from the Management Service Web server (for UNIX only).

• Extracts Oracle Universal Installer and points it to the product definition file (products.xml) hosted by the Management Service Web server.

• Starts Oracle Universal Installer in silent mode from the local machine; Universal Installer pulls files from the Web server to the target machine via HTTP.

  Note:

  This script uses the -ignoresysPrereqs flag to bypass prerequisite check messages for operating system-specific patches during installation; prerequisite checks are still performed and saved to the installer logs. While this makes the Management Agent easier to deploy, check the logs to make sure the target machines on which you are installing Management Agents are properly configured for successful installation.

• The resulting installation and configuration, including the automatic discovery of managed targets on the Management Agent host, is identical to that provided by the Management Agent installation on the Enterprise Manager DVD set.

• The agentDownload script creates a log file in the base directory that is specified using the -b option.

• At the end of a successful installation, the Agent starts and should begin successfully uploading to the Management Service, presuming automatic discovery and automatic start were not disabled at the command line.

To run the script, use the following command:

./agentDownload.<platform> [-bcdhilmnoprtuxN]

For Linux operating system, the command would be as follows:

./agentDownload.linux [-bcdhilmnoprtuxN]

The descriptions of the script options are listed in Table 6-3.

Customizing the agentDownload Script

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 in the following example:

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

GNU wget is available for most platforms and can be downloaded from the following location:

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