XML Publishing with AxKit

Testing the Installation

AxKit’s distribution comes with a fairly complete test suite that typically runs as part of the installation process. Running the make test command in the root of the AxKit source directory fires up a new instance of the Apache server on an alternate port with AxKit enabled. It then examines the output of a series of test requests made to that instance that exercise various aspects of AxKit’s functionality. make test runs automatically by default if you are installing AxKit via the CPAN shell. If all test scripts pass during the make test process, you can be sure that you have a working AxKit installation and are ready to proceed.

In addition to the automated test suite, AxKit comes with a set of demonstration files that you can also use to test your new installation. To install the demo, copy the demo directory and its contents from the root of the AxKit distribution into an appropriate directory to which you have write access. The configuration file in the demo directory presumes that you will copy the demo directory into /opt/axkit. So if you choose another location, be sure to edit all paths in the demo’s axkit.conf file to reflect your choice.

Before the demo will work, you need to include the axkit.conf contained in the new demo directory into your server’s httpd.conf file. For example, if you installed the demo in /opt/axkit (again, the default), you would add the following:

# AxKit Demo
Include /opt/axkit/demo/axkit.conf

Start (or stop and restart) ...