Apache-based Server Preparations for Linux

This content describes the preparations that are required to prepare for an Apache Web Agent install on a Red Hat Enterprise Linux system.
sm1252sp1
This content describes the preparations that are required to prepare for an Apache Web Agent install on a Red Hat Enterprise Linux system.
Required Software Packages
The following software packages are required to install Web Agents on 64-bit Linux systems:
  • Binutils 2.17
  • GCC 4.7.2
Required Linux Libraries 
CA Single Sign-On
 requires certain Linux libraries for components that operate on Linux. We recommend using YUM to install the required libraries as YUM resolves the dependencies of packages and their versions.
The following list describes the commands for installing the required libraries on the host system:
Red Hat 5.x
yum install -y compat-gcc-34-c++
yum install -y libidn.so.11
yum install -y libstdc++.i686
yum install -y  ncurses-libs.i68
yum install keyutils-libs.i686 (For CA Single Sign-On 12.52 SP1 CR08 and later)
Red Hat 6.x
yum install -y libstdc++.i686
yum install -y libidn.so.11
yum install -y libidn.i686 
yum install -y libXext.i686
yum install -y ncurses-libs.i686 (For CA Single Sign-On 12.52 SP1 CR08 and later)
yum install keyutils-libs.i686
yum install -y libXrender.i686
yum install -y libXtst.i686
Additional Packages for Red Hat 6.x 64-bit
yum install -y libXau.i686
yum install -y libXext.i686
yum install -y libxcb.i686
yum install -y compat-libstdc++-33.i686
yum install -y compat-db42.i686
yum install -y compat-db.i686
yum install -y compat-db43.i686
yum install -y libXi.i686
yum install -y libX11.i686
yum install -y libXtst.i686
yum install -y libXrender.i686
yum install -y libXft.i686
yum install -y libexpat.so.1
yum install -y libXt.i686
yum install -y libfreetype.so.6
yum install -y libXp.i686
yum install -y libfontconfig.so.1
yum install -y libstdc++.i686
yum install -y libICE.i686
yum install -y compat-libtermcap.i686
yum install -y libidn.i686
yum install -y libSM.i686
yum install -y libuuid.i686
Red Hat 7.x
yum install -y libstdc++.i686
yum install -y libidn.i686
yum install -y libXext.i686
yum install -y libXrender.i686
yum install -y libidn.so.11
yum install -y libXtst.i686
yum install -y ncurses-libs.i686
yum install keyutils-libs.i686 (For CA Single Sign-On 12.52 SP1 CR08 and later)
If the correct library is unavailable, 
CA Single Sign-On
 displays the following error:
java.lang.UnsatisfiedLinkError 
Install Red Hat Legacy Software Development Tools
Install all the items included in the Red Hat Legacy Software Development tools package. You require these tools to compile the Apache Web Server.
Compile an Apache Web Server on a Linux System
For the
CA Single Sign-On
Agent to operate with an Apache web server running Linux, compile the server. Compiling is required because the Agent code uses pthreads (a library of POSIX-compliant thread routines), but the Apache server on the Linux platform does not, by default.
If you do not compile with the lpthreadoption, the Apache server starts up, but then hangs and does not handle any requests. The Apache server on Linux cannot initialize a module which uses pthreads due to issues with the Linux  dynamic loader.
Follow these steps:
  1. Enter the following commands:
    LIBS=-lpthread
    export LIBS
  2. Configure Apache as usual by entering the following commands:
    configure --enable-module=so --prefix=your_install_target_directory
    make
    make install
Verify Presence of a Logs Subdirectory with Permissions for Apache-based Agents
For agents running on Apache-based web servers (including IBM HTTP Server), a logs subdirectory must exist under the root directory of the Apache-based web server. This subdirectory needs Read and Write permissions for the user identity under which the Apache child process runs.
If the logs subdirectory does not exist, create it with the required permissions.
This configuration requirement applies to any Apache-based web server that writes log files outside the Apache root directory.