IBM Performance Management

Preinstallation on Windows systems

You must complete the required preinstallation tasks before you install agents on Windows systems. Some preinstallation tasks are agent-specific and other tasks apply to multiple agents.

Note: These requirements are in addition to the requirements identified in the Software Product Compatibility Reports.
For the current version requirements and dependencies for your agent, see APM Developer Center > System requirements for a link to the Software Product Compatibility Report.

The following preinstallation tasks are applicable to all agents:

Installing from the command prompt on a local drive
Use the Windows command prompt to start the installation script. Do not use Windows PowerShell to start the installation script.
Copy the installation files to a local disk or a mapped network drive, and then start the installation script. Do not start the installation script from a network location.
Start the installation script from a new command prompt. Do not start the installation script from an existing command prompt because the command prompt might have outdated environment variables.

The following preinstallation tasks are applicable to the specified agents:

MySQL agent
For the Monitoring Agent for MySQL, you must install the MySQL server and MySQL JDBC driver before you install the MySQL agent on that system. To install the JDBC driver, see MySQL Connector/J JDBC driver.
If you are installing the agent on a VM that you plan to use as the base library image, do not configure the MySQL agent before you instantiate the other VMs. The MySQL agent must be configured on each instantiated VM.
Oracle Database agent
If the Oracle Database agent monitors the Oracle database remotely, you must install the Oracle instant clients first from Oracle Technology Network - Instant Client Downloads on the following systems:
  • Windows Server 2012 64-bits
  • Windows Server 2012 R2 64-bits
  • Windows Server 2008 R2 Datacenter 64-bits
  • Windows Server 2008 R2 Enterprise 64-bits
  • Windows Server 2008 R2 Standard 64-bits
The instant clients v10.x, v11.x, and v12.x are supported by the Oracle Database agent.
Response Time Monitoring Agent

For the Response Time Monitoring Agent, WinPcap 4.1.3 is required before you can install the agent. You can download the driver from http://www.winpcap.org.

SAP HANA Database agent
  1. Install SAP HANA database client HDBSQL version 1.00.102.06 or later on the Windows system.
  2. Add the installation path of the SAP HANA client to the PATH environment variable.

    Example: Add C:\Program Files\sap\hdbclient to the PATH environment variable, where C:\Program Files\sap\hdbclient indicates the installation path of the SAP HANA database client.