Apache How-To

This page describes how to implement ARM 4 measurements on an Apache 2 server. The version we're using in this How-To is a modified version of the Apache mod_arm4 as implemented by MyArm.

Installing From Source

At this point, binary distributions are unavailable so installation from source is the only option.

Get the Source

Download the source from here

Build the Module

Many Linux distributions will require the Apache development packages to be installed. In particular, you should have the apxs (or apxs2 on some platforms) utility installed.

$ tar xzvf mod_arm4-1.0.1-source.tar.gz
$ cd mod_arm4-1.0.1/src
$ apxs -c -I../include mod_arm4.c

Then, as root

# apxs -i -a -n arm4 mod_arm4.la

This installs the module and adds it to the httpd.conf file.

Configuring Apache

There's a good example configuration file in the source directory at mod_arm4-1.0.1/conf/mod_arm4.conf. For use with the ARM4.org agents, the key change is the ArmLoadLibrary parameter. For the default install, this should be:

ArmLoadLibrary /usr/local/lib/libarm4.so

If the module is unable to find the shared library on start up, it will disable itself and allow Apache to continue on it's merry way.

Once you restart Apache, you should be happily collecting measurements!

SELinux

Most SELinux implementations will have issues. This is being worked out now, and the information will be added as it becomes available.