From e2e3d26515221c3ddc8968393716e68662c588ce Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Fri, 19 Feb 2010 17:34:42 +0000 Subject: [PATCH] Many changes to installation sections. --- doc/book.xml | 72 ++++++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 48 insertions(+), 24 deletions(-) diff --git a/doc/book.xml b/doc/book.xml index be55bed..f0e477c 100644 --- a/doc/book.xml +++ b/doc/book.xml @@ -312,14 +312,15 @@
- Installation of test1 interface + Installation of test interfaces - 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. + In this section we show how to make available the set of simple + interfaces that are part of the Pazpar2 source package, and which + demonstrate some ways to use Pazpar2. (Note that Debian users can + save time by just installing the package pazpar2-test1.) - A web server must be installed and running on the system, such as Apache. + A web server, such as Apache, must be installed and running on the system. @@ -337,31 +338,51 @@ ..\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 requests to port 80 on localhost, 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 + if this is to be changed. The pazpar2.cfg file 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 test UIs are located in www. Ensure that this + directory is available to the web server by copying + www to the document root, + using Apache's Alias directive, or + creating a symbolic link: for example, on a Debian or Ubuntu + system with Apache2 installed from the standard package, you might + make the link as follows: + + cd .../pazpar2 + sudo ln -s `pwd`/www /var/www/pazpar2-demo + - + - 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. + This makes the test applications visible at + + but they can not be run successfully from that URL, as they submit + search requests back to the server form which they were served, + and Apache2 doesn't know how to handle them. Instead, the test + applications must be accessed from Pazpar2 itself, acting as a + proxy to Apache2, at the URL + - The interface test1 interface should now be available on port 8004. + From here, the demo applications can be + accessed: test1, test2 and + jsdemo + are pure HTML+JavaScript setups, needing no server-side + intelligence; + demo + requires PHP on the server. - 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. + If you don't see the test interfaces, check whether they are available + on port 80 (i.e. directly from the Apache2 server). If not, the + Apache configuration is incorrect. In order to use Apache as frontend for the interface on port 80 @@ -371,12 +392,15 @@
- Installation on Debian GNU/Linux - - Index Data provides Debian packages for Pazpar2. These are prepared - for Debian versions Etch and Lenny (as of 2007). - These packages are available at - . + Installation on Debian or Ubuntu GNU/Linux + + Index Data provides Debian and Ubuntu packages for Pazpar2. + As of February 2010, these + are prepared for Debian versions Etch, Lenny and Squeeze; and for + Ubuntu versions 8.04 (hardy), 8.10 (intrepid), 9.04 (jaunty) and + 9.10 (karmic). These packages are available at + and + .
-- 1.7.10.4