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