runs on new VM berwick
[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
31 you may need one of the following packages for development:
32
33 sudo apt-get install \
34         make perl-doc libxml2-utils tidy yaz libyaz4-dev 
35
36 and may enable mod_apreq: sudo a2enmod apreq
37
38 Note: mod_perl works only safe without threads. Please use the non-threaded 
39 debian package: sudo apt-get install apache2-mpm-prefork
40
41
42 To install this module type the following:
43
44    perl Makefile.PL
45    make
46    make test
47    make install
48
49 DEPENDENCIES
50
51 This module requires these other modules and libraries, in addition to
52 those specified in Makefile.PL:
53
54   Zebra, release 2.0 or later: see http://www.indexdata.com/zebra/
55
56 COPYRIGHT AND LICENCE
57
58 Copyright (C) 2006-2010 by Index Data ApS.
59
60 This library is free software; you can redistribute it and/or modify
61 it under the same terms as Perl itself, either Perl version 5.8.7 or,
62 at your option, any later version of Perl 5 you may have available.
63
64 --
65
66 Notes to self: everyone else please ignore these
67
68 $ 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
69
70 To get a list of all Danish domains in the database:
71 .../ZOOM-Perl/samples/zoom/zselect -t q localhost:8018/IR-Explain---1 'net.host = *.dk' //zeerex:host
72