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:
    1024 + ServerLimit + (2 * ServerLimit * ThreadsPerChild)
    . For all other modes, you must set the number of file descriptors using the calculation:
    (Total number of concurrently active Apache workers * 2) + 1024.
    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.
  • 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