Skip Headers
Oracle® Enterprise Manager Grid Control Advanced Installation and Configuration Guide
11g Release 1 (11.1.0.1.0)

Part Number E16847-08
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

E Validating Command Locations

This appendix describes what property files and the command locations within them you need to validate before installing Oracle Management Agent (Management Agent). In particular, this appendix covers the following:

Overview of Property Files

Every time you install a Management Agent, the property files mentioned in the platformInfo.properties file are loaded with default locations for commands that are required for successful running of certain Application Programming Interfaces (APIs). For example, the ping executable. This section describes such property files. In particular, this section covers the following:

Property Files Loaded from platformInfo.properties File

Table E-1 describes the property files loaded from the platformInfo.properties file.

Table E-1 Property Files Loaded from platformInfo.properties File

Loading Order Property File Name Type Description

1

Paths.properties

Generic

Contains arguments that need to be passed every time the commands listed in this file are run.

2

sPaths.properties

Generic

Contains paths for all the commands that need to be run, regardless of the platform.

3

ssPaths_<platform>.properties

Platform-Specific

Contains commands that need to be run for that platform. For example, ssPaths_linux_zseries64.properties.

On Microsoft Windows, the path to the Cygwin binaries is hardcoded in the ssPaths_msplats.properties file. If you install Cygwin in a location other than c:\cygwin (default location), it can cause the Management Agent installation to fail. To resolve this issue, you must either install Cygwin in the default directory (c:\cygwin), or update this properties file with the correct path to the Cygwin binaries.

4

userPaths.properties

Generic

Contains variables that are used to specify the command paths. You must uncomment the variables that you want to use and specify appropriate values.


Keep in mind the following points:

  • The property files mentioned in the platformInfo.properties file are loaded one-by-one in ascending order. This means that command locations you specify in the last file that is loaded will override the values you specified for the same key in the previously loaded property file.

    For example, spaths.properties is loaded before ssPaths.properties. So if the default location for the ping executable in sPaths.properties file is usr/bin/ping, and if location for the same executable in the ssPaths.properties file as usr/sbin/ping, then the value in the latter file takes precedence over the former file.

  • If you want to include other command variables, then you can do one of the following:

    • Specify the additional command variables in sPaths.properties, ssPaths_<platform>.properties, or userPaths.properties.

    • Create a new property file with additional command variables. Then, mention the name of this new property file in platforminfo.properties.

Other Property Files Loaded

Table E-2 describes the other property files that are loaded.

Table E-2 Other Property Files Loaded

Property File Name Type Description

system.properties

Generic

Contains properties that help you control the activity and performance of the application. For example, these:

  • oracle.system.prov.threadpoolsize

    Number of threads that get created in the application and work in parallel to run the commands on the destination hosts. The default threadpool size value that is set is 32. You can specify an appropriate value for the threadpool size in this property.

  • oracle.sysman.prov.threadpoolmaxsize

    Number of threads that can increase dynamically depending on the workload. The default value used in the application is 256. You can specify an appropriate maximum value for the threadpool size in this property.

ignoreMessages.txt

Generic

If there are error messages displayed in the error stream that you know can be ignored in the setup, then you can update these messages in the ignoreMessages.txt file.

Generally, if the error stream contains data when you run any command, then it is assumed that the command failed, however, the data in the error stream may not always correspond to the error.

So, to ignore such error messages, you must add these messages (including the banner) to the ignoreMessages.txt file.

For example, when you run /usr/local/bin/sudo on a remote host, it writes the following messages on to the error stream. Error messages of this kind can be added to the ignoreMessages.txt file.

Administrator. It usually boils down to these two things:#1) Respect the privacy of others.#2) Think before you type.Password:
This essentially is just a warning to the user and does not constitute the failure of the executed command.

Note:

The data format for these files mandates only one property per line. You must specify the property values in the format: variable=value.

Validating Command Locations

The default command locations specified in the property files can vary between hosts and platforms. Therefore, it is important to verify the command locations before you install a Management Agent.

This section describes what property files and command locations within them you need to validate before you install a Management Agent. In particular, this section covers the following:

Validating Command Locations on the OMS Host

In the property files present in the <OMS_INSTANCE_HOME>/sysman/prov/resources/ location, validate the command locations (on the OMS host) for the following variables:

  • SH_PATH

  • SSH_ARGS

  • SSH_KEYGEN_PATH

  • SSH_PATH

  • SCP_ARGS

  • SCP_PATH

  • UNZIP_ARGS

  • UNZIP_PATH

  • TAR_PATH

Instead of manually reviewing each of the property files, you can run the following command from the Oracle home of the OMS to automatically list the variables that are not found in the default locations.

$<ORACLE_HOME>/sysman/prov/resources/scripts/validatePaths -dirloc oms/sysman/prov/resources/

Validating Command Locations on the Destination Host

In the property files present in the <OMS_INSTANCE_HOME>/sysman/prov/resources/ location, validate the command locations (on the destination host) for the following variables:

  • SH_PATH

  • SH_ARGS

  • SCP_PATH

  • SCP_ARGS

  • SUDO_PATH

  • SSH_HOST_KEY_LOC

  • ZIP_PATH

  • TAR_PATH