]> scm.dxcluster.org Git - spider.git/blob - html/install.html
5ffef8d1e74f459ec5e1dc3e1d6629ac611362fe
[spider.git] / html / install.html
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2 <html>
3   <head>
4     <title>Installing Spider</title>
5   </head>
6
7   <body>
8     <h2>Installing Spider</h2>
9
10     <hr>
11     <address><a href="mailto:djk@tobit.co.uk"></a></address>
12 <!-- Created: Wed Dec  2 16:40:25 GMT 1998 -->
13 <!-- hhmts start -->
14 Last modified: Wed Dec  2 18:19:38 GMT 1998
15 <!-- hhmts end -->
16
17         <p>This version of dxspider requires perl5 (it is written entirely in perl5 and
18         makes extensive use of perl objects). This program is known to work with
19         RedHat 5.1 perl5_004.</p>
20
21         <p>In addition to the standard perl5 distribution you will require to load the
22         the following modules:-</p>
23
24         <ol>  
25           <li> <a href="cpan.html">CPAN</a> - this has a load of the standard extra stuff in it. To load it type:-
26
27       <pre>
28   # perl -MCPAN -e shell
29   cpan> install Bundle::CPAN
30   cpan> q
31      </pre>
32
33                 <p>Please sure there were no errors, be particularly careful when installing
34                   libwww stuff, I would suggest 'no host lookups' and pressing &lt;space> and
35                   enter for each of the offered default hostnames. </p>
36                 
37                 <p>I have monitored a typical load of <a href="cpan.html">CPAN</a> which you can
38                   look at <a href="cpan.html">here</a></p>
39
40           <li> Date::Parse, MLDBM, IO::Select
41   
42                 <p>As you have so carefully loaded it, I suggest you use the CPAN system
43                   above:-</p>
44                 <pre>
45   # perl -MCPAN -e shell
46   cpan> install Date::Parse
47   ..
48   ..
49   cpan> install MLDBM
50   ..
51   ..
52   cpan> install IO::Select
53         </pre>
54                 <p>In order to use IO::Select you will need to </p>
55                 <pre>
56   # cd /root/.cpan/build/IO-1.20  
57   # make install UNINST=1
58         </pre>
59                 <p>The 'cd' is to the place where CPAN sets up its local cache. The example 
60                   shown is for Linux defaults.</p>
61
62           <li> select a user to run the cluster as UNDER _NO_ CIRCUMSTANCES USE ROOT.
63
64                 <p>I say again DO NOT USE root.</p>
65    
66                 <p>Pick an existing user or create a new one. Don't care which. I don't know
67                   your security requirements.</p>
68    
69           <li> login as root (I shall use 'jim' for any examples).<br>
70
71           <li> type in the following:-
72                 <pre>
73    # cd ~jim
74    # tar xvfz spider-x.x.tar.gz
75    # ln -s ~jim/spider /spider
76    # groupadd -g 251 spider       (or another number)
77    # vi /etc/group                (or your favorite editor)
78                 </pre>
79
80                 <p>add jim (or whatever) and root to the group spider
81                   it should look something like:-</p>
82          
83                 <pre>
84      spider:x:251:jim,root
85      :x
86    # chown -R jim.spider spider
87    # find . -type d -exec chmod 2775 {} \;
88    # find . -type f -exec chmod 775 {} \;
89                 </pre>
90                 <p>This last step allows various users of group spider to have write
91                   access to all the directories. Not really needed for now but will 
92                   be useful when web interfaces start to appear.</p>
93
94           <li> if you have any users that require network logins, set them up as real
95                 users with useradd -m &lt;callsign>. Alter the default .bashrc so that it
96                 contains just one line (assuming you use the default bash shell).
97                 
98                 <pre>
99                 exec /spider/perl/client.pl &lt;callsign> telnet
100                 </pre>
101    
102                 <p>Don't forget to give them a real password. This is really for network
103                 cluster logins. The telnet argument does two things, it sets the EOL 
104                 convention to \n rather than AX25's \r and it automatically reduces
105                   the privilege of the &lt;callsign> to a 'safe[r]' level.</p>
106    
107           <li> for incoming AX25 connections you are expected to have got the AX25
108                 utilities setup, tested and working. See the AX25-HOWTO for more info
109                 on this - it really is outside the scope of this document. I would 
110                 recommend using ax25-utils-2.1.42a-5.i386.rpm or above as a starting 
111                 point. DXSpider uses ax25d for incoming connections. You need to have 
112                 entries like this:-
113                 <pre>
114    [ether]                                                                         
115    NOCALL   * * * * * *  L                                                         
116    default  * * * * * *  - jim /spider/perl/client.pl client.pl %u ax25
117    &lt;bbs>
118    NOCALL   * * * * * *  L                                                         
119    default  * * * * * *  - jim /spider/perl/client.pl client.pl %u ax25
120                 </pre>
121
122                 <p>where ether and bbs are appropriate KNOWN WORKING axport and nrport 
123                 names respectively.</p>
124    
125                 <p>Obviously you can use different names, callsigns or whatever for your 
126                   purposes, but it is up to you to get it to work. </p>
127    
128                 <p>Note I use BPQ over ethernet which why I have the port names I have.</p>
129
130           <li>Find your <tt>netrom_call</tt> and <tt>ax25_call</tt> programs (which on
131                 my system live in <tt>/usr/sbin</tt> and chmod them so that they are SUID <tt>root</tt>
132                 <pre>
133    # chown root ax25_call netrom_call
134    # chmod 4775 ax25_call netrom_call
135         </pre>
136         <p>This has to be done to allow you to specify the correct callsigns on outgoing connects</p>
137    
138           <li> login as jim (or whatever)
139                 <pre>
140    $ startx                     (much easier to use X)
141    $ cd /spider
142    $ mkdir local
143    $ mkdir local_cmd
144    $ cp perl/DXVars.pm local
145    $ cd local
146    $ vi DXVars.pm
147                 </pre>
148                 <p>now alter your cluster callsign, sysop callsign and other user info 
149                   as you wish. Note that this a perl file which will parsed and executed
150                   as part of the cluster. If you get it wrong then perl will complain 
151                   when you start the cluster process.</p>
152    
153                 <p><b>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</b><p>
154    
155                 <p>DON'T alter the DXVars.pm (or any other file) in /spider/perl, they are
156                   overwritten with every release. Any files or commands you place in
157                   /spider/local or /spider/local_cmd will automagically be used in preference
158                   to the ones in /spider/perl EVEN whilst the cluster is running!</p>
159                 <pre>
160    :x
161    
162    $ cd ../perl
163                 </pre>
164
165                 <p>now create the basic user file with you as the sysop.</p>
166                 <pre>
167    $ create_sysop.pl
168                 </pre>
169
170                 <p>try and run the cluster program and see whether all the various rivets are
171                   flying in approximate formation...</p>
172                 
173                 <pre>
174    $ cluster.pl
175    DXSpider DX Cluster Version x.x
176    Copyright (c) 1998 Dirk Koopman G1TLH
177    loading prefixes ...
178    loading band data ...
179    loading user file system ...
180    starting listener ...
181    reading existing message headers
182    reading cron jobs
183    orft we jolly well go ...
184                 </pre>
185    
186           <li> now log in again or start another rxvt or xterm
187                 <pre>
188    $ client.pl
189                 </pre>
190
191                 <p>you should now see a normal cluster prompt.</p>
192    
193                 <p>at the cluster prompt:-</p>
194                 <pre>
195    G1JIM de GB7JIM 10-Sep-98 1000Z> set/node GB7XXX
196         </pre>
197
198    <p>for every dxcluster you expect to connect to or from.</p>
199
200                 <pre>
201    G1JIM de GB7JIM 10-Sep-98 1001Z> shutdown
202                 </pre>
203
204                 <p>The cluster and the client should both go back to prompts
205    
206                 <p>Restart the cluster.
207    
208                 <p>The callsigns should be the sysop callsign and the cluster callsign
209                   as per your modified DXVars.pm. You can check that the cluster 
210                   connections will work by:-
211                 <pre>
212    $ client.pl gb7xxx      (doesn't have to be uppercase).
213    PC38^GB7JIM^~           <- the cluster thinks this is a cluster
214    ^C                      <- to get out
215         </pre>
216         </ol>
217    
218         <hr>
219         <h5>Version: $Id$</h5>
220   </body>
221 </html>