html/wininstallation-2.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 Installation Guide for DXSpider under Microsoft Windows: Installing the software</TITLE>
   6  <LINK HREF="wininstallation-1.html" REL=previous>
   7  <LINK HREF="wininstallation.html#toc2" REL=contents>
   8 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
   9 </HEAD>
  10 <BODY>
  11 Next
  12 <A HREF="wininstallation-1.html">Previous</A>
  13 <A HREF="wininstallation.html#toc2">Contents</A>
  14 <HR>
  15 <H2><A NAME="s2">2. Installing the software</A></H2>
  16
  17 <P>Ensure that your CVS session or your unZIPped file have left you
  18 with a directory "C:\spider\local"; if not, go to "C:\spider\"
  19 and create one. If "C:\spider" is missing, go back and figure out
  20 why, because it shouldn't be.
  21 <P>Now create your own local copy of the DXVars.pm file by:-
  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>Now you'll need to edit this file using a text editor. If nothing
  30 else, you can simply
  31 <P>
  32 <BLOCKQUOTE><CODE>
  33 <PRE>
  34 cd \spider\local
  35 </PRE>
  36 </CODE></BLOCKQUOTE>
  37 <P>and then
  38 <P>
  39 <BLOCKQUOTE><CODE>
  40 <PRE>
  41 notepad DXVars.pm
  42 </PRE>
  43 </CODE></BLOCKQUOTE>
  44 <P>to bring up an editor window containing the file. As an absolute
  45 minimum you must adjust the following items in DXVars.pm:-
  46 <P>
  47 <UL>
  48 <LI> $mycall  - Should hold the callsign of your DX Cluster</LI>
  49 <LI> $myname  - The SysOp's first name</LI>
  50 <LI> $myalias - the SysOp's callsign. Cannot be the same as $mycall!</LI>
  51 </UL>
  52 <P>You really also ought to update the $mylatitude, $mylongitude,
  53 $myqth and $myemail variables. And unless you are absolutely
  54 certain you know what you're doing, you should change nothing
  55 else in this file.
  56 <P>
  57 <H2><A NAME="ss2.1">2.1 The AGW packet engine</A>
  58 </H2>
  59
  60 <P>On the assumption that you'll be using the SV2AGW Packet Engine
  61 to interface your radios to the cluster, you should now create
  62 your own local copy of AGWConnect.pm by:-
  63 <P>
  64 <BLOCKQUOTE><CODE>
  65 <PRE>
  66 copy c:\spider\perl\AGWConnect.pm
  67 c:\spider\local\AGWConnect.pm
  68 </PRE>
  69 </CODE></BLOCKQUOTE>
  70 <P>and then
  71 <P>
  72 <BLOCKQUOTE><CODE>
  73 <PRE>
  74 notepad AGWConnect.pm
  75 </PRE>
  76 </CODE></BLOCKQUOTE>
  77 <P>to bring up an editor window containing the file. You must
  78 consider adjusting the following items in AGWConnect.pm:-
  79 <P>
  80 <UL>
  81 <LI>$enable - set to '1' to enable AGWPE interface </LI>
  82 <LI>$login  - the login ID you chose when you set up the SV2AGW security :-)</LI>
  83 <LI>$passwd - password that matches $login</LI>
  84 </UL>
  85 <P>
  86 <H2><A NAME="ss2.2">2.2 Setting up the initial user files</A>
  87 </H2>
  88
  89 <P>Next you need to create the initial user files, etc. A tool is
  90 supplied which will do this for you. To run the tool:-
  91 <P>
  92 <BLOCKQUOTE><CODE>
  93 <PRE>
  94 cd \spider\perl
  95 perl create_sysop.pl
  96 </PRE>
  97 </CODE></BLOCKQUOTE>
  98 <P>If all goes according to plan, you will see no output from this
  99 program, and after a brief wait, your DOS prompt will be
 100 returned.
 101 <P>Depending on how brave you are, you might now care to try the
 102 following:-
 103 <P>
 104 <BLOCKQUOTE><CODE>
 105 <PRE>
 106 perl cluster.pl
 107 </PRE>
 108 </CODE></BLOCKQUOTE>
 109 <P>If you did everything you were told, your DOS window will now
 110 hold a display which looks something like:-
 111 <P>
 112 <BLOCKQUOTE><CODE>
 113 <PRE>
 114 DXSpider DX Cluster Version 1.47
 115 Copyright (c) 1998-2001 Dirk Koopman G1TLH
 116 loading prefixes ...
 117 loading band data ...
 118 loading user file system ...
 119 starting listeners ...
 120 Internal port: localhost 27754
 121 load badwords: Ok
 122 reading in duplicate spot and WWV info ...
 123 reading existing message headers ...
 124 load badmsg: Ok
 125 load forward: Ok
 126 load swop: Ok
 127 @msg = 0 before delete
 128 @msg = 0 after delete
 129 reading cron jobs ...v cron: reading /spider/cmd/crontab
 130 cron: adding 1 0 * * 0
 131 DXUser::export("$main::data/user_asc")
 132 reading database descriptors ...
 133 doing local initialisation ...
 134 orft we jolly well go ...
 135 queue msg (0)
 136 </PRE>
 137 </CODE></BLOCKQUOTE>
 138 <P>Now, if that's what you've got, you are very nearly home and dry
 139 (in as far as these particular experiments are concerned, anyhow)
 140 <P>To access your new cluster (from the local machine) find yourself another
 141 "DOS box" and do the following:-
 142 <P>
 143 <BLOCKQUOTE><CODE>
 144 <PRE>
 145 cd \spider\perl
 146 perl winclient.pl
 147 </PRE>
 148 </CODE></BLOCKQUOTE>
 149 <P>If you are rewarded with a display which looks something like:-
 150 <P>
 151 <BLOCKQUOTE><CODE>
 152 <PRE>
 153 Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.47
 154 Cluster: 1 nodes, 1 local / 1 total users Max users 2 Uptime 0 00:00
 155 M0ADI de GB7SJP 4-Mar-2001 1511Z >
 156 </PRE>
 157 </CODE></BLOCKQUOTE>
 158 <P>You've arrived. Try some commands, and see how they feel. (In
 159 case you were wondering, "Iain", "M0ADI" and "GB7SJP" all came
 160 from the version of DXVars.pm that was on the machine when I
 161 started the winclient.pl)
 162 <P>
 163 <H2><A NAME="ss2.3">2.3 Incoming telnets</A>
 164 </H2>
 165
 166 <P>If you want to enable inbound "TELNET" connections, you've got a
 167 little more work to do. From a handy "DOS box" that's not doing
 168 anything else, do the following:-
 169 <P>
 170 <BLOCKQUOTE><CODE>
 171 <PRE>
 172 copy \spider\perl\listeners.pm \spider\local
 173 cd \spider\local
 174 notepad listeners.pm
 175 </PRE>
 176 </CODE></BLOCKQUOTE>
 177 <P>The following lines need attention:-
 178 <P>
 179 <BLOCKQUOTE><CODE>
 180 <PRE>
 181 ["localhost", 7300],
 182 ["foo.dxcluster.net", 7300],
 183 </PRE>
 184 </CODE></BLOCKQUOTE>
 185 <P>On my machine, I've simply uncommented the "localhost" entry by
 186 removing the '#' from the front of the line. I've also
 187 uncommented the second line, and changed the hostname to point at
 188 "spud.ath.cx".
 189 <P>If you don't have a static hostname for your machine, and you
 190 intend to allow folk to connect to your machine across the
 191 internet, then I'd suggest you pay a visit to www.dyndns.org and
 192 create one for yourself. While it's free, it will take a modest
 193 an amount of effort on your part to read, understand and
 194 implement what needs to be done to set this up.
 195 <P>
 196 <H2><A NAME="ss2.4">2.4 Connecting to other clusters</A>
 197 </H2>
 198
 199 <P>If you want to connect this to another cluster, then you'll want
 200 to negotiate a link with someone. For experimental purposes, I'm
 201 happy to allow folk to connect to GB7DXA (spud.ath.cx), on the
 202 understanding that the system may or may not be there and may or
 203 may not be connected to anything particularly useful at any given
 204 moment. Contact me by Email if you want me to set up a connection
 205 for you.
 206 <P><I>Last updated: 05-Mar-01</I>
 207 <P>
 208 <HR>
 209 Next
 210 <A HREF="wininstallation-1.html">Previous</A>
 211 <A HREF="wininstallation.html#toc2">Contents</A>
 212 </BODY>
 213 </HTML>