3. Installation of test1 interface

In this section we outline how to install a simple interface that is part of the Pazpar2 source package. Note that Debian users can save time by just installing package pazpar2-test1.

A web server must be installed and running on the system, such as Apache.

Start the Pazpar2 daemon using the 'in-source' binary of the Pazpar2 daemon. On Unix the process is:

     cd etc
     cp pazpar2.cfg.dist pazpar2.cfg
     ../src/pazpar2 -f pazpar2.cfg
    

And on Windows:

     cd etc
     copy pazpar2.cfg.dist pazpar2.cfg
     ..\bin\pazpar2 -f pazpar2.cfg
    

This will start a Pazpar2 listener on port 9004. It will proxy HTTP requests to localhost - port 80, which we assume will be the regular HTTP server on the system. Inspect and modify pazpar2.cfg as needed if this is to be changed. The pazpar2.cfg includes settings from the file settings/edu.xml to use for searches.

Make a new console and move to the other stuff. For more information about pazpar2 options refer to the manpage.

The test1 UI is located in www/test1. Ensure this directory is available to the web server by either copying test1 to the document root, create a symlink or use Apache's Alias directive.

The interface test1 interface should now be available on port 8004.

If you don't see the test1 interface. See if test1 is really available on the same URL but on port 80. If it's not, the Apache configuration (or other) is not correct.

In order to use Apache as frontend for the interface on port 80 for public access etc., refer to Section 5, “Apache 2 Proxy”.