16 Cloning Oracle Management Agent Using ZIP File

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

Temporary Directory Space Requirements

Ensure that you allocate 400 MB of space for a temporary directory where the executables can be copied. For example, /tmp on UNIX hosts and c:\Temp on Microsoft Windows hosts.

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.

Existing Management Agent

Ensure that you already have a Management Agent installed in your environment, which can be cloned.

Existing Oracle Management Agent Version Requirements

Ensure that the version of the existing, shared Oracle Management Agent is the same as the one you want to install.

For example, if you want to install Oracle Management Agent 11g Release 1, then ensure that the existing, shared Oracle Management Agent is 11g Release 1.

Existing Oracle Management Agent Platform Requirements

Ensure that the platform of the existing, shared Oracle Management Agent is the same as the host on which you want to install an additional Oracle Management Agent.

For example, if you want to install Oracle Management Agent 11g Release 1 on a Linux host, then ensure that the existing, shared Oracle Management Agent 11g Release 1 is also running on a Linux host.

Existing Oracle Management Agent Status Requirements

Ensure that you shut down the existing Oracle Management Agent before creating the ZIP file of its Oracle home.

Shared Software Binaries Requirements

Ensure that the software binaries of the existing Management Agent are accessible from all the destination hosts where the additional Management Agent needs to be installed.

You can either share the Oracle home of the existing Management Agent or copy the software binaries of that Management Agent to a shared, mounted location that can be accessed from other remote hosts.

Path Validation Requirements

Validate the path to all command locations. For more information, see Appendix E, "Validating Command Locations".

/etc/hosts File Requirements

If the destination host and the host on which OMS is running belong to different network domains, then ensure that you update the /etc/hosts file on the destination host to add a line with the IP address of that host, the fully-qualified name of that host, and the short name of the host.

For example, if the fully-qualified host name is mypc.cn.company.com and the short name is mypc, then add the following line in the /etc/hosts file:

12.123.123.12 mypc.cn.company.com mypc

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

• Ensure that you have read, write, and execute permissions on oraInventory on all remote hosts. If you do not have these permissions on the default inventory (typically at /etc/oraInst.loc) on any remote host, then you can specify the path to an alternative inventory location by using the -i <location> option in the Additional Parameters section.

  For information about oraInventory permissions, see What Is Oracle Inventory Directory?.

• Ensure that you have write permission on the Installation Base Directory and the temporary directory where the executables will be copied. For example, /tmp or c:\Temp.

Oracle Inventory Location Requirements

Ensure that the Oracle Inventory (oraInventory) is not in a shared location. When you use the oraInst.loc file, ensure that the inventory location specified there is not pointing to a shared location. If it is, change it to a non-shared location.

SUDO Privilege Requirement

Ensure that you have SUDO privileges to run root.sh and /bin/sh (UNIX platforms only). The Agent Clone Wizard uses SUDO to run the root.sh script. You must specify the invoking user's password here.

To verify whether you have SUDO privileges to run these files, access the /etc/sudoers file and check whether you have a similar entry as shown below. If you do not see a similar entry, then add one.

<user> <hostname>=PASSWD: /home/em/agent11010/agent11g/root.sh, /bin/sh

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:

<INSTANCE_HOME>/sysman/prov/resources/Paths.properties

PubkeyAuthentication Parameter Requirements

Ensure that the PubkeyAuthentication parameter is enabled in the sshd_config file.

To verify the value of this parameter, run the following command:

grep PubkeyAuthentication <SSH_Install_Location>/sshd_config

For example,

grep PubkeyAuthentication /etc/ssh/sshd_config

The result of this command must be Yes. If the result is No, then edit the sshd_config file, set the PubkeyAuthentication value to Yes, and restart the SSH daemon.

Agent User Account Permissions and Rights (For Microsoft Windows)

(For Microsoft Windows) If you are installing the Management Agent on a Microsoft Windows-based platform, then ensure that the agent user account has permissions and rights to perform the following:

• Act as part of the operating system.

• Increase quotas.

• Replace process level token.

• Log in as a batch job.

To verify whether the agent user has these rights, follow these steps:

1. Launch the Local Security Settings.

   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.

2. In the Local Security Settings window, from the tree structure, expand Local Policies, and then expand User Rights Assignment.

Permissions for cmd.exe (For Microsoft Windows)

(For Microsoft Windows) If you are installing the Management Agent on a Microsoft Windows-based platform, then ensure that you grant the Cmd.exe program Read and Execute permissions for the user account that the batch job runs under. This is a restriction from Microsoft.

For more information on this restriction and to understand how you can grant these permissions, access the following URL to Microsoft Web site:

http://support.microsoft.com/kb/867466/en-us