$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):
-- First, make sure that the IRSpy code runs OK outside the context of
a web-server. Build and test it as you would any Perl module, with
"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. 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
-- Include this configuration in that of the web server. For example,
if you're using the Apache 1.3 setup that is the default on
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 ."
-- Make sure that you can read the logs that it generates: for
example, you might use:
# chmod ugo+r access.log error.log
-- 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 \
libapache-reload-perl
-- Ensure that the web server can write the HTML::Mason object
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.