html/wininstallation-1.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: Introduction</TITLE>
   6  <LINK HREF="wininstallation-2.html" REL=next>
   7
   8  <LINK HREF="wininstallation.html#toc1" REL=contents>
   9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
  10 </HEAD>
  11 <BODY>
  12 <A HREF="wininstallation-2.html">Next</A>
  13 Previous
  14 <A HREF="wininstallation.html#toc1">Contents</A>
  15 <HR>
  16 <H2><A NAME="s1">1. Introduction</A></H2>
  17
  18 <P><B>IMPORTANT:</B>
  19 <P>What you'll be left with once you've followed these instructions
  20 is (hopefully) a working DX Spider v1.47 system that is capable
  21 of accepting or originating "internet" connections, plus inbound
  22 AX.25 and TCP/IP radio connections. If the absence of outbound
  23 radio connections is a serious limitation for you, it would be
  24 better for you to wait a couple more weeks until this support has
  25 been added.
  26 <P>On the other hand, you may have an enquiring mind, or better yet,
  27 may be looking for a useful way of connecting your current
  28 (perhaps) AK1A cluster "to the internet" via some networking
  29 mechanism (BPQEther, etc) or other. I won't be producing
  30 instructions for the latter case, because I don't have an AK1A to
  31 play with. But someone might ...
  32 <P>Whatever, this document is intended to get you started with DX
  33 Spider in a Microsoft Windows &trade; environment. It's not
  34 intended to teach you anything other than how to perform a
  35 minimum configuration of a DX Spider installation and have it
  36 able to connect across "the internet" to other DX Clusters, while
  37 accepting inbound TELNET and radio connections.
  38 <P>
  39 <H2><A NAME="ss1.1">1.1 The requirements</A>
  40 </H2>
  41
  42 <P>The very first things you're going to need are (in order of
  43 importance):-
  44 <P>
  45 <UL>
  46 <LI>A cup of good, strong tea</LI>
  47 <LI>A supported Windows platform with an internet connection so you can
  48 download the necessary software bits and bobs directly to it. There are other ways, but this is preferable.</LI>
  49 <LI>Another cup of good, strong tea</LI>
  50 <LI>If all goes according to plan, about an hour to spare</LI>
  51 <LI>Plenty of good, strong tea</LI>
  52 </UL>
  53 <P>
  54 <H2><A NAME="ss1.2">1.2 The system</A>
  55 </H2>
  56
  57 <P>The platform I used to generate these instructions was a
  58 "vanilla" Microsoft Windows Me 4.90.3000 system, with a 700MHz
  59 AMD Athlon processor and 96 Mb memory. I've also personally
  60 verified that it runs on my laptop (Pentium 266MHz, 32 Mb memory,
  61 Windows 98 SE v4.10.2222 A) and a computer that I assembled from
  62 a random pile of junk (AMD K6-2 333MHz, 64 Mb memory, Windows 98
  63 v4.10.1998). As a result, I have reason to believe that what I'm
  64 about to describe will perform equally on any 32-bit MS Windows
  65 environment with 32 Mb of memory.
  66 <P>Because of the changes that have recently been made to the core
  67 "cluster.pl" module and the introduction of a very lightweight
  68 "winclient.pl", I have a sneaking suspicion that this will now
  69 run on any platform that has reasonably complete support for
  70 Perl. Is there someone out there with both an enquiring mind and
  71 (say) a Macintosh, for instance?
  72 <P>Please bear in mind, though, that my instructions relate solely
  73 to how to get this going under a Microsoft Windows environment,
  74 and I have zero intention of trying to make them say otherwise.
  75 <P>
  76 <H2><A NAME="ss1.3">1.3 Perl</A>
  77 </H2>
  78
  79 <P>Install your chosen Perl environment. Unless you have a very good
  80 reason for not doing so, I strongly suggest that you use
  81 ActivePerl v5.6. For my testing &amp; development, I used build 623.
  82 You can get this from:-
  83 <A HREF="http://www.activestate.com/Products/ActivePerl/Download.html">http://www.activestate.com/Products/ActivePerl/Download.html</A><P>You will need to choose either the MSI or the AS package. My
  84 recommendation is that you choose the MSI package and deal with
  85 the consequences if your system isn't equipped with support for
  86 the latest MS Installer; you'll be better off in the long run.
  87 The build 623 download is 7,460 KB, so now is a really good time
  88 to have some tea if you're on a slow dial-up connection.
  89 <P>During installation, please ensure that you do choose the options
  90 to "Add Perl to the PATH environment variable" and "Create Perl
  91 file extension association"; it will make your life so much
  92 easier. Once the installation is finished, be sure to reboot your
  93 PC. You probably won't be told anywhere else that this needs to
  94 be done now, but it does. Really.
  95 <P>Once you've rebooted, open a "DOS box" (Start > Run > command
  96 might do it, if you can't find it elsewhere) and from wherever it
  97 lands, type PERL -v &lt;ENTER&gt; (it's better if that's a lower-case
  98 'v', because an upper-case 'V' means something else. You should
  99 be rewarded with some interesting information about your Perl
 100 installation. If you're not, you must go back to the beginning
 101 and discover what went wrong and fix it. It's pointless to
 102 proceed unless this simple check is passed. Assuming it did work,
 103 you may now move on.
 104 <P>
 105 <H2><A NAME="ss1.4">1.4 Additional packages</A>
 106 </H2>
 107
 108 <P>Some extensions ("packages") need to be added to the base Perl
 109 distribution, and we'll do this next. If you're using the Perl I
 110 recommended, and don't know any better for yourself, then just
 111 blindly following these instructions will work just fine. If that
 112 didn't describe you, then you're on your own.
 113 <P>Visit the following URL:
 114 <P>
 115 <A HREF="http://www.activestate.com/PPMPackages/zips/6xx-builds-only/">http://www.activestate.com/PPMPackages/zips/6xx-builds-only/</A><P>and download the following files:-
 116 <P>
 117 <BLOCKQUOTE><CODE>
 118 <PRE>
 119 Data-Dumper.zip
 120 Net-Telnet.zip
 121 TimeDate.zip
 122 Time-HiRes.zip
 123 DB_File.zip
 124 </PRE>
 125 </CODE></BLOCKQUOTE>
 126 <P>Make yourself a convenient directory to unpack all of these zip
 127 files into (I put mine in "D:\ppm>") and do the following (the
 128 bits you type in are blue ). Note that where these files land
 129 will be directly related to where you chose to install your
 130 ActivePerl (mine, as you can probably guess from what follows,
 131 went into "D:\Perl"):-
 132 <P>
 133 <BLOCKQUOTE><CODE>
 134 <PRE>
 135 D:\ppm>ppm install Data-Dumper.ppd
 136 Installing package 'Data-Dumper.ppd'
 137 Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.bs
 138 Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.dll
 139 Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.exp
 140 Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.lib
 141 Installing D:\Perl\html\site\lib\auto\Data\Dumper\Dumper.html
 142 Installing D:\Perl\site\lib\Data\Dumper\Dumper.pm
 143 Writing D:\Perl\site\lib\auto\Data\Dumper\Dumper.packlist
 144 D:\ppm>
 145 </PRE>
 146 </CODE></BLOCKQUOTE>
 147 <P>I'm not going to bother you with exhaustive details of the rest
 148 of them, but suffice it to say you need to:
 149 <P>
 150 <BLOCKQUOTE><CODE>
 151 <PRE>
 152 ppm install DB_File.ppd
 153 ppm install Net-Telnet.ppd
 154 ppm install TimeDate.ppd
 155 ppm install Time-HiRes.ppd
 156 </PRE>
 157 </CODE></BLOCKQUOTE>
 158 <P>If all that seemed to work OK, time to move along. Before anyone
 159 who is familiar with PPM tells me that we didn't need to download
 160 and keep those files locally, I knew that. I also knew that PPM
 161 is sometimes awkward to configure via firewalls, and that
 162 sometimes the repositories don't always work the way we'd hope. I
 163 do it that way because it suits me.
 164 <P>
 165 <H2><A NAME="ss1.5">1.5 Getting Spider</A>
 166 </H2>
 167
 168 <P>Get the current version of the DX Spider distribution. This needs
 169 to be v1.47 or later. You've got two ways (currently) of getting
 170 this; either get a CVS update from sourceforge (if you don't know
 171 what this is, then it isn't for you) or get my package from:-
 172 <P>
 173 <A HREF="http://www.dcc.rsgb.org/WinSpider.zip">http://www.dcc.rsgb.org/WinSpider.zip</A><P>If you went down the CVS route, then everything will be nicely
 174 set out on your local disk. If you got the ZIP file, unpack it to
 175 somewhere convenient. The following examples assume that you put
 176 it on drive "C:\", for convenience.
 177 <P><B>NOTE:</B> This distribution method will go away as soon as the first
 178 v1.47 tarball is released. You can use WinZip to unpack that, and
 179 my life will be made easier by not needing to keep this .ZIP file
 180 updated.
 181 <P>
 182 <HR>
 183 <A HREF="wininstallation-2.html">Next</A>
 184 Previous
 185 <A HREF="wininstallation.html#toc1">Contents</A>
 186 </BODY>
 187 </HTML>