Installing the agent

Use the installation package prepared by Agent Builder to install the agent on all monitored systems.

Before you begin

Ensure that an agent for IBM® Cloud Application Performance Management, usually the operating system agent, is already present on the monitored system and working.

WindowsOn Windows systems, use an Administrator command line shell to install and configure agents. To start an Administrator shell, select Command Prompt from the Windows Programs menu, right-click, and click Run as Administrator.

Procedure

  1. Extract the package to a temporary directory and change to this directory.
  2. Install the agent by using the following command, depending on your operating system:
    • WindowsOn Windows systems, installIraAgent.bat agent_install_location
    • Linux or AIXOn Linux® and UNIX systems, ./installIraAgent.sh agent_install_location
    Where agent_install_location is the installation location of the existing agent. The default location is:
    • WindowsOn Windows systems, C:\IBM\APM
    • LinuxOn Linux systems, /opt/ibm/apm/agent
    • AIXOn AIX® systems, /opt/ibm/apm/agent
    Important: If you have added any custom configuration properties in the Runtime Configuration window of the Agent Editor, if the agent supports multiple instances, or if the agent uses any predefined data source that needs configuration (for example, a user ID and password), you must configure the agent before it can start. If an agent does not require configuration, it starts automatically after installation.