1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
4 <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
5 <TITLE>The DXSpider Installation Manual v1.49: Installing the software</TITLE>
6 <LINK HREF="installation-6.html" REL=next>
7 <LINK HREF="installation-4.html" REL=previous>
8 <LINK HREF="installation.html#toc5" REL=contents>
9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
12 <A HREF="installation-6.html">Next</A>
13 <A HREF="installation-4.html">Previous</A>
14 <A HREF="installation.html#toc5">Contents</A>
16 <H2><A NAME="s5">5. Installing the software</A></H2>
18 <P>Ensure that your CVS session or your unZIPped file have left you
19 with a directory "C:\spider\local"; if not, go to "C:\spider\"
20 and create one. If "C:\spider" is missing, go back and figure out
21 why, because it shouldn't be.
22 <P>Now create your own local copy of the DXVars.pm file by:-
26 copy c:\spider\perl\DXVars.pm.issue
27 c:\spider\local\DXVars.pm
30 <P>Now you'll need to edit this file using a text editor. If nothing
45 <P>to bring up an editor window containing the file. As an absolute
46 minimum you must adjust the following items in DXVars.pm:-
49 <LI> $mycall - Should hold the callsign of your DX Cluster</LI>
50 <LI> $myname - The SysOp's first name</LI>
51 <LI> $myalias - the SysOp's callsign. Cannot be the same as $mycall!</LI>
53 <P>You really also ought to update the $mylatitude, $mylongitude,
54 $myqth and $myemail variables. And unless you are absolutely
55 certain you know what you're doing, you should change nothing
58 <H2><A NAME="ss5.1">5.1 The AGW packet engine</A>
61 <P>On the assumption that you'll be using the SV2AGW Packet Engine
62 to interface your radios to the cluster, you should now create
63 your own local copy of AGWConnect.pm by:-
67 copy c:\spider\perl\AGWConnect.pm
68 c:\spider\local\AGWConnect.pm
78 <P>to bring up an editor window containing the file. You must
79 consider adjusting the following items in AGWConnect.pm:-
82 <LI>$enable - set to '1' to enable AGWPE interface </LI>
83 <LI>$login - the login ID you chose when you set up the SV2AGW security :-)</LI>
84 <LI>$passwd - password that matches $login</LI>
87 <H2><A NAME="ss5.2">5.2 Setting up the initial user files</A>
90 <P>Next you need to create the initial user files, etc. A tool is
91 supplied which will do this for you. To run the tool:-
99 <P>If all goes according to plan, you will see no output from this
100 program, and after a brief wait, your DOS prompt will be
102 <P>Depending on how brave you are, you might now care to try the
110 <P>If you did everything you were told, your DOS window will now
111 hold a display which looks something like:-
115 DXSpider DX Cluster Version 1.47
116 Copyright (c) 1998-2001 Dirk Koopman G1TLH
118 loading band data ...
119 loading user file system ...
120 starting listeners ...
121 Internal port: localhost 27754
123 reading in duplicate spot and WWV info ...
124 reading existing message headers ...
128 @msg = 0 before delete
129 @msg = 0 after delete
130 reading cron jobs ...v cron: reading /spider/cmd/crontab
131 cron: adding 1 0 * * 0
132 DXUser::export("$main::data/user_asc")
133 reading database descriptors ...
134 doing local initialisation ...
135 orft we jolly well go ...
139 <P>Now, if that's what you've got, you are very nearly home and dry
140 (in as far as these particular experiments are concerned, anyhow)
141 <P>To access your new cluster (from the local machine) find yourself another
142 "DOS box" and do the following:-
150 <P>If you are rewarded with a display which looks something like:-
154 Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.47
155 Cluster: 1 nodes, 1 local / 1 total users Max users 2 Uptime 0 00:00
156 M0ADI de GB7SJP 4-Mar-2001 1511Z >
159 <P>You've arrived. Try some commands, and see how they feel. (In
160 case you were wondering, "Iain", "M0ADI" and "GB7SJP" all came
161 from the version of DXVars.pm that was on the machine when I
162 started the winclient.pl)
164 <H2><A NAME="ss5.3">5.3 Incoming telnets</A>
167 <P>If you want to enable inbound "TELNET" connections, you've got a
168 little more work to do. From a handy "DOS box" that's not doing
169 anything else, do the following:-
173 copy \spider\perl\listeners.pm \spider\local
178 <P>The following lines need attention:-
185 <P>On my machine, I've simply uncommented the "0.0.0.0" entry by
186 removing the '#' from the front of the line.
187 <P>If you don't have a static hostname for your machine, and you
188 intend to allow folk to connect to your machine across the
189 internet, then I'd suggest you pay a visit to www.dyndns.org and
190 create one for yourself. While it's free, it will take a modest
191 an amount of effort on your part to read, understand and
192 implement what needs to be done to set this up.
194 <H2><A NAME="ss5.4">5.4 Connecting to other clusters</A>
197 <P>If you want to connect this to another cluster, then you'll want
198 to negotiate a link with someone. For experimental purposes, I'm
199 happy to allow folk to connect to GB7DXA (spud.ath.cx), on the
200 understanding that the system may or may not be there and may or
201 may not be connected to anything particularly useful at any given
202 moment. Contact me by Email if you want me to set up a connection
206 <A HREF="installation-6.html">Next</A>
207 <A HREF="installation-4.html">Previous</A>
208 <A HREF="installation.html#toc5">Contents</A>