add an RBN line to progress

[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!
 
-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
-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)
 
-'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