Now (apparent) apparently working

[spider.git] / spider-web / README

diff --git a/spider-web/README b/spider-web/README
index b32b7c3b2b930a78a07cd1e27820f62f4a0e9cfe..e31fc6aae6adf82f4f7904bb2f3a95ec2d33962d 100644 (file)
--- a/spider-web/README
+++ b/spider-web/README
@@ -5,33 +5,44 @@ Completely based on a clx web client written in Java by dl6dbh
 
 The webserver has to run on the same machine as your DxSpider software!
 
 
 The webserver has to run on the same machine as your DxSpider software!
 

-Installation instructions:
+It is assumed that you have Java installed.  You need JDK1.3.1 at least.
+
+Installation instructions (Performed as root):

 
 Put all the files in the spider-web directory into a newly created directory
 
 Put all the files in the spider-web directory into a newly created directory

-under the documentroot of your websever for instance 'client'. In my case
-this is:
-/usr/local/httpd/spider/client/
+under the DocumentRoot of your websever for instance 'client'. In my case
+this is:  /home/httpd/html/client/ although ymmv.  For Suse the correct
+path should be /usr/local/httpd/htdocs/client/ for example.
+
+Move spider.cgi to the cgi-bin directory of your webserver, in my case that is
+/home/httpd/cgi-bin/ although ymmv.  For Suse the correct path should be
+/usr/local/httpd/cgi-bin/ for example.
+
+Change the permissions of the files to ensure they are correct, obviously you
+will need to use the correct path the the files according to your system:

 
 

-================================================================
-!NOTE! this directory has to be writeable by your http daemon!!!!
-=================================================================
+chmod 755 /home/httpd/html/cgi-bin/spider.cgi
+chmod -R 755 /home/httpd/html/client/

 
 

-move spider.cgi to the cgi-bin directory of your webserver, in my case that is
-/usr/local/httpd/cgi-bin/ 
-make it worldreadable.
+By default the spider.cgi script should pick up your hostname (As long as this
+is set correctly).  If it does not or your hostname differs from the name that
+you attach to the public address that you are using, then edit spider.cgi :

 
 

-edit spider.cgi and change  the following parameters:
+# Uncomment and set the hostname manually here if the above fails.
+# $HOSTNAME = "gb7mbc.spoo.org" ;
+$PORT = "8000" ;

 
 

-portnumber=$"1407"
-tempdir=$"/usr/local/httpd/spider/client/"
-clustercall=$"PA4AB-15"
+'HOSTNAME' is the hostname of your cluster.

 
 

-'portnumber' is the portnumber that you use to connect to your DxSpider via
+'PORT' is the portnumber that you use to connect to your DxSpider via

 telnet (see Listeners.pm)
 
 telnet (see Listeners.pm)
 

-'tempdir' is the directory that you just created and that you used to move
-the *.java and *.class files to.
+NOTE: If you can start the console but cannot connect to the cluster from it, 
+then it is possible that the machine you are on cannot resolve the hostname of 
+your cluster machine.  If this is the case, you need to set your hostname 
+manually as above.

 
 

-'clustercall' is the call of your cluster.
+You also need to set the $NODECALL variable.  This prints the name of your
+choosing (probably your cluster callsign) on the html page.

 
 You now can connect to Spider-Web via http://yourserver/cgi-bin/spider.cgi
 
 You now can connect to Spider-Web via http://yourserver/cgi-bin/spider.cgi