Skip Headers
Oracle® Enterprise Manager Cloud Control Basic Installation Guide
12c Release 1 (
  Go To Table Of Contents
Go To Index


B Validating Command Locations

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

Overview of Property Files

Every time you install a Management Agent, the property files mentioned in the file are loaded with default locations to commands that are required for successfully running 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 File

Table B-1 describes the property files loaded from the file.

Table B-1 Property Files Loaded from File

Loading Order Property File Name Type Description



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



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



Operating System-Specific

Contains commands that need to be run for a particular operating system. For example,

On Microsoft Windows, the path to the Cygwin binaries is hardcoded in the 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.



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 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, is loaded before So if the default location for the ping executable in file is usr/bin/ping, and if location for the same executable in the file is 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, ssPaths_<platform>.properties, or

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

Other Property Files Loaded

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

Table B-2 Other Property Files Loaded

Property File Name Type Description


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.



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 the 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 and does not constitute the failure of the executed command.


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 operating systems. Therefore, it is important to verify the command locations before you install a Management Agent.

To validate the command locations, follow these steps:

  1. Access the file from the following location of the OMS home, and make note of the property files you need to validate for your platform:


  2. Access each of the property files you noted in Step (1), and verify that the command locations mentioned for the following variables map to valid locations on the OMS host:

    • SSH_PATH

    • SCP_PATH

    • SH_PATH


  3. Access each of the property files you noted in Step (1), and verify that the command locations mentioned for the following variables also map to valid locations on the destination host:

    • SCP_PATH

    • SH_PATH

    • SSH_PATH



    • RM_PATH