html/installation-1.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.16">
   5  <TITLE>The DXSpider Installation Manual v1.50: Linux Installation </TITLE>
   6  <LINK HREF="installation-2.html" REL=next>
   7
   8  <LINK HREF="installation.html#toc1" REL=contents>
   9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
  10 </HEAD>
  11 <BODY>
  12 <A HREF="installation-2.html">Next</A>
  13 Previous
  14 <A HREF="installation.html#toc1">Contents</A>
  15 <HR>
  16 <H2><A NAME="s1">1.</A> <A HREF="installation.html#toc1">Linux Installation </A></H2>
  17
  18 <H2><A NAME="ss1.1">1.1</A> <A HREF="installation.html#toc1.1">Introduction</A>
  19 </H2>
  20
  21 <P>This section describes the installation of DX Spider v1.50 on a
  22 <A HREF="http://www.redhat.com">RedHat</A> Linux Distribution.
  23 Wherever possible I will try to include differences for other distributions.  </P>
  24
  25 <P>I am assuming a general knowledge of Linux and its commands.  You should
  26 know how to use <EM>tar</EM> and how to edit files using your favourite editor.</P>
  27
  28 <P>The crucial ingredient for all of this is
  29 <A HREF="http://www.perl.org">Perl</A>.  Earlier versions of
  30 Spider required perl 5.004, however it is now <I>STRONGLY</I> recommended
  31 that you use at least version 5.005_03 as this is the version being used
  32 in the development of Spider.</P>
  33
  34 <P>In addition to the standard Red Hat distribution you will require the
  35 following modules from
  36 <A HREF="http://www.cpan.org/modules/by-module/">http://www.cpan.org/modules/by-module/</A> , please note however that with later versions of perl, some of these
  37 modules may be included with the distribution.  Get the modules anyway and try
  38 to install as below.  If they complain, they are probably already a part of your
  39 perl distribution.</P>
  40
  41 <P>
  42 <UL>
  43 <LI>
  44 <A HREF="http://www.cpan.org/modules/by-module/Data/Data-Dumper-2.10.tar.gz">Data-Dumper-2.101.tar.gz</A></LI>
  45 <LI>
  46 <A HREF="http://www.cpan.org/modules/by-module/Date/TimeDate-1.10.tar.gz">TimeDate-1.10.tar.gz</A></LI>
  47 <LI>
  48 <A HREF="http://www.cpan.org/modules/by-module/IO/IO-1.20.tar.gz">IO-1.20.tar.gz (for perl 5.00403 and lower)</A></LI>
  49 <LI>
  50 <A HREF="http://www.cpan.org/modules/by-module/Net/Net-Telnet-3.02.tar.gz">Net-Telnet-3.03.tar.gz</A></LI>
  51 <LI>
  52 <A HREF="http://www.cpan.org/modules/by-module/Curses/Curses-1.06.tar.gz">Curses-1.06.tar.gz</A></LI>
  53 <LI>
  54 <A HREF="http://www.cpan.org/modules/by-module/Time/Time-HiRes-01.20.tar.gz">Time-HiRes-01.20.tar.gz</A></LI>
  55 <LI>
  56 <A HREF="http://www.cpan.org/modules/by-module/Digest/Digest-SHA1-2.01.tar.gz">Digest-SHA1-2.01.tar.gz</A></LI>
  57 </UL>
  58 </P>
  59
  60 <P>Copy the CPAN modules listed above to a convenient place on your computer. One good
  61 place would be /usr/local/packages, and the instructions which follow will assume that
  62 that's where you have put them.</P>
  63
  64 <P>Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -</P>
  65 <P>
  66 <PRE>
  67 # tar xvfz /usr/local/packages/Data-Dumper-2.101.tar.gz
  68 # cd Data-Dumper-2.101
  69 # perl Makefile.PL
  70 # make test
  71 # make install
  72 # cd ..
  73 #
  74 # tar xvfz /usr/local/packages/TimeDate-1.10.tar.gz
  75 # cd TimeDate-1.10
  76 # perl Makefile.PL
  77 # make test
  78 # make install
  79 # cd ..
  80 #
  81 # tar xvfz /usr/local/packages/IO-1.20.tar.gz
  82 # cd IO-1.20
  83 # perl Makefile.PL
  84 # make test
  85 # make install UNINST=1
  86 # cd ..
  87 #
  88 # tar xvfz /usr/local/packages/Net-Telnet-3.03.tar.gz
  89 # cd Net-Telnet-3.02
  90 # perl Makefile.PL
  91 # make test
  92 # make install
  93 # cd ..
  94 #
  95 # tar xvfz /usr/local/packages/Curses-1.06.tar.gz
  96 # cd Curses-1.06
  97 # perl Makefile.PL
  98 # make test
  99 # make install
 100 # cd ..
 101 #
 102 # tar xvfz /usr/local/packages/Time-HiRes-01.20.tar.gz
 103 # cd Time-HiRes-01.20
 104 # perl Makefile.PL
 105 # make test
 106 # make install
 107 # cd ..
 108 #
 109 # tar xvfz /usr/local/packages/Digest-SHA1-2.01.tar.gz
 110 # cd Digest-SHA1-2.01
 111 # perl Makefile.PL
 112 # make test
 113 # make install
 114 # cd ..
 115 </PRE>
 116 </P>
 117
 118 <P>Do not fall into the trap of thinking they're all the same, just because they
 119 nearly are! Pay particular attention to the instructions of <EM>IO</EM>, above.</P>
 120
 121
 122 <H2><A NAME="ss1.2">1.2</A> <A HREF="installation.html#toc1.2">Preparation</A>
 123 </H2>
 124
 125 <P>I will assume that you have already downloaded the latest tarball of
 126 the DXSpider software and are ready to install it. I am assuming version
 127 1.50 for this section but of course you would use the latest version.</P>
 128
 129 <P>Login as root and create a user to run the cluster under.  <B><I>UNDER
 130 NO CIRCUMSTANCES USE ROOT AS THIS USER!</I></B>.  I am going to use
 131 the name <EM>sysop</EM>.  You can call it anything you wish.  Depending
 132 on your security requirements you may wish to use an existing user,
 133 however this is your own choice.</P>
 134 <P>
 135 <BLOCKQUOTE><CODE>
 136 <PRE>
 137 # adduser -m sysop
 138 </PRE>
 139 </CODE></BLOCKQUOTE>
 140 </P>
 141
 142 <P>For SuSE distributions, the command would be ..</P>
 143 <P>
 144 <BLOCKQUOTE><CODE>
 145 <PRE>
 146 # useradd -m sysop
 147 </PRE>
 148 </CODE></BLOCKQUOTE>
 149 </P>
 150
 151 <P>Now set a password for the user ...</P>
 152 <P>
 153 <BLOCKQUOTE><CODE>
 154 <PRE>
 155 # passwd sysop
 156 # New UNIX password:
 157 # Retype new UNIX password:
 158 passwd: all authentication tokens updated successfully
 159 </PRE>
 160 </CODE></BLOCKQUOTE>
 161 </P>
 162
 163 <H2><A NAME="ss1.3">1.3</A> <A HREF="installation.html#toc1.3">Installing the software</A>
 164 </H2>
 165
 166 <P>Now to unpack the DX Spider distribution, set symbolic links and group
 167 permissions.  Copy the tarball to /home/sysop and do the following.</P>
 168 <P>
 169 <BLOCKQUOTE><CODE>
 170 <PRE>
 171 # cd ~sysop
 172 # tar xvfz spider-1.50.tar.gz
 173 # ln -s ~sysop/spider /spider
 174 # groupadd -g 251 spider       (or another number)
 175 </PRE>
 176 </CODE></BLOCKQUOTE>
 177 </P>
 178
 179 <P>If you do not have the command <EM>groupadd</EM> available to you simply
 180 add a line in /etc/group by hand.</P>
 181 <P>
 182 <BLOCKQUOTE><CODE>
 183 <PRE>
 184 # vi /etc/group                (or your favorite editor)
 185 </PRE>
 186 </CODE></BLOCKQUOTE>
 187 </P>
 188
 189 <P>You also need to add some others to the group, including your own callsign
 190 (this will be used as an alias) and root.  The finished line in /etc/group
 191 should look something like this</P>
 192 <P><CODE>spider:x:251:sysop,g0vgs,root</CODE></P>
 193
 194 <P>The next step is to set the permissions on the Spider directory tree and files ....</P>
 195 <P>
 196 <BLOCKQUOTE><CODE>
 197 <PRE>
 198 # chown -R sysop.spider spider
 199 # find . -type d -exec chmod 2775 {} \;
 200 # find . -type f -exec chmod 775 {} \;
 201 </PRE>
 202 </CODE></BLOCKQUOTE>
 203 </P>
 204
 205 <P>This last step allows various users of the group <EM>spider</EM> to have
 206 write access to all the directories.  This is not really needed just yet
 207 but will be useful when web interfaces start to appear.</P>
 208
 209 <P>Finally, you need to fix the permissions on the ax25_call and netrom_call
 210 programs.  Check where they are with the <EM>locate</EM> command and alter
 211 the permissions with the <EM>chmod</EM> command like this ..</P>
 212 <P>
 213 <BLOCKQUOTE><CODE>
 214 <PRE>
 215 # chown root ax25_call netrom_call
 216 # chmod 4775 ax25_call netrom_call
 217 </PRE>
 218 </CODE></BLOCKQUOTE>
 219 </P>
 220
 221 <H2><A NAME="ss1.4">1.4</A> <A HREF="installation.html#toc1.4">Setting callsigns etc</A>
 222 </H2>
 223
 224 <P>Now login to your machine as the user you created earlier.  In my case that
 225 user is called <EM>sysop</EM>.  Once logged in, issue the following commands ....</P>
 226 <P>
 227 <BLOCKQUOTE><CODE>
 228 <PRE>
 229 $ cd /spider
 230 $ mkdir local
 231 $ mkdir local_cmd
 232 $ cp perl/DXVars.pm.issue local/DXVars.pm
 233 $ cd local
 234 $ vi DXVars.pm (or your favourite editor)
 235 </PRE>
 236 </CODE></BLOCKQUOTE>
 237 </P>
 238
 239 <P>Using the distributed DXVars.pm as a a template, set your cluster callsign,
 240 sysop callsign and other user info to suit your own environment. </P>
 241 <P>
 242 <BLOCKQUOTE><CODE>
 243 <PRE>
 244 $mycall = "GB7DJK";
 245 </PRE>
 246 </CODE></BLOCKQUOTE>
 247 </P>
 248
 249 <P>This is the call sign of your cluster.  If you use an SSID then include it here
 250 also.</P>
 251 <P>
 252 <BLOCKQUOTE><CODE>
 253 <PRE>
 254 $myalias = "G1TLH";
 255 </PRE>
 256 </CODE></BLOCKQUOTE>
 257 </P>
 258
 259 <P>This is the sysop user callsign, normally your own.</P>
 260
 261 <P><B>PLEASE USE CAPITAL LETTERS FOR CALLSIGNS</B></P>
 262
 263 <P>Note that this a perl file which will be parsed and executed as part of the
 264 cluster. If you get it wrong then perl will complain when you start the cluster
 265 process.  It is important only to alter the text of any section.  Some of the
 266 lines look a little odd.  Take this line for example ....</P>
 267 <P><CODE>$myemail = "ianmaude\@btinternet.com";</CODE></P>
 268
 269 <P>There appears to be an extra slash in there.  However this has to be there
 270 for the file to work so leave it in.</P>
 271
 272 <P>DON'T alter any file in /spider/perl, they are overwritten with every
 273 release. Any files or commands you place in /spider/local or /spider/local_cmd
 274 will automagically be used in preference to the ones in /spider/perl EVEN
 275 while the cluster is running!</P>
 276
 277 <P>Save the new file and change directory to ../perl ....</P>
 278 <P>
 279 <BLOCKQUOTE><CODE>
 280 <PRE>
 281 $ cd ../perl
 282 </PRE>
 283 </CODE></BLOCKQUOTE>
 284 </P>
 285
 286 <P>Now type the following command which creates the basic user file with you as
 287 the sysop.</P>
 288 <P>
 289 <BLOCKQUOTE><CODE>
 290 <PRE>
 291 $ ./create_sysop.pl
 292 </PRE>
 293 </CODE></BLOCKQUOTE>
 294 </P>
 295
 296 <H2><A NAME="ss1.5">1.5</A> <A HREF="installation.html#toc1.5">The client program</A>
 297 </H2>
 298
 299 <P>In earlier versions of Spider, all the processes were Perl scripts.  This
 300 was fine but with a lot of users your computer memory would soon be used up.
 301 To combat this a new client was written in "C".  This client only works for
 302 <EM>incoming</EM> connects at the moment.  Before you can use it though it
 303 has to be "made".  CD to /spider/src and type <EM>make</EM>.  You
 304 should see the output on your screen and hopefully now have a small C program
 305 called <EM>client</EM>.  Leave it in this directory.</P>
 306
 307
 308 <H2><A NAME="ss1.6">1.6</A> <A HREF="installation.html#toc1.6">Starting up for the first time</A>
 309 </H2>
 310
 311 <P>We can now bring spider up for the first time and see if all is well or not!
 312 It should look something like this ...</P>
 313 <P>
 314 <BLOCKQUOTE><CODE>
 315 <PRE>
 316 $ ./cluster.pl
 317 DXSpider DX Cluster Version 1.50
 318 Copyright (c) 1998 Dirk Koopman G1TLH
 319 loading prefixes ...
 320 loading band data ...
 321 loading user file system ...
 322 starting listener ...
 323 reading existing message headers
 324 reading cron jobs
 325 orft we jolly well go ...
 326 </PRE>
 327 </CODE></BLOCKQUOTE>
 328 </P>
 329
 330 <P>If all is well then login on another term or console as <EM>sysop</EM> and
 331 cd to /spider/src.  Now issue the following command ...</P>
 332 <P>
 333 <BLOCKQUOTE><CODE>
 334 <PRE>
 335 $ ./client
 336 </PRE>
 337 </CODE></BLOCKQUOTE>
 338 </P>
 339
 340 <P>This should log you into the cluster as the sysop under the alias callsign we
 341 set earlier.  In this case the callsign is G0VGS.  The cluster callsign is set
 342 in the DXVars.pm file in /spider/local.  In this case we will assume that this
 343 was set as GB7MBC.  You should therefore see this when you login ....</P>
 344 <P>
 345 <BLOCKQUOTE><CODE>
 346 <PRE>
 347 G0VGS de GB7MBC 19-Nov-1999 2150Z >
 348 </PRE>
 349 </CODE></BLOCKQUOTE>
 350 </P>
 351
 352 <P>If you do, congratulations!  If not, look over the instructions again, you
 353 have probably missed something out.  You can shut spider down again with the
 354 command ....</P>
 355 <P>
 356 <BLOCKQUOTE><CODE>
 357 <PRE>
 358 shutdown
 359 </PRE>
 360 </CODE></BLOCKQUOTE>
 361 </P>
 362
 363 <P>and both the cluster and the client should return to Linux prompts.</P>
 364
 365
 366 <HR>
 367 <A HREF="installation-2.html">Next</A>
 368 Previous
 369 <A HREF="installation.html#toc1">Contents</A>
 370 </BODY>
 371 </HTML>