83042b0497483be0dbae6f09a7c789a2388d8044
[spider.git] / sgml / spiderCVS.sgml
1 <!doctype linuxdoc system>
2
3 <article>
4
5 <!-- Title information -->
6
7 <title>The DXSpider CVS Changes addendum 
8 <author>Ian Maude, G0VGS, (ianmaude@btinternet.com)
9 <date>Version 0.1 March 2001
10 <abstract>
11 A reference for CVS users of the DXSpider DXCluster program.
12 </abstract>
13
14 <!-- Begin the document -->
15
16 <P>
17 If you have any problems with a new CVS version please mail the support
18 list or come and report on WW Convers channel 9000 or from a 44 host to
19 sys2.pa4ab.ampr.org (44.137.44.16) port 6667 (IRC) and join #9000.
20
21 <P>
22 The latest CVS is version 1.47.  There are major changes going on currently
23 as the code is altered to allow DXSpider to be run under Microsoft Windows.
24
25 There is a separate file for the Windows installation in the /spider/html 
26 and /spider/txt directories so I will not include that here.
27
28 For Linux users, there are several steps to complete to update from
29 version 1.46.
30
31 PLEASE READ ALL THE FOLLOWING BEFORE STARTING
32
33 <itemize>
34 <item>tar up your existing perl and cmd directories and put them somewhere
35 safe so you can revert to the old version if necessary.
36 <item>Do a CVS update in the normal way (cvs update -d)
37 <item>cp /spider/perl/Listeners.pm to /spider/local and edit it as below
38 <item>comment out the spdlogin line in inetd.conf and 'killall -HUP inetd'
39 <item>"make" the client in /spider/src (just in case it has changed)
40 <item>restart the cluster and pray :-)
41 </itemize>
42
43 The Listeners.pm file looks something like this ...
44
45 <tscreen><verb>
46 #
47 # Copy this file to /spider/local and modify it to your requirements
48 #
49 #
50 # This file specifies which local interfaces and ports you will be
51 # listening on
52 #
53 # You can add as many as you like
54 #
55
56 package main;
57
58 use vars qw(@listen);
59
60 @listen = (
61 #                  ["localhost", 7300],
62 #                  ["foo.dxcluster.net", 7300],
63                   );
64  
65 1;
66 </verb></tscreen>
67
68 Alter the hostnames and ports to reflect you setup.  This file is only
69 used for incoming telnet requests.  You do not have to use hostnames, it
70 is quite ok to use IP addresses and it is also a matter of choice whether
71 or not you add the domain.
72
73 Here is an example of a working Listeners.pm file ..
74
75 <tscreen><verb>
76 @listen = (
77                    ["localhost", 8000],
78                    ["sys2", 8000],
79                    ["apu", 8000],
80                   );
81 </verb></tscreen>
82
83 Now all this is well and good if you have a static IP address.  If your IP
84 address is dynamic then one line will do, like this ...
85
86 <tscreen><verb>
87 @listen = (
88                    ["0.0.0.0", 8000],
89                   );
90 </verb></tscreen>
91
92 From this version, the file client.pl has ceased to be needed.  In fact it
93 has been removed.  If you are still using client.pl in your ax25d.conf then
94 replace it with /spider/src/client.
95
96 </article>