Generate an automatic UDB only if no explicit one was provided.
[irspy-moved-to-github.git] / README
1 ZOOM::IRSpy
2 ===========
3
4 This module exists to implement the IRspy program, which discovers,
5 analyses and monitors IR servers implementing the Z39.50 and SRU/W
6 protocols.  It is a successor to the ZSpy program.
7
8 INSTALLATION
9
10 for debian/ubuntu:
11 -------------------
12
13 DEBIAN DEPENDENCIES
14
15 If you have a Debian-based operating system, you can get what you need
16 by installing the following packages from the operating system's
17 package store, using apt-get:
18
19 sudo apt-get install \
20         libnet-z3950-zoom-perl \
21         libxml-libxml-perl \
22         liburi-perl \
23         libxml-libxml-perl \
24         libapache2-mod-perl2 \
25         libhtml-mason-perl \
26         libapache2-request-perl \
27         libapache2-mod-apreq2 \
28         libxml-libxslt-perl \
29         idzebra-2.0 \
30         time
31
32 you may need one of the following packages for development:
33
34 sudo apt-get install \
35         make perl-doc libxml2-utils tidy yaz libyaz4-dev 
36
37 and may enable mod_apreq: sudo a2enmod apreq
38
39 Note: mod_perl works only safe without threads. Please use the non-threaded 
40 debian package: sudo apt-get install apache2-mpm-prefork
41
42
43 To install this module type the following:
44
45    perl Makefile.PL
46    make
47    make test
48    make install
49
50 DEPENDENCIES
51
52 This module requires these other modules and libraries, in addition to
53 those specified in Makefile.PL:
54
55   Zebra, release 2.0 or later: see http://www.indexdata.com/zebra/
56
57 COPYRIGHT AND LICENCE
58
59 Copyright (C) 2006-2010 by Index Data ApS.
60
61 This library is free software; you can redistribute it and/or modify
62 it under the same terms as Perl itself, either Perl version 5.8.7 or,
63 at your option, any later version of Perl 5 you may have available.
64
65 --
66
67 Notes to self: everyone else please ignore these
68
69 $ cd /usr/local/src/cvs/irspy && YAZ_LOG=irspy,irspy_test,irspy_debug,pod perl -I lib bin/irspy.pl -t "bagel.indexdata.dk/gils foo.bar.baz:12345/fish z3950.loc.gov:7090/Voyager" localhost:8018/IR-Explain---1
70
71 To get a list of all Danish domains in the database:
72 .../ZOOM-Perl/samples/zoom/zselect -t q localhost:8018/IR-Explain---1 'net.host = *.dk' //zeerex:host
73