]> dxcluster.org Git - spider.git/commitdiff
a few tidy ups SPIDER_1_5
authordjk <djk>
Wed, 2 Dec 1998 19:48:42 +0000 (19:48 +0000)
committerdjk <djk>
Wed, 2 Dec 1998 19:48:42 +0000 (19:48 +0000)
INSTALL
connect/gb7tlh
html/cpan.html
html/index.html

diff --git a/INSTALL b/INSTALL
index 260aad3666046a7a582ef4a36e4de45f2c1c00cb..69c911cdea8aa3f78209351f2576bddb4210ceab 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -4,172 +4,6 @@ This version of dxspider requires perl5 (it is written entirely in perl5 and
 makes extensive use of perl objects). This program is known to work with
 RedHat 5.1 perl5_004.
 
-In addition to the standard perl5 distribution you will require to load the
-the following modules:-
+For installation instructions see
 
-1) CPAN - this has a load of the standard extra stuff in it. To load it type:-
-
-  # perl -MCPAN -e shell
-  cpan> install Bundle::CPAN
-  cpan> q
-  
-  Please sure there were no errors, be particularly careful when installing
-  libwww stuff, I would suggest 'no host lookups' and pressing <space> and
-  enter for each of the offered default hostnames.
-  
-2) Date::Parse, MLDBM, IO::Select
-  
-  As you have so carefully loaded it, I suggest you use the CPAN system
-  above:-
-  
-  # perl -MCPAN -e shell
-  cpan> install Date::Parse
-  ..
-  ..
-  cpan> install MLDBM
-  ..
-  ..
-  cpan> install IO::Select
-
-  In order to use IO::Select you will need to 
-  
-  # cd /root/.cpan/build/IO-1.20  
-  # make install UNINST=1
-
-  The 'cd' is to the place where CPAN sets up its local cache. The example 
-  shown is for Linux defaults.
-
-3) select a user to run the cluster as UNDER _NO_ CIRCUMSTANCES USE ROOT.
-
-   I say again DO NOT USE root.
-   
-   Pick an existing user or create a new one. Don't care which. I don't know
-   your security requirements.
-   
-4) login as root (I shall use 'jim' for any examples).
-
-5) # cd ~jim
-   # tar xvfz spider-x.x.tar.gz
-   # ln -s ~jim/spider /spider
-   # groupadd -g 251 spider       (or another number)
-   # vi /etc/group                (or your favorite editor)
-     add jim (or whatever) and root to the group spider
-     it should look something like:-
-        
-        spider:x:251:jim,root
-        :x
-   # chown -R jim.spider spider
-   # find . -type d -exec chmod 2775 {} \;
-   # find . -type f -exec chmod 775 {} \;
-   
-   This last step allows various users of group spider to have write
-   access to all the directories. Not really needed for now but will 
-   be useful when web interfaces start to appear.
-
-6) if you have any users that require network logins, set them up as real
-   users with useradd -m <callsign>. Alter the default .bashrc so that it
-   contains just one line (assuming you use the default bash shell).
-   
-   exec /spider/perl/client.pl <callsign> telnet
-   
-   Don't forget to give them a real password. This is really for network
-   cluster logins. The telnet argument does two things, it sets the EOL 
-   convention to \n rather than AX25's \r and it automatically reduces
-   the privilege of the <callsign> to a 'safe[r]' level.
-   
-7) for incoming AX25 connections you are expected to have got the AX25
-   utilities setup, tested and working. See the AX25-HOWTO for more info
-   on this - it really is outside the scope of this document. I would 
-   recommend using ax25-utils-2.1.42a-5.i386.rpm or above as a starting 
-   point. DXSpider uses ax25d for incoming connections. You need to have 
-   entries like this:-
-   
-   [ether]                                                                         
-   NOCALL   * * * * * *  L                                                         
-   default  * * * * * *  - jim /spider/perl/client.pl client.pl %u ax25
-   <bbs>
-   NOCALL   * * * * * *  L                                                         
-   default  * * * * * *  - jim /spider/perl/client.pl client.pl %u ax25
-
-   where ether and bbs are appropriate KNOWN WORKING axport and nrport 
-   names respectively.
-   
-   Obviously you can use different names, callsigns or whatever for your 
-   purposes, but it is up to you to get it to work. 
-   
-   Note I use BPQ over ethernet which why I have the port names I have.
-   
-8) login as jim (or whatever)
-   $ startx                     (much easier to use X)
-   $ cd /spider
-   $ mkdir local
-   $ mkdir local_cmd
-   $ cp perl/DXVars.pm local
-   $ cd local
-   $ vi DXVars.pm
-   
-   now alter your cluster callsign, sysop callsign and other user info 
-   as you wish. Note that this a perl file which will parsed and executed
-   as part of the cluster. If you get it wrong then perl will complain 
-   when you start the cluster process.
-   
-   PLEASE USE CAPITAL LETTERS FOR CALLSIGNS
-   
-   DON'T alter the DXVars.pm (or any other file) in /spider/perl, they are
-   overwritten with every release. Any files or commands you place in
-   /spider/local or /spider/local_cmd will automagically be used in preference
-   to the ones in /spider/perl EVEN whilst the cluster is running!
-   
-   :x
-   
-   $ cd ../perl
-
-   now create the basic user file with you as the sysop.
-
-   $ create_sysop.pl
-
-   try and run the cluster program and see whether all the various rivets are
-   flying in approximate formation...
-
-   $ cluster.pl
-   DXSpider DX Cluster Version x.x
-   Copyright (c) 1998 Dirk Koopman G1TLH
-   loading prefixes ...
-   loading band data ...
-   loading user file system ...
-   starting listener ...
-   reading existing message headers
-   reading cron jobs
-   orft we jolly well go ...
-   
-   
-9) now log in again or start another rxvt or xterm
-   $ client.pl
-   
-   you should now see a normal cluster prompt.
-   
-   at the cluster prompt:-
-   
-   G1JIM de GB7JIM 10-Sep-98 1000Z> set/node GB7XXX
-   
-   for every dxcluster you expect to connect to or from.
-
-   G1JIM de GB7JIM 10-Sep-98 1001Z> shutdown
-   
-   The cluster and the client should both go back to prompts
-   
-   Restart the cluster.
-   
-   The callsigns should be the sysop callsign and the cluster callsign
-   as per your modified DXVars.pm. You can check that the cluster 
-   connections will work by:-
-   
-   $ client.pl gb7xxx      (doesn't have to be uppercase).
-   PC38^GB7JIM^~           <- the cluster thinks this is a cluster
-   ^C                      <- to get out
-   
-   
-   
-
-   
-   
+file:doc/index.html
index 59fc857acce9dfb80ca7dd7064cb2404906ee857..18a1ac9b32a5027ae6e1c86c45aa38f401d195d7 100644 (file)
@@ -1,6 +1,6 @@
 timeout 15
 # don't forget to chmod 4775 netrom_call!
-connect ax25 /usr/sbin/netrom_call bbs gb7djk-1 g1tlh
+connect ax25 /usr/sbin/netrom_call bbs gb7djk g1tlh
 'Connect' ''
 'Connect' 'cluster'
 'Connect'
index d07d367e6f59dcb0cdf52e0f15b49e653a73c616..e6f46c6a46d7631bb6b7d1459217366100eb918b 100644 (file)
@@ -1,3 +1,4 @@
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
 <html>
   <head>
        <title>CPAN and perl installation</title>
@@ -8,7 +9,7 @@
     <address><a href="mailto:djk@tobit.co.uk"></a></address>
 <!-- Created: Wed Dec  2 16:40:25 GMT 1998 -->
 <!-- hhmts start -->
-Last modified: Wed Dec  2 18:12:42 GMT 1998
+Last modified: Wed Dec  2 19:46:03 GMT 1998
 <!-- hhmts end -->
 
        <p>I have captured a typical CPAN load here for your information. The details may be slightly
index bd4e787ee19c04ccf919af92a9fc0a5a42817714..fa9f7b313d380c6e92f4d3d0d975125a5b9270d9 100644 (file)
@@ -11,7 +11,7 @@
     <address><a href="mailto:djk@tobit.co.uk"></a></address>
 <!-- Created: Wed Dec  2 18:22:33 GMT 1998 -->
 <!-- hhmts start -->
-Last modified: Wed Dec  2 18:28:15 GMT 1998
+Last modified: Wed Dec  2 19:46:16 GMT 1998
 <!-- hhmts end -->
        <p>The DXSpider dx cluster system is written in perl5 as an exercise in self-training
          for both protocol research and teaching myself perl.