html/installation_en-5.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: Microsoft Windows Installation</TITLE>
   6  <LINK HREF="installation_en-6.html" REL=next>
   7  <LINK HREF="installation_en-4.html" REL=previous>
   8  <LINK HREF="installation_en.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_en-6.html">Next</A>
  13 <A HREF="installation_en-4.html">Previous</A>
  14 <A HREF="installation_en.html#toc5">Contents</A>
  15 <HR>
  16 <H2><A NAME="s5">5.</A> <A HREF="installation_en.html#toc5">Microsoft Windows Installation</A></H2>
  17
  18 <H2><A NAME="ss5.1">5.1</A> <A HREF="installation_en.html#toc5.1">Introduction</A>
  19 </H2>
  20
  21 <P><B>IMPORTANT:</B> </P>
  22 <P>What you'll be left with once you've followed these instructions
  23 is (hopefully) a working DX Spider v1.50 system that is capable
  24 of accepting or originating "internet" connections, plus inbound
  25 and outbound AX.25 and TCP/IP radio connections.</P>
  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 ...</P>
  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.</P>
  38
  39 <H2><A NAME="ss5.2">5.2</A> <A HREF="installation_en.html#toc5.2">The requirements</A>
  40 </H2>
  41
  42 <P>The very first things you're going to need are (in order of
  43 importance):-</P>
  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
  55 <H2><A NAME="ss5.3">5.3</A> <A HREF="installation_en.html#toc5.3">The system</A>
  56 </H2>
  57
  58 <P>The platform I used to generate these instructions was a
  59 "vanilla" Microsoft Windows Me 4.90.3000 system, with a 700MHz
  60 AMD Athlon processor and 96 Mb memory. I've also personally
  61 verified that it runs on my laptop (Pentium 266MHz, 32 Mb memory,
  62 Windows 98 SE v4.10.2222 A) and a computer that I assembled from
  63 a random pile of junk (AMD K6-2 333MHz, 64 Mb memory, Windows 98
  64 v4.10.1998). As a result, I have reason to believe that what I'm
  65 about to describe will perform equally on any 32-bit MS Windows
  66 environment with 32 Mb of memory.</P>
  67 <P>Because of the changes that have recently been made to the core
  68 "cluster.pl" module and the introduction of a very lightweight
  69 "winclient.pl", I have a sneaking suspicion that this will now
  70 run on any platform that has reasonably complete support for
  71 Perl. Is there someone out there with both an enquiring mind and
  72 (say) a Macintosh, for instance?</P>
  73 <P>Please bear in mind, though, that my instructions relate solely
  74 to how to get this going under a Microsoft Windows environment,
  75 and I have zero intention of trying to make them say otherwise.</P>
  76
  77 <H2><A NAME="ss5.4">5.4</A> <A HREF="installation_en.html#toc5.4">Perl</A>
  78 </H2>
  79
  80 <P>Install your chosen Perl environment. Unless you have a very good
  81 reason for not doing so, I strongly suggest that you use
  82 ActivePerl v5.6. For my testing &amp; development, I used build 623.
  83 (A recent installation used the newer ActivePerl v5.6.1, build
  84 633 without any noticable difficulty.)  You can get this from:
  85 <A HREF="http://www.activestate.com/Products/ActivePerl/Download.html">http://www.activestate.com/Products/ActivePerl/Download.html</A></P>
  86 <P>The link takes you to an initial page of System Requirements and
  87 Software Prerequisites.  If you do not have it already installed,
  88 you can download and install the Windows Installer 2.0 for a Win98
  89 installation.  Be forewarned, you will have to reboot your PC at the
  90 completion of the installer's installation.  </P>
  91 <P>If you already have the installer on your PC, simply click on the
  92 Next arrow at the bottom of the page.  Two clicks will finally get
  93 you to the actual download page.  The MSI version of Build 633 is
  94 now 8.6MB in size, so make that a big cup of tea or coffee if you're
  95 on a slow dial-up connection.</P>
  96 <P>During installation, please ensure that you do choose the options
  97 to "Add Perl to the PATH environment variable" and "Create Perl
  98 file extension association"; it will make your life so much
  99 easier. Once the installation is finished, be sure to reboot your
 100 PC. You probably won't be told anywhere else that this needs to
 101 be done now, but it does. Really.</P>
 102 <P>Once you've rebooted, open a "DOS box" (Start > Run > command
 103 might do it, if you can't find it elsewhere) and from wherever it
 104 lands, type PERL -v &lt;ENTER&gt; (it's better if that's a lower-case
 105 'v', because an upper-case 'V' means something else. You should
 106 be rewarded with some interesting information about your Perl
 107 installation. If you're not, you must go back to the beginning
 108 and discover what went wrong and fix it. It's pointless to
 109 proceed unless this simple check is passed. Assuming it did work,
 110 you may now move on.</P>
 111
 112 <H2><A NAME="ss5.5">5.5</A> <A HREF="installation_en.html#toc5.5">Additional packages</A>
 113 </H2>
 114
 115 <P>Some extensions ("packages") need to be added to the base Perl
 116 distribution, and we'll do this next. If you're using the Perl I
 117 recommended, and don't know any better for yourself, then just
 118 blindly following these instructions will work just fine. If that
 119 didn't describe you, then you're on your own.</P>
 120 <P>Visit the following URL:</P>
 121 <P>
 122 <A HREF="http://www.activestate.com/PPMPackages/zips/6xx-builds-only/">http://www.activestate.com/PPMPackages/zips/6xx-builds-only/</A></P>
 123 <P>and download the following files:-</P>
 124 <P>
 125 <BLOCKQUOTE><CODE>
 126 <PRE>
 127 Data-Dumper.zip
 128 Net-Telnet.zip
 129 TimeDate.zip
 130 Time-HiRes.zip
 131 DB_File.zip
 132 </PRE>
 133 </CODE></BLOCKQUOTE>
 134 </P>
 135 <P>If this is a new installation, now would also be a good time to
 136 install a copy of WinZip on your PC.  Make yourself a convenient
 137 directory to unpack all of these zip files into (I put mine in
 138 "D:\ppm>" but "C:\ppm" works just as well.) and do the following
 139 (the bits you type in are blue ).  You can upzip all of the files into
 140 the same directory.  When prompted, simply overwrite the Readme file
 141 from each zip package.  Note that where these files land will be
 142 directly related to where you chose to install your ActivePerl
 143 (mine, as you can probably guess from what follows, went into "D:\Perl"):-</P>
 144 <P>
 145 <BLOCKQUOTE><CODE>
 146 <PRE>
 147 D:\ppm>ppm install Data-Dumper.ppd
 148 Installing package 'Data-Dumper.ppd'
 149 Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.bs
 150 Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.dll
 151 Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.exp
 152 Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.lib
 153 Installing D:\Perl\html\site\lib\auto\Data\Dumper\Dumper.html
 154 Installing D:\Perl\site\lib\Data\Dumper\Dumper.pm
 155 Writing D:\Perl\site\lib\auto\Data\Dumper\Dumper.packlist
 156 D:\ppm>
 157 </PRE>
 158 </CODE></BLOCKQUOTE>
 159 </P>
 160 <P>I'm not going to bother you with exhaustive details of the rest
 161 of them, but suffice it to say you need to:</P>
 162 <P>
 163 <BLOCKQUOTE><CODE>
 164 <PRE>
 165 ppm install DB_File.ppd
 166 ppm install Net-Telnet.ppd
 167 ppm install TimeDate.ppd
 168 ppm install Time-HiRes.ppd
 169 </PRE>
 170 </CODE></BLOCKQUOTE>
 171 </P>
 172 <P>If all that seemed to work OK, time to move along. Before anyone
 173 who is familiar with PPM tells me that we didn't need to download
 174 and keep those files locally, I knew that. I also knew that PPM
 175 is sometimes awkward to configure via firewalls, and that
 176 sometimes the repositories don't always work the way we'd hope. I
 177 do it that way because it suits me.</P>
 178
 179 <H2><A NAME="ss5.6">5.6</A> <A HREF="installation_en.html#toc5.6">Getting Spider</A>
 180 </H2>
 181
 182 <P>Get the current version of the DX Spider distribution. This needs
 183 to be v1.50 or later. You've got two ways (currently) of getting
 184 this; either get a CVS update from sourceforge (if you don't know
 185 what this is, then it isn't for you) or get the latest "official"
 186 release from:</P>
 187 <P>
 188 <A HREF="http://www.dxcluster.org/download/index.html">http://www.dxcluster.org/download/index.html</A></P>
 189 <P>or if you want the lastest snapshot of CVS version (which is produced
 190 every night):-</P>
 191 <P>
 192 <A HREF="http://www.dxcluster.org/download/CVSlatest.tgz">http://www.dxcluster.org/download/CVSlatest.tgz</A></P>
 193 <P>This is generally the best one to go for as it is completely up to
 194 date. However, there is always the very slight chance that it might
 195 unstable. Generally, there will be a note on the website if this is
 196 the case. </P>
 197
 198 <P>The only difference between "CVSlatest.tgz" and the latest
 199 "official" release version is that it is more up to date. <B>Do not confuse
 200 the "CVSlatest.tgz" file with "Downloading from Sourceforge with CVS" - they
 201 are two quite different things.</B>  "Downloading from Sourceforge with CVS" is
 202 explained in a section within the Admin manual.</P>
 203
 204 <P>If you go down the CVS route (ie installing WinCVS as explained in the Admin
 205 manual and downloaded from sourceforge), then everything will be nicely
 206 installed on your local disk. If you got the CVSlatest.tgz file, unzip
 207 (
 208 <A HREF="http://www.winzip.com">winzip</A>) it to "C:\".
 209 This is an important point since paths are included within the .tgz
 210 file.  Make sure you unzip to the root directory of whichever drive you use...
 211 "C:\" or "D:\" or .., not "C:\spider."  If you double click on CVSlatest.tgz,
 212 WinZip should open with a dialogue box that says the Archive contains a single
 213 file (CVSlatest.tar) and asks whether WinZip should decompress it to a
 214 temporary fold and then open it.  Say "Yes" and then you will get the typical
 215 Classical WinZip listing of files ready for extraction.  Remember, extract
 216 them to your desired root directory ("C:\" or "D:\" or ...).  The following
 217 examples assume that you put it on drive "C:\", for convenience.</P>
 218
 219 <HR>
 220 <A HREF="installation_en-6.html">Next</A>
 221 <A HREF="installation_en-4.html">Previous</A>
 222 <A HREF="installation_en.html#toc5">Contents</A>
 223 </BODY>
 224 </HTML>