Installing the Centrify for Apache files

The Centrify software plugs into the Apache server as a loadable authentication module. Using the module requires some editing of Apache configuration files, but you do not need to recompile or relink Apache to incorporate the package software.

The Centrify authentication module is provided in a platform-specific package and installed using the platform’s native installation mechanism. In the following procedures, use the instructions corresponding to your platform.

Use the following steps to install the authentication module on your Apache server.

If you are installing the Centrify software on Apache servers in a cluster, see Installing Centrify for Apache for additional instructions.

To install the Centrify for Apache files:

  1. Log on to the Linux or UNIX computer using an account with root privileges or switch to the root user.
  2. If you are loading the files from a CD mount the cdrom device using the appropriate command for the local computer’s operating environment.

    Note:   When you auto-mount the Centrify for Web Applications CD on HP-UX, file names are displayed in the short name (8.3) format. To see the full name mount the CD manually using the -o rr (rockridge extensions) flag.

    If you have copied the downloaded package or copied the file to another location verify the location and go on to the next step.

  3. Change to the directory on the CD or to the directory where you have copied or downloaded the package.
  4. Copy the package corresponding to your host operating system and processor type to a directory on the local system where you have read and write access.

    The following table lists the platform options and the associated processor:

    Platform File name host label Processor type

    AIX

    aix5.x.tgz

    NA

    Debian/Ubuntu

    deb5--i386.tgz

    32-bit Intel architecture

    deb5-x86_64.tgz

    64-bit Intel architecture

    HP UX

    hp11.11.tgz

    PA RISC

    hp11.23-pa.tgz

    PA RISC

    hp11.23-ia64.tgz

    Itanium 64-bit

    Red Hat Enterprise Linux

    rhel3-i386.tgz

    32-bit Intel architecture

    rhel3-x86_64.tgz

    64-bit Intel architecture

    Solaris

    sol8.tgz

    SPARC

    sol9-x86.tgz

    32-bit Intel architecture

    SuSE

    suse8-i386.tgz

    32-bit Intel architecture

    suse8-x86-64.tgz

    64-bit Intel architecture

    Note:   Host labels can change over time. See the release notes for the most current information.

  5. Un-zip and -tar the package using the native commands. Then run the installation command corresponding to the target computer platform. The following table shows the default commands for installing the package in different operating environments. (You are not required, however, to use these commands. Use the commands with which you are familiar.)

    To install on Do this

    Red Hat Enterprise Linux

    Once you have extracted the file run the following Red Hat Package Manager (RPM) command:

    rpm -Uvh centrifydc-apache-package.rpm

    For example, if you want to install on a Red Hat Enterprise Linux server with a 32-bit processor, you would install the software by typing:

    rpm -Uvh centrifydc-apache-ver-rhel3-i386.rpm

    SuSE Linux

    OpenSuSE Linux

    Once you have extracted the file run the following command:

    rpm -Uvh centrifydc-apache-package.rpm

    For example, if you want to install on a SuSE server with a 32-bit processor, you would install the software by typing:

    rpm -Uvh centrifydc-apache-ver-suse8-i386.rpm

    Debian Linux

    Ubuntu Linux

    Once you have extracted the file run the following command:

    dpkg -i centrifydc-apache-platform.deb

    For example, if you want to install on a Debian 5 server, you would install the software by typing:

    dpkg -i centrifydc-apache-ver-deb5-i386.deb

    Solaris

    Once you have extracted the file, run the following command:

    pkgadd -d CentrifyDC-Apache

    HP-UX

    Once you have unzipped the file, run the following command:

    swinstall -s /path/centrifydc-apache-ver-package.depot

    where package is either hp11.11-pa, hp11.23-pa or hp11.23-ia64.

    For example,

    swinstall -s /path/centrifydc-apache-ver-hp11.23-ia64.depot

    installs the package for systems with Itanium processors.

    Note that you must specify the full path to the Centrify for Apache depot file.

    AIX

    Once you have unzipped the file, create the .toc file by running the following command:

    inutoc .

    Then install the software by running the following command:

    installp -a -d . CentrifyDC.apache

The install process unpacks the shared object library for several Apache versions and authentication method (Active Directory and AD FS) and a configuration file that simplifies loading.

The shared object libraries are in the following form:

  • Active Directory authentication: mod_auth_centrifydc_xx
  • AD FS authentication: mod_adfs_centrifydc_xx

where xx is the Apache version number 20 (for 2.0), 22 (for 2.2) and 24 (for 2.4).

For most targets the extension is .so. The lone exceptions is the shared library for the HP UX on the PA RISC platform which has a .sl extension and for AIX which has the extension so.0.

The sample configuration file is also version-dependent. It has the following format:

centrifyxx[_64].conf

where xx indicates the Apache version. If the file name contains _64, it indicates the version you use on platforms with a 64-bit processor.

The following sections list the shared library and configuration file directories for each platform supported and the files that are provided.