IBM Performance Management

Configuring WebSphere Applications agent

In the agent coexistence environment, the data collector is shared by both WebSphere® Applications agent and ITCAM Agent for WebSphere Applications. Both agents must use different ports to listen to the requests from the data collector. You must configure the agent to change the port, if necessary.

About this task

On Linux or AIX® systems, you can configure the agent interactively by running the configuration script and then responding to prompts, or silently by creating a silent response file and running the configuration script without interaction.
On Windows systems, you can configure the agent by creating a silent response file and running the configuration script, or with the provided Manage Monitoring Services utility. For information about how to start Manage Monitoring Services on Windows systems, see Using the IBM Performance Management window on Windows systems.

Procedure

To configure the agent by editing the silent response file and running the script with no interaction, complete the following steps:
1. Create a .txt file as the silent response file.
2. Specify the following parameters in the silent response file. The syntax is parameter_name=parameter_value.
  configure_type
  
  Specifies the configuration type. This parameter is required.
  
  Valid value is tema_configure for agent configuration.
  
  KYN_ALT_NODEID
  
  Specifies the alternative node ID for identifying the agent. This parameter is required.
  
  Valid value is an alphanumeric string of up to 24 characters.
  
  KYN_PORT
  
  Specifies the listening port that is used by the agent. This is the TCP socket that the agent uses for listening to connection requests from the data collector. This parameter is required.
  
  The default value is 63335.
  
  Remember: In agent coexistence environment, make sure that the port number that you specified here is not being used by the ITCAM Agent for WebSphere Applications.
  For example, add the following lines in the .txt file that you created.
```
configure_type=tema_configure
KYN_ALT_NODEID=WASAgent
KYN_PORT=63335
```
3. Save and close the file, and then enter the following command to run the configuration script:
  - install_dir/bin/was-agent.sh config path_to_responsefile
  - install_dir\bin\was-agent.bat config path_to_responsefile
  where install_dir is the agent installation directory. The default is C:\IBM\APM on Windows systems, /opt/ibm/apm/agent on Linux systems, or /opt/ibm/ccm/agent on AIX systems.
4. After configuration completes, restart the WebSphere Applications agent if it is not running with the following command:
  - install_dir/bin/was-agent.sh start
  - install_dir\bin\was-agent.bat start
To configure the agent by running the script and responding to prompts, complete the following steps:
1. From the command line, go to the install_dir/bin directory, where install_dir is the agent installation directory.
  The default is /opt/ibm/apm/agent on Linux systems or /opt/ibm/ccm/agent on AIX systems.
2. Run the configuration script from the directory:
```
./was-agent.sh config
```
3. When prompted, enter 1 and press Enter to edit the settings for the monitoring agent of WebSphere Applications agent.
4. Press Enter until you are prompted for an alternative node ID to identify the monitoring agent.
5. Provide the node ID and press Enter. The valid format of the node ID is an alphanumeric string of up to 24 characters.
6. When prompted for the port number, provide the port that is used by the agent to listen to connection requests from the data collector and press Enter.
  Remember: For agent coexistence environment, make sure that the specified port is not being used by the ITCAM Agent for WebSphere Applications.
7. After configuration completes, restart the WebSphere Applications agent.

Results

You have configured the WebSphere Applications agent.

What to do next

Next, you must configure the data collector. When you configure the data collector, you will be asked to provide the port number that you configured for the WebSphere Applications agent and ITCAM Agent for WebSphere Applications. For instructions, see Configuring the data collector for agent coexistence environment.