7 Adding Additional Oracle Management Service

This chapter describes how you can install an additional Oracle Management Service (OMS) to your existing Enterprise Manager Cloud Control environment. In particular, this chapter covers the following:

• Overview

• Before You Begin

• Prerequisites

• Installation Procedure

• After You Install

Note:

This chapter describes how you can install an additional OMS in interactive, graphical mode. If you want to perform the same operation in silent way, then refer to the Oracle Enterprise Manager Cloud Control Advanced Installation and Configuration Guide.

Overview

Oracle Management Service (OMS) is one of the core components of Enterprise Manager Cloud Control that orchestrates with Oracle Management Agents (Management Agents) and Oracle Management Plug-Ins (plug-ins) to discover targets, monitor and manage them, and store the collected information in a repository for future reference and analysis.

When you install Enterprise Manager for the very first time, by default, the installer installs one OMS along with one Management Agent. While this default configuration suits smaller environments, typically in larger production environments, you may have the need to install additional OMSes to help reduce the load on a single OMS and improve the efficiency of the data flow.

Note:

You can have multiple OMSes and still connect to just one Oracle Management Repository (Management Repository).

The Add Management Service deployment procedure helps you meet such high-availability requirements. The deployment procedure offers a wizard that enables you to install an additional Oracle Management Service 12c by cloning an existing OMS that is running on an AdminServer host. The entire middleware home of the source OMS is cloned to the destination host. For information about the contents of the middleware home of an OMS, see Overview.

Figure 7-1 Add Additional OMS Deployment Procedure

Note:

If you are cloning the OMS from a complete Enterprise Manager installation, then the Management Agent that was installed with the Enterprise Manager system is not cloned to the destination host.

Before You Begin

Before you begin, keep these points in mind:

• You can clone only an existing, running Oracle Management Service 12c that is associated with an AdminServer host. The patches applied on the source OMS are automatically carried over to the cloned instance.

• You can clone only one OMS at a time and to only one destination host at a time. If you want to add multiple OMSes, then you must repeat the installation procedure on each host.

• You can clone only when the source host and the destination host are running on the same operating system and architecture. For example, if the source host is a Linux 32-bit host, then the destination host must also be a Linux 32-bit host. Similarly, if the source host is a Linux 64-bit host, then the destination host must also be a Linux 64-bit host.

• You must not install the additional OMS on an OCFS file system. This file system is not supported.

• You must not install the additional OMS on an NFS-mounted drive. Installing it on an NFS-mounted drive causes the Oracle HTTP Server to restart frequently, which in turn makes the OMS inaccessible. If you are forced to install on such a shared drive, then ensure that the OMS instance base directory (gc_inst) is created in a non-NFS-mounted location.

• You can find the OMS and Management Agent entries in the /etc/oragchomelist file for all UNIX platforms except HPUNIX, HPia64, Solaris Sparc.

  On HPUNIX, HPia64, Solaris Sparc platforms, the entries are present in /var/opt/oracle/oragchomelist.

Prerequisites

Table 7-1 lists the prerequisites you must meet before installing the OMS.

Table 7-1 Prerequisites for Adding an Additional Oracle Management Service

Requirement	Description
Hardware Requirements	Ensure that you meet the hard disk space and physical memory requirements as described in Chapter 2. If you have installed BI publisher on the source host, then ensure that you have 7 GB of additional hard disk space on the destination host, so a total of 14 GB.
Operating System Requirements	Ensure that you install Enterprise Manager Cloud Control 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: Log in to My Oracle Support, and click the Certifications tab. On the Certifications page, in the Certification Search region, from the Product list, select Enterprise Manager Cloud Control. From the Release list, select 12.1.0.1.0, and click Search. Ensure that the destination host (that is, the host on which you are installing an additional OMS) is running on the same operating system as that of the source host (that is, the host from where you are cloning the first OMS). Note: If you use Oracle Solaris 10, then ensure that you have update 9 or higher installed. To verify whether it is installed, run the following command: cat /etc/release You should see the output similar to the following. Here, s10s_u6 indicates that update 6 is already installed. Solaris 10 10/08 s10s_u6wos_07b SPARC
Package and Kernel Parameter Requirements	Ensure that you install all operating system-specific packages and set all kernel parameters as described in Chapter 3.
Operating System Groups and Users Requirements	Ensure that you create the required operating system groups and users as described in Chapter 4.
Existing Oracle Management Service Requirements	Ensure that Oracle Management Service 12c Release 1 is already installed and is available for cloning. Also ensure that the AdminServer on which the OMS is configured is up and running.
Existing Oracle Management Service Backup Requirements	Ensure that regular back-ups are scheduled for the existing Oracle Management Service 12c that you want to clone.
Existing High Availability Configuration Requirements	Ensure that you have met all Oracle-recommended high availability requirements in your environment. For more information, refer to the chapter on high availability requirements in the Oracle Enterprise Manager Cloud Control Administrator's Guide.
Existing Oracle Management Agent Requirements	Ensure that the destination host already has a Management Agent installed, and ensure that it is up and running. If this Management Agent was manually installed on the destination host, then ensure that the installation was completed by running the root.sh script. Otherwise, the Add Management Service deployment procedure will not be able to run some scripts that require root permission.
Temporary Directory Space Requirements on Source and Destination Hosts	Ensure that you have 4 GB of space on the source as well as the destination host for creating a temporary directory. If you have installed BI publisher on the source host, then ensure that you have 10 GB of space. The temporary directory created by default is ADD_MANAGEMENT_SERVICE_<TimeStamp>. The temporary directory on the source host is used for temporarily staging the files related to backup or cloning steps of the deployment procedure. The temporary directory on the destination host is used for temporarily staging the cloned image and other related files.
Shared Directory Space Requirements	If you choose to transfer the software and configuration files to a central, shared location, then ensure that you have 4 GB of space for that shared directory.
Middleware Home Location Requirement	On the destination host, a middleware home (absolute path) identical to the one on the source host is created, and then, the source OMS is cloned to that location. Ensure that this middleware home does not already exist on the destination host. For example, if the middleware home on the source host is /home/john/Oracle/Middleware, ensure that the same path does not already exist on the destination host.
Oracle Management Service Instance Base Location Space Requirements	Ensure that you have 1 GB of space on the destination host for the Oracle Management Service Instance Base directory where the configuration files of the OMS will be created.
Server Load Balancer Requirements	Ensure that you have installed a Server Load Balancer (SLB) in your network and configured it to work with the first OMS. All Management Agents communicating with the first OMS must be uploading data only via this SLB. If you have not configured the SLB yet to work with the first OMS, then configure it now. For information about configuring an SLB, refer to the chapter on high availability requirements in the Oracle Enterprise Manager Cloud Control Administrator's Guide. In order to configure your OMSes in an active/active configuration behind an SLB, your SLB must meet the following requirements: (a) Supports multiple virtual server ports - Enterprise Manager typically requires that up to 4 ports are configured on the SLB (Secure Upload, Agent Registration, Secure Console, Unsecure Console). (b) Supports persistence - HTTP and HTTPS traffic between the browser and the OMS requires persistence. (c) Supports application monitoring - The SLB must be capable of monitoring the health of the OMSes and detecting failures, so that requests will not be routed to OMSs that are not available.
SLB Pools and Their Association with the First OMS	On the SLB, using its administration console, create the following SLB pools and add the first OMS host to them: Secure Upload Pool (add the host using the port configured for the Secure Upload service) Agent Registration Pool (add the host using the port configured for the Agent Registration service) Secure Console Pool (add the host using the port configured for the Secured Console service) (Optional) Unsecure Console Pool (add the host using the port configured for the Unsecured Console service)
Virtual Servers and Their Association with the SLB Pools	On the SLB, using its administration console, create the following virtual servers and associate them with the SLB pools. Secure Upload Virtual Server with port 1159 (associate it with Secure Upload Pool) Agent Virtual Server with port 4889 (associate it with Agent Registration Pool) Secure Console Virtual Server with port 443 (associate it with Secure Console Pool) (Optional) Unsecure Console Virtual Server with port 80 (associate it with Unsecure Console Pool)
SLB Monitors and Their Association with the First OMS	On the SLB, using its administration console, create the following SLB monitors and associate the first OMS host with them: Secure Upload Monitor (associate the host using the port configured for the Secure Upload service) Agent Registration Monitor (associate the host using the port configured for the Agent Registration service) Secure Console Monitor (associate the host using the port configured for the Secured Console service) (Optional) Unsecure Console Monitor (associate the host using the port configured for the Unsecured Console service)
Software Library Accessibility Requirements	Ensure that the directories where you have configured the Software Library are accessible (read/write) from the destination hosts.
Installing User Requirements	Ensure that you meet the following requirements: (For UNIX only) The installation must NOT be run by a root user. (For Microsoft Windows only) User must be part of the ORA-DBA group and have administrator permissions. (For Microsoft Windows only) User must belong to the DBA group, and have permissions to perform the following: Act as part of the operating system, Create a token object, Log on as a batch job, and Adjust memory quotas for a process. To verify whether the agent user has these rights, from the Start menu, click Settings and then select Control Panel. From the Control Panel window, select Administrative Tools, and from the Administrative Tools window, select Local Security Settings. In the Local Security Settings window, from the tree structure, expand Local Policies, and then expand User Rights Assignment.
Permission Requirements	Ensure that you are able to access and read/write in the following locations: Oracle Middleware Home Oracle Middleware Home is a directory on the source host that contains the OMS you are cloning, the Oracle WebLogic Server home, the Web tier instance files, and so on. Oracle Management Service Instance Base location Oracle Management Service Instance Base is a directory on the source host that contains configuration files related to the OMS. The instance base is typically under the parent directory of the middleware home. Source Staging location Source staging location is a location on the source host that is used for staging the cloned ZIP files before copying them to the destination host. Destination Staging location Destination staging location is a location on the destination host that is used for staging the cloned ZIP files when they are copied over from the source host. Temporary directory on the source host where the executables will be copied. For example, /tmp or c:\Temp.
Proximity Requirements	Ensure that the host on which the OMS is being installed and the host on which the Management Repository is being configured are located in close proximity to each other. Ideally, the round trip network latency between the two should be less than 1 millisecond.
Firewall Requirements	If you have a firewall in your environment, then refer to the chapter on configuring Enterprise Manager for firewalls in the Oracle Enterprise Manager Cloud Control Advanced Installation and Configuration Guide.
Unique Host Name and Static IP Address Requirements	Ensure that you check the network configuration to verify that the host on which you are installing resolves to a unique host name and a static IP address that are visible to other hosts in the network. Note: You must use only a static IP address. If you use a dynamic IP address, the installation will fail.
Central Inventory Requirements	Ensure that you allocate 100 MB of space for Central Inventory (oraInventory). 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.
UMASK Value Requirements	Ensure that you set the default file mode creation mask (umask) to 022 in the shell startup file. For example: Bash Shell $ . ./.bash_profile Bourne or Korn Shell $ . ./.profile C Shell % source ./.login
File Descriptor Requirements	Ensure that you set the file descriptors to a minimum of 4096. To verify the current value set to the file descriptors, run the following command: /bin/sh -c "ulimit -n" If the current value is not 4096 or greater, then as a root user, update the /etc/security/limits.conf file with the following entries: <UID> soft nofile 4096 <UID> hard nofile 4096
Host File Requirements	Ensure that the host name specified in the /etc/hosts file is unique, and ensure that it maps to the correct IP address of the host. The following is the recommended format of the /etc/hosts file: <ip> <fully_qualified_host_name> <short_host_name> For example, 172.16.0.0 example.com host1 According to RFC 952, the following are the assumptions: A name (Net, Host, Gateway, or Domain name) is a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-), and period (.). Note that periods are only allowed when they serve to delimit components of domain style names. No blank or space characters are permitted as part of a name. No distinction is made between upper and lower case. The first character must be an alpha character. Also, if DNS server is configured in your environment, then you should be able to use DNS to resolve the name of the host on which you want to install the OMS. For example, all these commands must return the same output: nslookup host1 nslookup example.com nslookup 172.16.0.0
Browser Requirements	Ensure that you use a certified browser as mentioned in the Enterprise Manager Certification Matrix available on My Oracle Support. To access this matrix, follow these steps: Log in to My Oracle Support, and click the Certifications tab. On the Certifications page, in the Certification Search region, from the Product list, select Enterprise Manager Cloud Control. From the Release list, select 12.1.0.1.0, and click Search. If you use Microsoft Internet Explorer 8 or 9, do the following: Turn off the compatibility view mode. To do so, in Microsoft Internet Explorer, from the Tools menu, click Compatibility View to disable it if it is enabled. Also, click Compatibility View Settings and deregister the Enterprise Manager Cloud Control console URL. Enable XMLHTTP. To do so, from the Tools menu, click Internet Options. Click the Advanced tab, and under the Security heading, select Enable native XMLHTTP support to enable it.

Installation Procedure

To install an additional Oracle Management Service (OMS), follow these steps:

1. In Cloud Control, from the Enterprise menu, select Provisioning and Patching, and then, click Procedure Library.

2. On the Deployment Procedure Manager page, in the Procedure Library tab, from the table, select Add Management Service, and then, click Launch.

3. On the Getting Started page, complete the preinstallation tasks listed there. Once you are done, select each of the tasks you have completed, and then, click Next.

4. On the Select Destination page, do the following:

   1. For Destination Host, select or enter the name of the managed host (a host managed by the first OMS using a Management Agent) on which you want to install the additional OMS.

      For example, example.com

      Note:

      Do NOT enter the IP address of the managed host. Enter only the fully qualified name.

   2. For Destination Instance Base Location, accept the default location to the OMS instance base directory or enter the absolute path to another location of your choice where OMS-related configuration files can be stored. Ensure that this directory has 100 MB of space. Also ensure that the directories and subdirectories you mention in the path already exist.

      For example, /apps/john/oracle/prod

   3. In the Source Credentials section and in the Destination Credentials section, select the credential type you want to use for accessing the source host. For more information, see Selecting Credentials.

   4. Click Next.

5. On the Options page, do the following:

   1. In the File Transfer Option section, select a suitable protocol to transfer the cloned ZIP files to a staging location. FTP is the default transfer mode.

      If you want to transfer the files to a shared, NFS-mounted network location, then you can select Shared Directory, and enter the absolute path to the shared location. Ensure that this shared directory has read/write access from source and destination hosts, and has 4 GB of space.

      For example, /net/example.com/scratch/john

      Note:

      If you choose to use FTP as the file transfer mode, then ensure that FTP software is installed on the source host as well as the destination host.

      If you choose to use a shared location as the file transfer mode, then ensure that the shared location has read/write permission and is accessible from the source host as well as the destination host.

      If you have an SFTP set up, then select FTP.

   2. In the Staging Locations section, for Source Staging, enter a location on the source host where the cloned ZIP files can be created and placed temporarily. Ensure that this temporary directory has 4 GB of space.

      For example, /example.com/shared

      Similarly, for Destination Staging, enter a location on the destination host where the cloned ZIP files can be copied to temporarily. Ensure that this temporary directory has 4 GB of space.

      For example, /example.com/shared

      Note:

      Once the OMS is installed on the destination host, the cloned ZIP files are automatically deleted from both the staging locations.

   3. In the Destination Ports section, validate the ports displayed by default.

      These default ports are based on the ports already assigned and used by the OMS that you are cloning. Oracle recommends you to use the same ports as your source OMS so that you have a homogeneous environment.

      You can choose to retain the ports displayed by default or enter a custom port. Ensure that the custom port you enter is within the recommended range as shown in the Recommended Port Range column. If you want to check the availability of a custom port, then click Check Ports.

   4. Click Next.

6. On the Post Creation Steps page, enter one or more e-mail IDs (separate by a comma) where the details of the postinstallation tasks to be performed can be sent, and then, click Next.

   For your e-mail to work, you must have already configured the mail server. For instructions, see Oracle Enterprise Manager Cloud Control Administrator Guide.

7. On the Review page, review the details and click Finish.

   Note:

   If the installation fails, particularly in the Install Homes step, then before you retry installing the OMS, clean up the middleware home on the destination host where the installation failed. To do so, on the destination host, do the following:

   1. Invoke the installer from the following location:

      <Middleware_Home>/oms/oui/bin/runInstaller

   2. In the installation wizard, on the My Oracle Support Details screen, click Installed Products.

      1. Select all plug-in homes and click Remove.

      2. Select the JDK home and click Remove.

      3. Select the Oracle WebTier home and click Remove.

      4. Select the OMS home and the Oracle Common directory, and click Remove.

      5. Exit the installer.

   3. Delete the middleware home directory.

   4. Return to the Add Management Service deployment procedure that failed, and retry the Install Homes step.

Selecting Credentials

You can select one of the following credential types for accessing the source and the destination hosts:

Table 7-2 Selecting Credential Type

Credential Type	Description
Preferred Credential	Select this if you want to use the credentials that are already registered as preferred credentials with Enterprise Manager. In this case, from the Preferred Credential Name list, select either Normal Host Credentials or Privileged Host Credentials depending on the type of preferred credentials you want to use for accessing the host.
Named Credential	Select this if you want to use the credentials of a named profile created in Enterprise Manager. In this case, from the Credential Name list, select the profile whose credentials you want to use. On selection, you will see the credentials details. For more information on the credentials associated with the selected profile, click More Details. If you want to test connecting to the host with those credentials, click Test.
New Credentials	Select this if you want to enter a new set of credentials that will override the preferred credentials or the named credentials registered with Enterprise Manager. In this case, enter the credentials you want to override with. If you want to register the new set of credentials with Enterprise Manager, then click Save As, and either accept the default profile name or enter a custom name for it. Further, if you want to save them as preferred credentials, then select Set as Preferred Credentials, and select an option to indicate whether they should be saved as normal credentials or privilege credentials. If you want to test connecting to the host with those credentials, click Test.

After You Install

After you install the additional OMS, follow these steps:

1. Perform these steps on the Server Load Balancer (SLB) using its administration console:

   (a) Add the additional OMS host to the following SLB pools:

   • Secured Upload Pool (add the host using the port configured for the Secured Upload service)

   • Agent Registration Pool (add the host using the port configured for the Agent Registration service)

   • Secure Console Pool (add the host using the port configured for the Secure Console service)

   • (Optional) Unsecure Console Pool (add the host using the port configured for the Unsecure Console service)

   (b) Associate the additional OMS host with the following monitors:

   • Secure Upload Monitor (associate the host using the port configured for the Secure Upload service)

   • Agent Registration Monitor (associate the host using the port configured for the Agent Registration service)

   • Secure Console Monitor (associate the host using the port configured for the Secure Console service)

   • (Optional) Unsecure Console Monitor (associate the host using the port configured for the Unsecure Console service)

   Note:

   For information about configuring SLB, see the Oracle Enterprise Manager Concepts and Enterprise Deployment Guide available at:

   http://www.oracle.com/technetwork/oem/grid-control/documentation/index.html

2. Run root.sh as a root user on the destination host.

3. By default, the following targets get automatically discovered and monitored in the Enterprise Manager Cloud Control console:

   • Oracle WebLogic Server, where the additional OMS is deployed

   • Oracle Web Tier

   • Application deployments, one for the Enterprise Manager Cloud Control console and one for the platform background services.

   • Oracle Management Service

   • Oracle Management Agent

   • The host on which you installed Enterprise Manager Cloud Control

   However, the other targets running on that host and other hosts do not get automatically discovered and monitored. To monitor the other targets, you need to add them to Enterprise Manager Cloud Control either using the Auto Discovery Results page, the Add Targets Manually page, or the discovery wizards offered for the targets you want to monitor.

   For information about discovering targets in Enterprise Manager Cloud Control, refer to the chapter on adding targets in the Oracle Enterprise Manager Cloud Control Administrator's Guide.