E Installing Management Agents on Microsoft Windows Target Hosts Without Using Cygwin

Installing Management Agents on Microsoft Windows target hosts using the Add Host Targets Wizard or EM CLI requires you to install Cygwin on each of the hosts, as a prerequisite. If you do not want to install Cygwin on these hosts, you can install the PsExec utility instead, and use it to install Management Agents on the Microsoft Windows target hosts. This appendix describes how to perform this task. It consists of the following sections:

E.1 Installing Management Agents Using PsExec when the OMS Platform is Unix-based

Note:

To install Management Agents on Microsoft Windows target hosts using PsExec when the OMS platform is Unix-based, you need a Microsoft Windows staging host server. Hence, ensure that a Microsoft Windows host that you can use as a staging server exists in your enterprise.

To install the PsExec utility, and use it to install Management Agents on Microsoft Windows target hosts when the OMS host runs on a Unix-based operating system, follow these steps:

Download the PsExec utility onto the Microsoft Windows staging host server from the following URL:

http://technet.microsoft.com/en-us/sysinternals/bb897553.aspx

Extract the contents of the zip file to a particular directory.

Downloading the PsExec utility is a one-time activity. The PsExec utility must be downloaded only onto the Microsoft Windows staging host server, and need not be downloaded onto the Microsoft Windows target hosts.
Run the following command from the command prompt to verify that the PsExec utility is functioning properly:

psexec calc

If the PsExec utility is functioning properly, the Microsoft Windows Calculator application will start up.
Follow these steps to ensure that the required Management Agent software is present on the Microsoft Windows staging host server:
1. Run the following command from the Oracle home of the OMS host to obtain the list of platforms for which the Management Agent software is downloaded and applied:
  
  $<ORACLE_HOME>/bin/emcli get_supported_platforms
  
  For example,
  
  /u01/software/em13c/oraclehome/bin/emcli get_supported_platforms
  
  If the required Microsoft Windows platform does not appear in this list, download and apply the Management Agent software for this platform using Self Update. For information on how to do this, see Meeting the Management Agent Software Prerequisites for Installing Standalone Management Agents Using Add Host Targets Wizard or EM CLI.
2. Download the Management Agent software onto the Microsoft Windows staging host server, and unzip it. To perform this task, use one of these methods:
  
  Method 1: Downloading the Software Using EM CLI from the OMS Host, and Transferring It Using an FTP Client
  
  Download the Management Agent software to a temporary directory on the OMS host, then transfer the software to the staging host using WinSCP, or any other FTP client. To download the Management Agent software to a temporary directory on the OMS host, run the following command from the Oracle home of the OMS host:
  
  $<ORACLE_HOME>/bin/emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>
  
  For example,
  
  /u01/software/em13c/oraclehome/bin/emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>
  
  After transferring the zip file to the staging host, verify its size and its checksum value to ensure that the entire zip file was transferred. Unzip the zip file. Set the ZIP_LOC environment variable to $ORACLE_HOME/bin/zip, which is the location of the ZIP utility in the Oracle home of the OMS host.
  
  Method 2: Downloading the Software Using EM CLI from the Staging Host
  
  Download EM CLI onto the staging host server.
  
  For information on how to do this, see Downloading and Deploying EM CLI in the Oracle Enterprise Manager Command Line Interface.
  
  After downloading EM CLI onto the staging host, ensure that you connect the client to the OMS. For information on how to do this, see the 'Connecting the EM CLI Client to OMS' section in the chapter referenced above.
  
  Download the Management Agent software onto the staging host server by running the following command:
  
  <emcli_install_location>\emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>
  
  Unzip the Management Agent software zip file.
Note:

This step (downloading the required Management Agent software onto the staging host) is a one-time activity. Once the required Management Agent software is downloaded onto the staging host, it can be reused to deploy Management Agents on any number of Microsoft Windows target hosts.
Download the agentDeployPsExec.bat script onto the staging host, from the Oracle home of the OMS host:

$<ORACLE_HOME>/sysman/prov/agentpush/scripts/agentDeployPsExec.bat

For example,

/u01/software/em13c/oraclehome/sysman/prov/agentpush/scripts/agentDeployPsExec

Create a response file to specify the Management Agent install inputs. Table E-1 lists the mandatory parameters that you must include, and the optional parameters that you can include in the response file.

Table E-1 Creating a Response File for Installing Management Agents Using PsExec

Parameter	Description
HOST_NAMES	(Mandatory) Use this parameter to specify the names of the Microsoft Windows target hosts on which you want to install Management Agents. Use a colon (:) as a separator between the host names.
USER_NAME	(Mandatory) Use this parameter to specify the target host login user name.
PASSWORD	(Mandatory) Use this parameter to specify the target host login password.
PSEXEC_DIR	(Mandatory) Use this parameter to specify the absolute path to the location where you downloaded and extracted the PsExec utility.
AGENT_IMAGE_PATH	(Mandatory) Use this parameter to specify the absolute path to the location where you unzipped the Management Agent software zip file.
AGENT_BASE_DIR	(Mandatory) Use this parameter to specify the location of the Management Agent install base directory.
AGENT_REGISTRATION_PASSWORD	(Mandatory) Use this parameter to specify the password for registering new Management Agents that join the Enterprise Manager system.
EM_UPLOAD_PORT	(Mandatory) Use this parameter to specify the upload port (HTTP or HTTPS) for communicating with the OMS.
OMS_HOST	(Mandatory) Use this parameter to specify the name of the OMS host.
REMOTE_SYS_DIR	(Mandatory) Use this parameter to specify the directory that the PsExec utility must use internally to copy or transfer files. Ensure that this parameter is set to `C:\Windows` or `C:\Windows\System32`
ADDITIONAL_PARAMETERS	(Optional) Use this parameter to specify the list of additional parameters that you want to use. Separate the parameters using a colon.
PROPERTIES_FILE	(Optional) Use this parameter to specify the absolute path to the properties file.
LOG_LOC	(Optional) Use this parameter to specify the location of the Management Agent deployment logs.

If you have set the PERL5LIB environment variable on the staging host, delete it. You can set this environment variable again after installing the Management Agents.
Run the following command from the staging host to install Management Agents on the selected Microsoft Windows target hosts:

C:\<location_of_downloaded_psexec_script>\agentDeployPsExec.bat PROPERTIES_FILE=<absolute_path_to_response_file>

For example, C:\stage\agentDeployPsExec.bat PROPERTIES_FILE=C:\stage\input.txt

Note:

The Management Agent install log files are created in the location you specified for the LOG_LOC response file parameter. If you didn't specify the LOG_LOC parameter in the response file, the log files are created in the directory that contains the agentDeployPsExec.bat script.

E.2 Installing Management Agents Using PsExec when the OMS Platform is Microsoft Windows

Note:

To install Management Agents on Microsoft Windows hosts using PsExec when the OMS platform is Microsoft Windows, you do not need a separate Microsoft Windows staging host server.
If the OMS software was installed in a drive other than C:\, then update the SCRATCHPATH variable in <ORACLE_HOME>\oui\prov\resources\ssPaths_msplats.properties.

For example, if the OMS software was installed in D:\, ensure that you update the SCRATCHPATH variable to D:\tmpada.

To install the PsExec utility, and use it to install Management Agents on Microsoft Windows hosts when the OMS host runs on Microsoft Windows, follow these steps:

Download the PsExec utility onto the OMS host from the following URL:

http://technet.microsoft.com/en-us/sysinternals/bb897553.aspx

Extract the contents of the zip file to a particular directory.

Downloading the PsExec utility is a one-time activity. The PsExec utility must be downloaded only onto the OMS host, and need not be downloaded onto the Microsoft Windows target hosts.
Run the following command from the command prompt to verify that the PsExec utility is functioning properly:

psexec calc

If the PsExec utility is functioning properly, the Microsoft Windows Calculator application will start up.
Follow these steps to ensure that the required Management Agent software is present on the OMS host:
1. Run the following command to obtain the list of platforms for which the Management Agent software is downloaded and applied:
  
  $<ORACLE_HOME>\bin\emcli get_supported_platforms
  
  For example,
  
  C:\u01\software\em13c\oraclehome\bin\emcli get_supported_platforms
  
  If the required Microsoft Windows platform does not appear in this list, download and apply the Management Agent software for this platform using Self Update. For information on how to do this, see Meeting the Management Agent Software Prerequisites for Installing Standalone Management Agents Using Add Host Targets Wizard or EM CLI.
2. Download the Management Agent software to a temporary directory on the OMS host:
  
  $<ORACLE_HOME>\bin\emcli get_agentimage -destination=<download_directory> -platform="<platform>" -version=<version>
  
  For example,
  
  .\emcli get_agentimage -destination=C:\temp -platform="Microsoft Windows x64 (64-bit)" -version=13.2.0.0.0
  
  Unzip the Management Agent software zip file. Set the ZIP_LOC environment variable to $ORACLE_HOME\bin\zip, which is the location of the ZIP utility in the Oracle home of the OMS host.
Note:

This step (downloading the required Management Agent software onto the OMS host) is a one-time activity. Once the required Management Agent software is downloaded onto the OMS host, it can be reused to deploy Management Agents on any number of Microsoft Windows target hosts.
Create a response file to specify the Management Agent install inputs. Table E-1 lists the mandatory parameters that you must include, and the optional parameters that you can include in the response file.
If you have set the PERL5LIB environment variable on the OMS host, delete it. You can set this environment variable again after installing the Management Agents.
Run the following command from the OMS host to install Management Agents on the selected Microsoft Windows hosts:

$<ORACLE_HOME>\sysman\prov\agentpush\scripts\agentDeployPsExec.bat PROPERTIES_FILE=<absolute_path_to_response_file>

For example, C:\u01\software\em13c\oraclehome\sysman\prov\agentpush\scripts\agentDeployPsExec.bat PROPERTIES_FILE=C:\stage\input.txt.

Note: