html/installation_en-6.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 Installation Manual v1.50: Installing the software</TITLE>
   6  <LINK HREF="installation_en-7.html" REL=next>
   7  <LINK HREF="installation_en-5.html" REL=previous>
   8  <LINK HREF="installation_en.html#toc6" REL=contents>
   9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
  10 </HEAD>
  11 <BODY>
  12 <A HREF="installation_en-7.html">Next</A>
  13 <A HREF="installation_en-5.html">Previous</A>
  14 <A HREF="installation_en.html#toc6">Contents</A>
  15 <HR>
  16 <H2><A NAME="s6">6.</A> <A HREF="installation_en.html#toc6">Installing the software</A></H2>
  17
  18 <P>At this point you will need to create 2 additional directories under
  19 "C:\Spider."  Make directories "C:\spider\local" and "C:\spider\local_cmd".
  20 If "C:\spider" is missing, go back and figure out why, because it shouldn't be.</P>
  21 <P>Now create your own local copy of the DXVars.pm file by:-</P>
  22 <P>
  23 <BLOCKQUOTE><CODE>
  24 <PRE>
  25 copy c:\spider\perl\DXVars.pm.issue
  26 c:\spider\local\DXVars.pm
  27 </PRE>
  28 </CODE></BLOCKQUOTE>
  29 </P>
  30 <P>Now you'll need to edit this file using a text editor like Notepad. If nothing
  31 else, you can simply</P>
  32 <P>
  33 <BLOCKQUOTE><CODE>
  34 <PRE>
  35 cd \spider\local
  36 </PRE>
  37 </CODE></BLOCKQUOTE>
  38 </P>
  39 <P>and then</P>
  40 <P>
  41 <BLOCKQUOTE><CODE>
  42 <PRE>
  43 notepad DXVars.pm
  44 </PRE>
  45 </CODE></BLOCKQUOTE>
  46 </P>
  47 <P>to bring up an editor window containing the file. As an absolute
  48 minimum you must adjust the following items in DXVars.pm:-</P>
  49 <P>
  50 <UL>
  51 <LI> $mycall  - Should hold the callsign of your DX Cluster</LI>
  52 <LI> $myname  - The SysOp's first name</LI>
  53 <LI> $myalias - the SysOp's callsign. Cannot be the same as $mycall!</LI>
  54 <LI> $myqth - The station's geographical location (QTH).</LI>
  55 <LI> $mylatitude - The station latitude in degrees and decimal fractions</LI>
  56 <LI> $mylongitude - The station longitude in degrees and decimal fractions</LI>
  57 <LI> $mylocator - The Maidenhead (or QRA) locator of the station </LI>
  58 </UL>
  59 </P>
  60 <P>You really also ought to update the $myqth and $myemail variables. And
  61 unless you are absolutely certain you know what you're doing, you
  62 should change nothing else in this file. Note that if you use an "@" or
  63 a "$" character in one of the above strings (typically in $myemail) you must
  64 write them as "\@" or "\$". </P>
  65
  66 <H2><A NAME="ss6.1">6.1</A> <A HREF="installation_en.html#toc6.1">Incoming telnets</A>
  67 </H2>
  68
  69 <P>If you want to enable inbound "TELNET" connections (or you are running
  70 Windows 98, NT, 2000 or XP), you've got a little more work to do. From a
  71 handy "DOS box" that's not doing anything else, do the following:-</P>
  72 <P>
  73 <BLOCKQUOTE><CODE>
  74 <PRE>
  75 copy \spider\perl\Listeners.pm \spider\local
  76 cd \spider\local
  77 notepad listeners.pm
  78 </PRE>
  79 </CODE></BLOCKQUOTE>
  80 </P>
  81 <P>The following line need attention:-</P>
  82 <P>
  83 <BLOCKQUOTE><CODE>
  84 <PRE>
  85 #               ["0.0.0.0", 7300],
  86 </PRE>
  87 </CODE></BLOCKQUOTE>
  88 </P>
  89 <P>On my machine, I've simply uncommented the "0.0.0.0" entry by
  90 removing the '#' from the front of the line. </P>
  91 <P><B>You MUST carry out this step if you are
  92 running on a Windows 98, NT, 2000 or XP based system</B></P>
  93 <P>If you don't have a static hostname for your machine, and you
  94 intend to allow folk to connect to your machine across the
  95 internet, then I'd suggest you pay a visit to www.dyndns.org and
  96 create one for yourself. While it's free, it will take a modest
  97 amount of effort on your part to read, understand and
  98 implement what needs to be done to set this up.</P>
  99
 100 <P>If your machine is connected to the internet <B>and</B> you don't
 101 want to allow your machine to be visible to the outside world you
 102 should change the "0.0.0.0" to "127.0.0.1" [which is
 103 "localhost"]. This will then only allow connections from inside your
 104 machine. As was said earlier: if you aren't running Win9x (or you want
 105 to use DXTelnet or somesuch), then you need to have the machine
 106 listening at least to "127.0.0.1" ("0.0.0.0" means <B>all</B> IP
 107 addresses).</P>
 108
 109 <H2><A NAME="ss6.2">6.2</A> <A HREF="installation_en.html#toc6.2">The AGW packet engine</A>
 110 </H2>
 111
 112 <P>On the assumption that you'll be using the SV2AGW Packet Engine
 113 to interface your radios to the cluster, it would be a good idea to
 114 download the Packet Engine software!  You can get this software from:</P>
 115 <P>
 116 <A HREF="http://www.raag.org/sv2agw/agwpe.zip">http://www.raag.org/sv2agw/agwpe.zip</A></P>
 117 <P>Depending upon your TNCs, you may also need to get:</P>
 118 <P>
 119 <A HREF="http://www.raag.org/sv2agw/drivers.zip">http://www.raag.org/sv2agw/drivers.zip</A></P>
 120 <P>A couple of the tools:</P>
 121 <P>
 122 <A HREF="http://www.raag.org/sv2agw/agwterm.zip">http://www.raag.org/sv2agw/agwterm.zip</A></P>
 123 <P>
 124 <A HREF="http://www.raag.org/sv2agw/agwmonitor.zip">http://www.raag.org/sv2agw/agwmonitor.zip</A></P>
 125 <P>will also help with troubleshooting of the RF links themselves.</P>
 126 <P>Install and configure AGWPE.  You should now create your own local copy of
 127 AGWConnect.pm by:-</P>
 128 <P>
 129 <BLOCKQUOTE><CODE>
 130 <PRE>
 131 copy c:\spider\perl\AGWConnect.pm
 132 c:\spider\local\AGWConnect.pm
 133 </PRE>
 134 </CODE></BLOCKQUOTE>
 135 </P>
 136 <P>and then</P>
 137 <P>
 138 <BLOCKQUOTE><CODE>
 139 <PRE>
 140 notepad AGWConnect.pm
 141 </PRE>
 142 </CODE></BLOCKQUOTE>
 143 </P>
 144 <P>to bring up an editor window containing the file. You must
 145 consider adjusting the following items in AGWConnect.pm:-</P>
 146 <P>
 147 <UL>
 148 <LI>$enable - set to '1' to enable AGWPE interface </LI>
 149 <LI>$login  - the login ID you chose when you set up the SV2AGW security :-)</LI>
 150 <LI>$passwd - password that matches $login</LI>
 151 </UL>
 152 </P>
 153 <P>The login ID and passwd only need to be set if you are accessing AGW separately
 154 via its web interface.  This interface is normally not needed for use with DXSpider.</P>
 155
 156 <H2><A NAME="ss6.3">6.3</A> <A HREF="installation_en.html#toc6.3">Setting up the initial user files</A>
 157 </H2>
 158
 159 <P>Next you need to create the initial user files, etc. A tool is
 160 supplied which will do this for you. To run the tool:-</P>
 161 <P>
 162 <BLOCKQUOTE><CODE>
 163 <PRE>
 164 cd \spider\perl
 165 perl create_sysop.pl
 166 </PRE>
 167 </CODE></BLOCKQUOTE>
 168 </P>
 169 <P>If all goes according to plan, you will see no output from this
 170 program, and after a brief wait, your DOS prompt will be
 171 returned.</P>
 172 <P>Depending on how brave you are, you might now care to try the
 173 following:-</P>
 174 <P>
 175 <BLOCKQUOTE><CODE>
 176 <PRE>
 177 perl cluster.pl
 178 </PRE>
 179 </CODE></BLOCKQUOTE>
 180 </P>
 181 <P>If you did everything you were told, your DOS window will now
 182 hold a display which looks something like:-</P>
 183 <P>
 184 <BLOCKQUOTE><CODE>
 185 <PRE>
 186 DXSpider DX Cluster Version 1.50
 187 Copyright (c) 1998-2002 Dirk Koopman G1TLH
 188 loading prefixes ...
 189 loading band data ...
 190 loading user file system ...
 191 starting listeners ...
 192 Internal port: localhost 27754
 193 load badwords: Ok
 194 reading in duplicate spot and WWV info ...
 195 reading existing message headers ...
 196 load badmsg: Ok
 197 load forward: Ok
 198 load swop: Ok
 199 @msg = 0 before delete
 200 @msg = 0 after delete
 201 reading cron jobs ...v cron: reading /spider/cmd/crontab
 202 cron: adding 1 0 * * 0
 203 DXUser::export("$main::data/user_asc")
 204 reading database descriptors ...
 205 doing local initialisation ...
 206 orft we jolly well go ...
 207 queue msg (0)
 208 </PRE>
 209 </CODE></BLOCKQUOTE>
 210 </P>
 211 <P>Now, if that's what you've got, you are very nearly home and dry
 212 (in as far as these particular experiments are concerned, anyhow)</P>
 213 <P>If you are running Windows 9x you can access your new cluster (from
 214 the local machine) by finding yourself another "DOS box" and doing the
 215 following:-</P>
 216 <P>
 217 <BLOCKQUOTE><CODE>
 218 <PRE>
 219 cd \spider\perl
 220 perl winclient.pl
 221 </PRE>
 222 </CODE></BLOCKQUOTE>
 223 </P>
 224 <P>If you are running Windows NT, 2000 or XP then winclient.pl does not
 225 work. We don't know why other than this seems to be some kind of
 226 incomaptibility in perl. You can achieve the same thing by telnetting
 227 to the port you defined in Listeners.pm (7300 as default), thus:-</P>
 228 <P>
 229 <BLOCKQUOTE><CODE>
 230 <PRE>
 231 Menu->Start->Run
 232 telnet localhost 7300
 233 </PRE>
 234 </CODE></BLOCKQUOTE>
 235 </P>
 236 <P>On getting the <B>login:</B> prompt, enter your sysop callsign (the one you
 237 put in DXVars.pm as $myalias).</P>
 238
 239 <P>I would recommend <B>strongly</B> that you obtain a better telnet
 240 client than that which comes with windows (I use
 241 <A HREF="http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY</A>). </P>
 242
 243 <P>Anyway, if you are rewarded with a display which looks something like:-</P>
 244 <P>
 245 <BLOCKQUOTE><CODE>
 246 <PRE>
 247 Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.50
 248 Cluster: 1 nodes, 1 local / 1 total users Max users 2 Uptime 0 00:00
 249 M0ADI de GB7SJP 4-Mar-2001 1511Z >
 250 </PRE>
 251 </CODE></BLOCKQUOTE>
 252 </P>
 253 <P>You've arrived. Try some commands, and see how they feel. (In
 254 case you were wondering, "Iain", "M0ADI" and "GB7SJP" all came
 255 from the version of DXVars.pm that was on the machine when I
 256 started the winclient.pl)</P>
 257
 258 <P>The interface is very basic. It is a simple command line. There are
 259 better looking interfaces. Most of the "standard" logging and DX
 260 Cluster access programs that are capable of connecting via a TCP or
 261 telnet connection will work as a "Sysop Console" client. You connect
 262 to "localhost" on the port that you defined in Listeners.pm (usually
 263 7300). I recommend packages like
 264 <A HREF="http://www.qsl.net/wd4ngb/telnet.htm">DXTelnet</A>.</P>
 265
 266 <H2><A NAME="ss6.4">6.4</A> <A HREF="installation_en.html#toc6.4">Connecting to other clusters</A>
 267 </H2>
 268
 269 <P>If you want to connect this to another cluster, then you'll want to
 270 negotiate a link with someone. For experimental purposes, I'm happy to
 271 allow folk to connect to GB7DXA (spud.ath.cx), on the understanding
 272 that the system may or may not be there and may or may not be
 273 connected to anything particularly useful at any given moment. Contact
 274 me by
 275 <A HREF="mailto:g0rdi@blacksheep.org">Email</A> if you
 276 want me to set up a connection for you.</P>
 277
 278 <HR>
 279 <A HREF="installation_en-7.html">Next</A>
 280 <A HREF="installation_en-5.html">Previous</A>
 281 <A HREF="installation_en.html#toc6">Contents</A>
 282 </BODY>
 283 </HTML>