Before Starting
Ensure that the web server version and operating system are supported. See Supported Apache Web Servers.
Also verify the following requirements on the machine on which you are installing the agent:
- Perform the installation under the same user and group that Apache is using when spawning worker processes and threads.
- Ensure that the machine on which the agent runs has random or urandom set appropriately. This is because certain functions in the Apache Agent are dependent on random number generation. Else, it can lead to abrupt behavior such as log files or directories may not be created, nothing is reported from the agent to the Controller, and so on.
- Ensure that the ulimit setting for open file descriptors is set such that neither the Apache worker process or the Proxy task does not exceed it to avoid resource contention.**
- Check the open file descriptor limit of the userid that the proxy and/or
Apache worker process must have:For the MPM_Worker mode, the number of
file descriptors must be set using the following
calculation:
. For all other modes, you must set the number of file descriptors using the calculation:1024 + ServerLimit + (2 * ServerLimit * ThreadsPerChild)
The open file descriptor setting can be found in /etc/security/limits.conf, but the setting requires a host reboot to become effective, or set through the "ulimit -n" command for the current userid's session only.(Total number of concurrently active Apache workers * 2) + 1024.
- For Linux, check for modules with dependencies on
libstdc++.so.6
. See Special Considerations for Apache Web Servers with libstdc++.so.5 Modules. This is most common with IHS and OHS. - For AIX dependencies, see Prerequisites for Apache Agent Installation on AIX.
- Ensure that the machine on which the agent runs has a locale environment set properly. As some functions in the Apache Agent have a dependency on the locale it could lead to a crash otherwise.
- Based on the agent's requirement, you can select one of the following
and set the environment variable as:
export LANG=en_US.UTF-8 export LANGUAGE=$LANG export LC_ALL=$LANG
Or
export LANG=en_US.UTF-8
Or
export LC_ALL=C