1 $Id: README,v 1.1 2006-09-20 13:32:02 mike Exp $
3 To install the web UI (assuming you're using some version of Apache as
6 -- First, make sure that the IRSpy code runs OK outside the context of
7 a web-server. Build and test it as you would any Perl module, with
8 "perl Makefile.PL && make && make test". There's no need to
9 install it, though. Among the prerequisites are ZOOM-Perl and
10 XML::LibXML::XPathContext: unfortunately neither of these is
11 packaged for Debian, so they must be installed from CPAN. You'll
12 also need a 2.0-series Zebra installation to run the database.
14 -- Make a config file for the host you're on, probably by making a
15 modified copy of apache1.3/xeno.conf
17 -- Include this configuration in that of the web server. For example,
18 if you're using the Apache 1.3 setup that is the default on
19 Debian-based operating systems, go to /etc/apache/conf and:
20 # ln -s /usr/local/src/cvs/irspy/web/conf/apache1.3/XXX.conf irspy.conf
22 -- Make sure that the web-server's user (often root, www-data or
23 nobody) can write the logs in in the ../logs directory: for
24 example, you might use "chmod ugo+w ."
26 -- Make sure that you can read the logs that it generates: for
27 example, you might use:
28 # chmod ugo+r access.log error.log
30 -- Make sure you have the HTML::Mason Perl module installed, including
31 all its prerequisites (most notably mod_perl itself). On
32 Debian-based operating systems, this is as simple as
33 # apt-get install libhtml-mason-perl libapache-request-perl
35 -- Ensure that the web server can write the HTML::Mason object
36 directory. For example: "chmod ugo+w data/obj"
38 That should be everything: just start Zebra, point your browser to the
39 root of your new virtual host, and off you go.