add logging of PC92A ip addresses
[spider.git] / spider-web / README
1 Spider-WEB v0.6b
2
3 Completely based on a clx web client written in Java by dl6dbh
4 (ftp://clx.muc.de/pub/clx/clx-java_10130001.tgz)
5
6 The webserver has to run on the same machine as your DxSpider software!
7
8 It is assumed that you have Java installed.  You need JDK1.3.1 at least.
9
10 Installation instructions (Performed as root):
11
12 Put all the files in the spider-web directory into a newly created directory
13 under the DocumentRoot of your websever for instance 'client'. In my case
14 this is:  /home/httpd/html/client/ although ymmv.  For Suse the correct
15 path should be /usr/local/httpd/htdocs/client/ for example.
16
17 Move spider.cgi to the cgi-bin directory of your webserver, in my case that is
18 /home/httpd/cgi-bin/ although ymmv.  For Suse the correct path should be
19 /usr/local/httpd/cgi-bin/ for example.
20
21 Change the permissions of the files to ensure they are correct, obviously you
22 will need to use the correct path the the files according to your system:
23
24 chmod 755 /home/httpd/html/cgi-bin/spider.cgi
25 chmod -R 755 /home/httpd/html/client/
26
27 By default the spider.cgi script should pick up your hostname (As long as this
28 is set correctly).  If it does not or your hostname differs from the name that
29 you attach to the public address that you are using, then edit spider.cgi :
30
31 # Uncomment and set the hostname manually here if the above fails.
32 # $HOSTNAME = "gb7mbc.spoo.org" ;
33 $PORT = "8000" ;
34
35 'HOSTNAME' is the hostname of your cluster.
36
37 'PORT' is the portnumber that you use to connect to your DxSpider via
38 telnet (see Listeners.pm)
39
40 NOTE: If you can start the console but cannot connect to the cluster from it, 
41 then it is possible that the machine you are on cannot resolve the hostname of 
42 your cluster machine.  If this is the case, you need to set your hostname 
43 manually as above.
44
45 You also need to set the $NODECALL variable.  This prints the name of your
46 choosing (probably your cluster callsign) on the html page.
47
48 You now can connect to Spider-Web via http://yourserver/cgi-bin/spider.cgi