put dx.pl into an explicit handle sub
[spider.git] / spider-web / README
index 6406d43c2f287ef37355a719f54e96a62e11503b..e31fc6aae6adf82f4f7904bb2f3a95ec2d33962d 100644 (file)
@@ -5,19 +5,24 @@ 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!
 
+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:  /var/www/html/client/
+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
-/var/www/cgi-bin/ 
+/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 :
+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:
 
-chmod 755 /var/www/cgi-bin/spider.cgi
-chmod -R 755 /var/www/html/client/
+chmod 755 /home/httpd/html/cgi-bin/spider.cgi
+chmod -R 755 /home/httpd/html/client/
 
 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
@@ -32,5 +37,12 @@ $PORT = "8000" ;
 'PORT' is the portnumber that you use to connect to your DxSpider via
 telnet (see Listeners.pm)
 
+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.
+
+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