Link to "#"; previously the link was to "" which caused a reload --

[irspy-moved-to-github.git] / web / conf / README

diff --git a/web/conf/README b/web/conf/README
index 63a2529..9761991 100644 (file)
--- a/web/conf/README
+++ b/web/conf/README
@@ -1,4 +1,4 @@
-$Id: README,v 1.2 2006-10-24 23:05:13 mike Exp $
+$Id: README,v 1.5 2006-10-31 14:17:54 sondberg Exp $
 
 To install the web UI (assuming you're using some version of Apache as
 your web server):
@@ -8,8 +8,22 @@ your web server):
    "perl Makefile.PL && make && make test".  There's no need to
    install it, though.  Among the prerequisites are ZOOM-Perl and
    XML::LibXML::XPathContext: unfortunately neither of these is
-   packaged for Debian, so they must be installed from CPAN.  You'll
-   also need a 2.0-series Zebra installation to run the database.
+   packaged for Debian, so they must be installed from CPAN. If you insist
+   on installing these packages as debian packages, first install the
+   tool dh-make-perl, i.e. apt-get install dh-make-perl. Then execute this:
+
+     dh-make-perl --build --cpan XML::LibXML::XPathContext
+
+   After a lot of output has been generated, you should have a .deb file one
+   directory step back. Install it using dpkg -i package-xxx.deb. For the
+   IRSpy package, just cd into the base directory of the source tree, and
+   execute
+
+     dh-make-perl --build
+
+   which will give you a .deb package one directory step back.
+   
+   You'll also need a 2.0-series Zebra installation to run the database.
 
 -- Make a config file for the host you're on, probably by making a
    modified copy of apache1.3/xeno.conf
@@ -19,6 +33,9 @@ your web server):
    Debian-based operating systems, go to /etc/apache/conf.d and:
        # ln -s /usr/local/src/cvs/irspy/web/conf/apache1.3/XXX.conf irspy.conf
 
+-- Restart the web-server or otherwise tell it about the change to its
+   configurations, for example using "apachectl restart".
+
 -- Make sure that the web-server's user (often root, www-data or
    nobody) can write the logs in in the ../logs directory: for
    example, you might use "chmod ugo+w ."
@@ -30,10 +47,12 @@ your web server):
 -- Make sure you have the HTML::Mason Perl module installed, including
    all its prerequisites (most notably mod_perl itself).  On
    Debian-based operating systems, this is as simple as
-       # apt-get install libhtml-mason-perl libapache-request-perl
+       # apt-get install libhtml-mason-perl libapache-request-perl \
+                          libapache-reload-perl
 
 -- Ensure that the web server can write the HTML::Mason object
-   directory.  For example: "chmod ugo+w data/obj"
+   directory and cache directory.  For example:
+       chmod ugo+w data/obj data/cache
 
 That should be everything: just start Zebra, point your browser to the
 root of your new virtual host, and off you go.