Configuring HTTP Server agent monitoring

The HTTP Server agent starts automatically after installation. To enable data collection, make sure that the HTTP server is running, and edit the HTTP Server configuration file so that it includes a reference to the HTTP Server agent data collector configuration file..

Before you begin

The directions here are for the most current release of this agent. For information about how to check the version of an agent in your environment, see Agent version command. For detailed information about the agent version list and what's new for each version, see Change history.

There are two files involved in the configuration of the HTTP Server agent. To view samples of these files, see Samples. Locate and review the following files:

The HTTP Server agent data collector configuration file

After you install the HTTP Server agent, it discovers the HTTP server and generates a data collector configuration file in the install_dir/tmp/khu directory where install_dir is the directory where the HTTP Server agent is installed.

If you have multiple HTTP Servers in your environment, one HTTP Server agent configuration file is generated per HTTP server.

The HTTP Server agent configuration file name is composed of two parts and has following format:

khu.full path of the HTTP Server configuration file name.conf

The first part of the agent configuration file name is khu, in which hu is the HTTP server agent code.
The second part of the agent configuration file name is created by using the full path and name of the HTTP server configuration file, in which / is replaced by . . For example, possible file names are as follows:

khu.usr.local.apache24.conf.httpd.conf

khu.C.Program Files.IBM.HTTPServer.conf.httpd.conf

The HTTP Server agent data collector configuration file contains the following elements:

Details about the path of the httpd.conf file that the HTTP Server uses, for example, KhuShmemPath "/IBM/HTTPServer/conf/httpd.conf".
Location of the library to load
Permissions that are associated with the shared memory

The HTTP server configuration file: Each HTTP server has a configuration file that by default is called http_server_install_dir/conf/httpd.conf, where http_server_install_dir is the directory where the HTTP Server is installed. In some environments, this file name might be customized. Check the exact file name with the HTTP server administrator.

Procedure

To activate data collection, you must reference the data collector configuration file in the HTTP server configuration file by using the Include statement. Append the following statement to the end of the HTTP Server configuration file:
```
Include “install_dir/tmp/khu/khu.full path of the HTTP Server configuration file name.conf”
```
For example,
If you have an IBM® HTTP Server that is installed in the /opt/IBM/HTTPServer directory and the data collector configuration file is in the following directory:
```
/opt/ibm/apm/agent/tmp/khu/khu.opt.IBM.HTTPServer.conf.httpd.conf
```
Append the following statement to the /opt/IBM/HTTPServer/conf/httpd.conf HTTP server configuration file:
```
Include “/opt/ibm/apm/agent/tmp/khu/khu.opt.IBM.HTTPServer.conf.httpd.conf”
```
If you have an IBM® HTTP Server that is installed in the C:\ProgramFiles\IBM\HTTPServer directory and the data collector configuration file is in the following directory:
```
C:\IBM\APM\tmp\khu\khu.C.Program Files.IBM.HTTPServer.conf.httpd.conf
```
Append the following statement to the C:\Program Files\IBM\HTTPServer\conf\httpd.conf HTTP server configuration file:
```
Include “C:\IBM\APM\tmp\khu\khu.C.Program Files.IBM.HTTPServer.conf.httpd.conf”
```
Change to the following directory:
```
HTTP_server_installation_directory/bin
```

Restart the HTTP Server. For example:

./apachectl -k stop
./apachectl -k start

httpd.exe -k stop
httpd.exe -k start

Results

You have successfully configured the agent.

What to do next

Now, you can verify the HTTP Server agent data is displayed in the console.