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
Validating Command Locations

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
Other Property Files Loaded

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

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.

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
Validating Command Locations on the Destination Host

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 OMS instance home to automatically list the variables that are not found in the default locations.

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

Note:

Before running the command, set the environment variable JARS_LOC to the following location of the OMS home where OraInstallar.jar and remoteinterfaces.jar are present:

$<ORACLE_HOME>/sysman/prov/agentpush/jlib

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