IBM Performance Management

Configuring the DB2 agent

The Monitoring Agent for DB2® monitors the availability and performance of the DB2 server. You can monitor multiple servers from the Performance Management console; each server is monitored by a DB2 agent instance.

About this task

The DB2 agent is a multiple instance agent; you must create the first instance and start the agent manually.

The managed system name includes the agent instance name that you specify, for example, instance_name:host_name:pc, where pc is your two character product code. The agent instance name should be the name of the DB2 instance being monitored. The managed system name can contain up to 32 characters. The agent instance name that you specify can contain up to 28 characters, excluding the length of your host name. For example, if you specify DB2inst1 as your agent instance name, your managed system name is DB2inst1:hostname:ud.

Important: If you specify a long agent instance name, the managed system name is truncated and the agent code is not displayed completely.

To avoid permission issues when you configure the agent, be sure to use the same root user or non-root user ID that was used for installing the agent. If you installed your agent as a selected user and want to configure the agent as a different user, see Configuring agents as a non-root user. If you installed and configured your agent as a selected user and want to start the agent as a different user, see Starting agents as a non-root user.

Run the configuration script to create an instance and change the configuration settings. You can edit the DB2 silent response file before you run the configuration script to bypass the prompts and responses that are otherwise required.

After you configure the DB2 agent, be sure to start the agent with a user ID that has the DB2 SYSADM authority for the monitored instance. The agent requires the SYSADM authority to turn on all monitor switches. The instance owner user, for example, DB2inst1 must be used to start the agent.

Remember: You can configure the DB2 agent on Windows systems in the silent mode only.

Procedure

To configure the agent with the default settings, complete the following steps:

Run the following command where instance_name is the name that you want to give to the instance:
```
install_dir/bin/db2-agent.sh config instance_name
 install_dir/samples/DB2_silent_config.txt
```

Run the following command to start the DB2 agent:

install_dir/bin/db2-agent.sh start instance_name

What to do next

Log in to the Performance Management console to view the data that is collected by the agent in the dashboards. For information about using the Performance Management console, see Starting the Performance Management console.