add CTY-3304
[spider.git] / html / adminmanual_en-7.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <HTML>
3 <HEAD>
4  <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
5  <TITLE>The DXSpider Administration Manual v1.51: Java Web applet</TITLE>
6  <LINK HREF="adminmanual_en-8.html" REL=next>
7  <LINK HREF="adminmanual_en-6.html" REL=previous>
8  <LINK HREF="adminmanual_en.html#toc7" REL=contents>
9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
10 </HEAD>
11 <BODY>
12 <A HREF="adminmanual_en-8.html">Next</A>
13 <A HREF="adminmanual_en-6.html">Previous</A>
14 <A HREF="adminmanual_en.html#toc7">Contents</A>
15 <HR>
16 <H2><A NAME="s7">7.</A> <A HREF="adminmanual_en.html#toc7">Java Web applet</A></H2>
17
18 <P>In the spider tree will be a directory <EM>spider-web</EM>.  This is a
19 neat little java web applet that can be run from a website.  The applet
20 must run on the same machine as the cluster.  The included README file is
21 shown below.</P>
22
23 <P>I should comment here that the applet is precompiled, that is, ready to go.
24 It was compiled using JDK1.3.1.  If your version is earlier than this then it
25 may not work.  Should that be the case you need to recompile or update your
26 JDK.  To recompile do the following ...</P>
27 <P>
28 <BLOCKQUOTE><CODE>
29 <PRE>
30 cd /spider/spider-web
31 rm *.class
32 /usr/bin/javac spiderclient.java
33 </PRE>
34 </CODE></BLOCKQUOTE>
35 </P>
36
37 <P>I have used /usr/bin/javac as an example, your path to javac may be different.</P>
38 <P>
39 <PRE>
40 Spider-WEB v0.6b
41
42 Completely based on a clx web client written in Java by dl6dbh
43 (ftp://clx.muc.de/pub/clx/clx-java_10130001.tgz)
44
45 The webserver has to run on the same machine as your DxSpider software!
46
47 It is assumed that you have Java installed.  You need JDK1.3.1 at least.
48
49 Installation instructions (Performed as root):
50
51 Put all the files in the spider-web directory into a newly created directory
52 under the DocumentRoot of your websever for instance 'client'. In my case
53 this is:  /home/httpd/html/client/ although ymmv.  For Suse the correct
54 path should be /usr/local/httpd/htdocs/client/ for example.
55
56 Move spider.cgi to the cgi-bin directory of your webserver, in my case that is
57 /home/httpd/cgi-bin/ although ymmv.  For Suse the correct path should be
58 /usr/local/httpd/cgi-bin/ for example.
59
60 Change the permissions of the files to ensure they are correct, obviously you
61 will need to use the correct path the the files according to your system:
62
63 chmod 755 /home/httpd/html/cgi-bin/spider.cgi
64 chmod -R 755 /home/httpd/html/client/
65
66 By default the spider.cgi script should pick up your hostname (As long as this
67 is set correctly).  If it does not or your hostname differs from the name that
68 you attach to the public address that you are using, then edit spider.cgi :
69
70 # Uncomment and set the hostname manually here if the above fails.
71 # $HOSTNAME = "gb7mbc.spoo.org" ;
72 $PORT = "8000" ;
73
74 'HOSTNAME' is the hostname of your cluster.
75
76 'PORT' is the portnumber that you use to connect to your DxSpider via
77 telnet (see Listeners.pm)
78
79 NOTE: If you can start the console but cannot connect to the cluster from it,
80 then it is possible that the machine you are on cannot resolve the hostname of 
81 your cluster machine.  If this is the case, you need to set your hostname 
82 manually as above.
83
84 You also need to set the $NODECALL variable.  This prints the name of your
85 choosing (probably your cluster callsign) on the html page.
86
87 You now can connect to Spider-Web via http://yourserver/cgi-bin/spider.cgi
88 </PRE>
89 </P>
90
91 <HR>
92 <A HREF="adminmanual_en-8.html">Next</A>
93 <A HREF="adminmanual_en-6.html">Previous</A>
94 <A HREF="adminmanual_en.html#toc7">Contents</A>
95 </BODY>
96 </HTML>