Installation

 Top

 Step 1: Compilation

  • Get the latest mod_parmguard archive and expand it under a directory (for example /usr/local/) with the commands

    # cd /usr/local
    # tar xvfz mod_parmguard-1.1.tar.gz
    # cd mod_parmguard-1.1

  • Run ./configure with at least one of these options:

    --with-apxs=[path to apxs]     (for Apache 1.x) or
    --with-apxs2=[path to apxs]    (for Apache 2.x)

    If the include files for the libxml2 library are not installed in one of the standard directories, you must add the following directives:

    --with-libxml2dir=[dir]    (default=/usr/include/libxml2)

    Example:

    ./configure \
         --with-libxml2dir=/usr/local/include/libxml2 \
         --with-apxs=/usr/sbin/apxs

  • Run make
  • Run make install

    apxs will copy the module mod_parmguard.so under the Apache module directory.
     
  • Add the following directives in the Apache Server Configuration File:

    # for Apache 1.x:
    LoadModule parmguard_module modules/mod_parmguard.so
    AddModule mod_parmguard.c

    # for Apache 2.x:
    LoadModule parmguard_module libexec/mod_parmguard.so

  • For safety reason, check and adjust the owner and group name of the newly added mod_parmguard.* files copied under the Apache "libexec" or "modules" directory.

 Step 2: Apache Server Configuration

  • Configure the Apache Server as explained in the Configuration document.
     
  • Restart Apache:
    # /etc/init.d/httpd restart

    If the server does not restart successfully, the error message should be explanatory:
    it's probably due to a mispelled configuration directive or a syntax error in the XML Configuration File.
    If you get no error, you can activate the ParmguardTrace debug directive.

    If it does not help, please make sure the "libxml2.so" library is in a standard Path. If not, set the good value to the LDFLAGS environment variable and recompile the module.

www.trickytools.com