html/installation-5.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2 <HTML>
   3 <HEAD>
   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">
  10 </HEAD>
  11 <BODY>
  12 <A HREF="installation-6.html">Next</A>
  13 <A HREF="installation-4.html">Previous</A>
  14 <A HREF="installation.html#toc5">Contents</A>
  15 <HR>
  16 <H2><A NAME="s5">5. Installing the software</A></H2>
  17
  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:-
  23 <P>
  24 <BLOCKQUOTE><CODE>
  25 <PRE>
  26 copy c:\spider\perl\DXVars.pm.issue
  27 c:\spider\local\DXVars.pm
  28 </PRE>
  29 </CODE></BLOCKQUOTE>
  30 <P>Now you'll need to edit this file using a text editor. If nothing
  31 else, you can simply
  32 <P>
  33 <BLOCKQUOTE><CODE>
  34 <PRE>
  35 cd \spider\local
  36 </PRE>
  37 </CODE></BLOCKQUOTE>
  38 <P>and then
  39 <P>
  40 <BLOCKQUOTE><CODE>
  41 <PRE>
  42 notepad DXVars.pm
  43 </PRE>
  44 </CODE></BLOCKQUOTE>
  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:-
  47 <P>
  48 <UL>
  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>
  52 </UL>
  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
  56 else in this file.
  57 <P>
  58 <H2><A NAME="ss5.1">5.1 The AGW packet engine</A>
  59 </H2>
  60
  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:-
  64 <P>
  65 <BLOCKQUOTE><CODE>
  66 <PRE>
  67 copy c:\spider\perl\AGWConnect.pm
  68 c:\spider\local\AGWConnect.pm
  69 </PRE>
  70 </CODE></BLOCKQUOTE>
  71 <P>and then
  72 <P>
  73 <BLOCKQUOTE><CODE>
  74 <PRE>
  75 notepad AGWConnect.pm
  76 </PRE>
  77 </CODE></BLOCKQUOTE>
  78 <P>to bring up an editor window containing the file. You must
  79 consider adjusting the following items in AGWConnect.pm:-
  80 <P>
  81 <UL>
  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>
  85 </UL>
  86 <P>
  87 <H2><A NAME="ss5.2">5.2 Setting up the initial user files</A>
  88 </H2>
  89
  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:-
  92 <P>
  93 <BLOCKQUOTE><CODE>
  94 <PRE>
  95 cd \spider\perl
  96 perl create_sysop.pl
  97 </PRE>
  98 </CODE></BLOCKQUOTE>
  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
 101 returned.
 102 <P>Depending on how brave you are, you might now care to try the
 103 following:-
 104 <P>
 105 <BLOCKQUOTE><CODE>
 106 <PRE>
 107 perl cluster.pl
 108 </PRE>
 109 </CODE></BLOCKQUOTE>
 110 <P>If you did everything you were told, your DOS window will now
 111 hold a display which looks something like:-
 112 <P>
 113 <BLOCKQUOTE><CODE>
 114 <PRE>
 115 DXSpider DX Cluster Version 1.47
 116 Copyright (c) 1998-2001 Dirk Koopman G1TLH
 117 loading prefixes ...
 118 loading band data ...
 119 loading user file system ...
 120 starting listeners ...
 121 Internal port: localhost 27754
 122 load badwords: Ok
 123 reading in duplicate spot and WWV info ...
 124 reading existing message headers ...
 125 load badmsg: Ok
 126 load forward: Ok
 127 load swop: Ok
 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 ...
 136 queue msg (0)
 137 </PRE>
 138 </CODE></BLOCKQUOTE>
 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:-
 143 <P>
 144 <BLOCKQUOTE><CODE>
 145 <PRE>
 146 cd \spider\perl
 147 perl winclient.pl
 148 </PRE>
 149 </CODE></BLOCKQUOTE>
 150 <P>If you are rewarded with a display which looks something like:-
 151 <P>
 152 <BLOCKQUOTE><CODE>
 153 <PRE>
 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 >
 157 </PRE>
 158 </CODE></BLOCKQUOTE>
 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)
 163 <P>
 164 <H2><A NAME="ss5.3">5.3 Incoming telnets</A>
 165 </H2>
 166
 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:-
 170 <P>
 171 <BLOCKQUOTE><CODE>
 172 <PRE>
 173 copy \spider\perl\listeners.pm \spider\local
 174 cd \spider\local
 175 notepad listeners.pm
 176 </PRE>
 177 </CODE></BLOCKQUOTE>
 178 <P>The following lines need attention:-
 179 <P>
 180 <BLOCKQUOTE><CODE>
 181 <PRE>
 182 ["0.0.0.0", 7300],
 183 </PRE>
 184 </CODE></BLOCKQUOTE>
 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.
 193 <P>
 194 <H2><A NAME="ss5.4">5.4 Connecting to other clusters</A>
 195 </H2>
 196
 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
 203 for you.
 204 <P>
 205 <HR>
 206 <A HREF="installation-6.html">Next</A>
 207 <A HREF="installation-4.html">Previous</A>
 208 <A HREF="installation.html#toc5">Contents</A>
 209 </BODY>
 210 </HTML>