From 5b621c40fa6165a9f0eaf592d24a63a174e4b902 Mon Sep 17 00:00:00 2001 From: g0vgs Date: Sun, 22 Sep 2002 18:11:09 +0000 Subject: [PATCH] Add changes to the installation manual for Windows users from K1XX --- Changes | 2 + html/installation-4.html | 4 +- html/installation-5.html | 77 ++++++----- html/installation-6.html | 41 +++--- html/installation.html | 5 +- html/usermanual-1.html | 10 +- html/usermanual-10.html | 2 +- html/usermanual-11.html | 2 +- html/usermanual-12.html | 2 +- html/usermanual-2.html | 12 +- html/usermanual-3.html | 2 +- html/usermanual-4.html | 2 +- html/usermanual-5.html | 2 +- html/usermanual-6.html | 2 +- html/usermanual-7.html | 2 +- html/usermanual-8.html | 2 +- html/usermanual-9.html | 2 +- html/usermanual.html | 6 +- sgml/installation.sgml | 142 ++++++++++++-------- sgml/usermanual.sgml | 22 ++- txt/installation.txt | 284 ++++++++++++++++++++++++--------------- txt/usermanual.txt | 36 ++--- 22 files changed, 390 insertions(+), 271 deletions(-) diff --git a/Changes b/Changes index 9c0dfc99..a6e2561a 100644 --- a/Changes +++ b/Changes @@ -1,3 +1,5 @@ +22Sep02======================================================================= +1. Add changes to the installation manual for Windows users from K1XX 21Sep02======================================================================= 1. make some detail changes for connects out in Msg.pm 17Sep02======================================================================= diff --git a/html/installation-4.html b/html/installation-4.html index 9cb83f28..7438b7aa 100644 --- a/html/installation-4.html +++ b/html/installation-4.html @@ -24,7 +24,7 @@

-From version 1.47 there is a new (more efficient) way of doing this +>From version 1.47 there is a new (more efficient) way of doing this (see next section) but, if you prefer, the method of doing it described here will continue to work just fine.

@@ -79,7 +79,7 @@ telnet localhost 8000

4.3 Setting up telnet connects (from 1.47 onwards)

-

From version 1.47 you can choose to allow the perl cluster.pl program to +

>From version 1.47 you can choose to allow the perl cluster.pl program to allow connections directly (i.e. not via the /spider/src/client interface program). If you are using Windows then this is the only method available of allowing incoming telnet connections. diff --git a/html/installation-5.html b/html/installation-5.html index 3ed7d558..62959bd0 100644 --- a/html/installation-5.html +++ b/html/installation-5.html @@ -20,12 +20,9 @@

IMPORTANT:

What you'll be left with once you've followed these instructions -is (hopefully) a working DX Spider v1.47 system that is capable +is (hopefully) a working DX Spider v1.50 system that is capable of accepting or originating "internet" connections, plus inbound -AX.25 and TCP/IP radio connections. If the absence of outbound -radio connections is a serious limitation for you, it would be -better for you to wait a couple more weeks until this support has -been added. +and outbound AX.25 and TCP/IP radio connections.

On the other hand, you may have an enquiring mind, or better yet, may be looking for a useful way of connecting your current (perhaps) AK1A cluster "to the internet" via some networking @@ -82,13 +79,18 @@ and I have zero intention of trying to make them say otherwise.

Install your chosen Perl environment. Unless you have a very good reason for not doing so, I strongly suggest that you use ActivePerl v5.6. For my testing & development, I used build 623. -You can get this from:- -http://www.activestate.com/Products/ActivePerl/Download.html

You will need to choose either the MSI or the AS package. My -recommendation is that you choose the MSI package and deal with -the consequences if your system isn't equipped with support for -the latest MS Installer; you'll be better off in the long run. -The build 623 download is 7,460 KB, so now is a really good time -to have some tea if you're on a slow dial-up connection. +(A recent installation used the newer ActivePerl v5.6.1, build +633 without any noticable difficulty.) You can get this from: +http://www.activestate.com/Products/ActivePerl/Download.html

The link takes you to an initial page of System Requirements and +Software Prerequisites. If you do not have it already installed, +you can download and install the Windows Installer 2.0 for a Win98 +installation. Be forewarned, you will have to reboot your PC at the +completion of the installer's installation. +

If you already have the installer on your PC, simply click on the +Next arrow at the bottom of the page. Two clicks will finally get +you to the actual download page. The MSI version of Build 633 is +now 8.6MB in size, so make that a big cup of tea or coffee if you're +on a slow dial-up connection.

During installation, please ensure that you do choose the options to "Add Perl to the PATH environment variable" and "Create Perl file extension association"; it will make your life so much @@ -126,12 +128,15 @@ Time-HiRes.zip DB_File.zip -

Make yourself a convenient directory to unpack all of these zip -files into (I put mine in "D:\ppm>") and do the following (the -bits you type in are blue ). Note that where these files land -will be directly related to where you chose to install your -ActivePerl (mine, as you can probably guess from what follows, -went into "D:\Perl"):- +

If this is a new installation, now would also be a good time to +install a copy of WinZip on your PC. Make yourself a convenient +directory to unpack all of these zip files into (I put mine in +"D:\ppm>" but "C:\ppm" works just as well.) and do the following +(the bits you type in are blue ). You can upzip all of the files into +the same directory. When prompted, simply overwrite the Readme file +from each zip package. Note that where these files land will be +directly related to where you chose to install your ActivePerl +(mine, as you can probably guess from what follows, went into "D:\Perl"):-

@@ -169,10 +174,10 @@ do it that way because it suits me.
 
 
 

Get the current version of the DX Spider distribution. This needs -to be v1.47 or later. You've got two ways (currently) of getting +to be v1.50 or later. You've got two ways (currently) of getting this; either get a CVS update from sourceforge (if you don't know what this is, then it isn't for you) or get the latest "official" -release from:- +release from:

http://www.dxcluster.org/download/index.html

or if you want the lastest snapshot of CVS version (which is produced every night):- @@ -183,19 +188,25 @@ unstable. Generally, there will be a note on the website if this is the case.

The only difference between "CVSlatest.tgz" and the latest -"official" release version is that it is more up to date. Don't confuse -this TGZ file with "Downloading from Sourceforge with CVS" - they are two -quite different things. -

-

If you went down the CVS route (ie installed wincvs and downloaded from -sourceforge), then everything will be nicely -set out on your local disk. If you got the TGZ file, unpack it to -somewhere convenient. The following examples assume that you put -it on drive "C:\", for convenience. -

-

You will need -winzip to -manipulate the TGZ files (they are bit like ZIP files) if you are not using CVS. +"official" release version is that it is more up to date. Do not confuse +the "CVSlatest.tgz" file with "Downloading from Sourceforge with CVS" - they +are two quite different things. "Downloading from Sourceforge with CVS" is +explained in a section within the Admin manual. +

+

If you go down the CVS route (ie installing WinCVS as explained in the Admin +manual and downloaded from sourceforge), then everything will be nicely +installed on your local disk. If you got the CVSlatest.tgz file, unzip +( +winzip) it to "C:\". +This is an important point since paths are included within the .tgz +file. Make sure you unzip to the root directory of whichever drive you use... +"C:\" or "D:\" or .., not "C:\spider." If you double click on CVSlatest.tgz, +WinZip should open with a dialogue box that says the Archive contains a single +file (CVSlatest.tar) and asks whether WinZip should decompress it to a +temporary fold and then open it. Say "Yes" and then you will get the typical +Classical WinZip listing of files ready for extraction. Remember, extract +them to your desired root directory ("C:\" or "D:\" or ...). The following +examples assume that you put it on drive "C:\", for convenience.


Next diff --git a/html/installation-6.html b/html/installation-6.html index c0564a02..26b17421 100644 --- a/html/installation-6.html +++ b/html/installation-6.html @@ -15,10 +15,9 @@

6. Installing the software

-

Ensure that your CVS session or your WINunZIPped file have left you with -a directory "C:\spider\local" and C:\spider\local_cmd"; if not, go to -"C:\spider\" and create them. If "C:\spider" is missing, go back and -figure out why, because it shouldn't be. +

At this point you will need to create 2 additional directories under +"C:\Spider." Make directories "C:\spider\local" and "C:\spider\local_cmd". +If "C:\spider" is missing, go back and figure out why, because it shouldn't be.

Now create your own local copy of the DXVars.pm file by:-

@@ -27,7 +26,7 @@ copy c:\spider\perl\DXVars.pm.issue c:\spider\local\DXVars.pm
-

Now you'll need to edit this file using a text editor. If nothing +

Now you'll need to edit this file using a text editor like Notepad. If nothing else, you can simply

@@ -60,12 +59,11 @@ should change nothing else in this file. Note that if you use an "@" or a "$" character in one of the above strings (typically in $myemail) you must write them as "\@" or "\$".

-

6.1 Incoming telnets

If you want to enable inbound "TELNET" connections (or you are running -Windows NT, 2000 or XP), you've got a little more work to do. From a +Windows 98, NT, 2000 or XP), you've got a little more work to do. From a handy "DOS box" that's not doing anything else, do the following:-

@@ -75,22 +73,22 @@ cd \spider\local notepad listeners.pm
-

The following lines need attention:- +

The following line need attention:-

-["0.0.0.0", 7300],
+#               ["0.0.0.0", 7300],
 

On my machine, I've simply uncommented the "0.0.0.0" entry by removing the '#' from the front of the line.

You MUST carry out this step if you are -running on a Windows NT, 2000 or XP based system +running on a Windows 98, NT, 2000 or XP based system

If you don't have a static hostname for your machine, and you intend to allow folk to connect to your machine across the internet, then I'd suggest you pay a visit to www.dyndns.org and create one for yourself. While it's free, it will take a modest -an amount of effort on your part to read, understand and +amount of effort on your part to read, understand and implement what needs to be done to set this up.

If your machine is connected to the internet and you don't @@ -106,8 +104,17 @@ addresses).

On the assumption that you'll be using the SV2AGW Packet Engine -to interface your radios to the cluster, you should now create -your own local copy of AGWConnect.pm by:- +to interface your radios to the cluster, it would be a good idea to +download the Packet Engine software! You can get this software from: +

+http://www.raag.org/sv2agw/agwpe.zip

Depending upon your TNCs, you may also need to get: +

+http://www.raag.org/sv2agw/drivers.zip

A couple of the tools: +

+http://www.raag.org/sv2agw/agwterm.zip

+http://www.raag.org/sv2agw/agwmonitor.zip

will also help with troubleshooting of the RF links themselves. +

Install and configure AGWPE. You should now create your own local copy of +AGWConnect.pm by:-

@@ -130,6 +137,8 @@ consider adjusting the following items in AGWConnect.pm:-
 
  • $login - the login ID you chose when you set up the SV2AGW security :-)
  • $passwd - password that matches $login
  • +

    The login ID and passwd only need to be set if you are accessing AGW separately +via its web interface. This interface is normally not needed for use with DXSpider.

    6.3 Setting up the initial user files

    @@ -159,8 +168,8 @@ hold a display which looks something like:-

    -DXSpider DX Cluster Version 1.47
    -Copyright (c) 1998-2001 Dirk Koopman G1TLH
    +DXSpider DX Cluster Version 1.50
    +Copyright (c) 1998-2002 Dirk Koopman G1TLH
     loading prefixes ...
     loading band data ...
     loading user file system ...
    @@ -217,7 +226,7 @@ client than that which comes with windows (I use
     

    -Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.47
    +Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.50
     Cluster: 1 nodes, 1 local / 1 total users Max users 2 Uptime 0 00:00
     M0ADI de GB7SJP 4-Mar-2001 1511Z >
     
    diff --git a/html/installation.html b/html/installation.html index c40f0764..85c2aa50 100644 --- a/html/installation.html +++ b/html/installation.html @@ -15,8 +15,9 @@ Contents

    The DXSpider Installation Manual v1.50

    -

    Iain Philipps, G0RDI (g0rdi@77hz.com) and -Ian Maude, G0VGS, (g0vgs@gb7mbc.net)

    July 2002 revision 0.3 +

    Iain Philipps, G0RDI (g0rdi@77hz.com), +Ian Maude, G0VGS, (g0vgs@gb7mbc.net) and Charlie +Carroll, K1XX, (k1xx@ptcnh.net)

    September 2002 revision 0.4


    A reference for SysOps of the DXSpider DXCluster program.
    diff --git a/html/usermanual-1.html b/html/usermanual-1.html index d057aa0d..1758c79e 100644 --- a/html/usermanual-1.html +++ b/html/usermanual-1.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Introduction + The DXSpider User Manual v1.50: Introduction @@ -41,9 +41,9 @@ software for amateur radio. Many systems are still using this relatively old DOS software today.

    There are several new compatible cluster programs around now, including DXSpider. DXSpider is a clone of PacketCluster software that runs -under the Linux operating system. Linux is fast becoming the choice -for amateur radio stations because of it's flexibility, reliability -and the lack of the memory limitations of DOS. Linux supports +under several operating systems including Linux and Windows. Linux is fast +becoming the choice for amateur radio stations because of it's flexibility, +reliability and the lack of the memory limitations of DOS. Linux supports multitasking and is also multiuser. It has support for AX25, ROSE, NetROM and TCPIP built in, making it the ideal choice for amateur radio. It is also totally free! @@ -51,7 +51,7 @@ radio. It is also totally free! exercise in perl programming. It has developed rapidly and today is a very powerful cluster program. It was designed to be totally compatible with the AK1A program, although several commands have been extended to -try and improve functionality. +improve functionality.

    This manual is designed to help you become familiar with the commands that DXSpider supports and to help you get the best from the program so you can enjoy working that rare DX! As DXSpider is being improved all the diff --git a/html/usermanual-10.html b/html/usermanual-10.html index 97594ff2..88fab61c 100644 --- a/html/usermanual-10.html +++ b/html/usermanual-10.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Filtering (From version 1.45) + The DXSpider User Manual v1.50: Filtering (From version 1.45) diff --git a/html/usermanual-11.html b/html/usermanual-11.html index 0820e724..dd9cc112 100644 --- a/html/usermanual-11.html +++ b/html/usermanual-11.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Hints, tips and common questions. + The DXSpider User Manual v1.50: Hints, tips and common questions. diff --git a/html/usermanual-12.html b/html/usermanual-12.html index de7045fc..742c940a 100644 --- a/html/usermanual-12.html +++ b/html/usermanual-12.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: The DXSpider command reference + The DXSpider User Manual v1.50: The DXSpider command reference diff --git a/html/usermanual-2.html b/html/usermanual-2.html index 24e12e35..92e21349 100644 --- a/html/usermanual-2.html +++ b/html/usermanual-2.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Logins and logouts. + The DXSpider User Manual v1.50: Logins and logouts. @@ -60,10 +60,8 @@ connect MBCDX

    2.3 Telnet logins.

    -

    Because DXSpider runs under the Linux operating system, it is possible to -make a direct telnet connection into the cluster. With telnet -connections, the source callsign is not seen by DXSpider, so you will be -asked to login with your callsign. +

    With telnet connections, the source callsign is not seen by DXSpider, so +you will be asked to login with your callsign. To telnet to DXSpider, you would connect to a specific port. There is no standard at the moment for a cluster telnet port but ask the sysop if you are unsure. @@ -88,11 +86,11 @@ command. command if you are connected via telnet. If you do not log out gracefully using one of the above commands, you may find you are unable to get a full connect next time. This -may also happen if a NETRom connection drops. You may get connected, +may also happen if a netrom connection drops. You may get connected, but nothing else will happen because the program thinks you are still connected and will not let you connect twice under the same call. However you could reconnect by adding a number to the end of your call, -for example G0YLM2. +for example G0YLM-2. This can be done by either altering your MYCALL setting in the TNC or by altering your program configuration.

    diff --git a/html/usermanual-3.html b/html/usermanual-3.html index fd4e3aeb..6e22acbb 100644 --- a/html/usermanual-3.html +++ b/html/usermanual-3.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Setting your personal details. + The DXSpider User Manual v1.50: Setting your personal details. diff --git a/html/usermanual-4.html b/html/usermanual-4.html index 898a423d..5ce4b801 100644 --- a/html/usermanual-4.html +++ b/html/usermanual-4.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Getting and posting DX. + The DXSpider User Manual v1.50: Getting and posting DX. diff --git a/html/usermanual-5.html b/html/usermanual-5.html index ea00226a..eded4b5d 100644 --- a/html/usermanual-5.html +++ b/html/usermanual-5.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Headings and propagation + The DXSpider User Manual v1.50: Headings and propagation diff --git a/html/usermanual-6.html b/html/usermanual-6.html index 5f73d603..5f20a93a 100644 --- a/html/usermanual-6.html +++ b/html/usermanual-6.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Announcements. + The DXSpider User Manual v1.50: Announcements. diff --git a/html/usermanual-7.html b/html/usermanual-7.html index 65129caf..b1e3369b 100644 --- a/html/usermanual-7.html +++ b/html/usermanual-7.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Nodes and users. + The DXSpider User Manual v1.50: Nodes and users. diff --git a/html/usermanual-8.html b/html/usermanual-8.html index 85c0df6d..31149d14 100644 --- a/html/usermanual-8.html +++ b/html/usermanual-8.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Talk mode. + The DXSpider User Manual v1.50: Talk mode. diff --git a/html/usermanual-9.html b/html/usermanual-9.html index c105f765..5888ec7d 100644 --- a/html/usermanual-9.html +++ b/html/usermanual-9.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49: Mail. + The DXSpider User Manual v1.50: Mail. diff --git a/html/usermanual.html b/html/usermanual.html index f5fd5187..b603b7ff 100644 --- a/html/usermanual.html +++ b/html/usermanual.html @@ -2,7 +2,7 @@ - The DXSpider User Manual v1.49 + The DXSpider User Manual v1.50 @@ -13,9 +13,9 @@ Previous Contents


    -

    The DXSpider User Manual v1.49

    +

    The DXSpider User Manual v1.50

    -

    Ian Maude, G0VGS, (g0vgs@gb7mbc.net)

    December 2001 revision 4.1 +

    Ian Maude, G0VGS, (g0vgs@gb7mbc.net)

    September 2002 revision 0.1


    A complete reference for users of the DXSpider DXCluster program.
    diff --git a/sgml/installation.sgml b/sgml/installation.sgml index 7f4e7398..cb47fc54 100644 --- a/sgml/installation.sgml +++ b/sgml/installation.sgml @@ -5,9 +5,10 @@ The DXSpider Installation Manual v1.50 -Iain Philipps, G0RDI (g0rdi@77hz.com) and -Ian Maude, G0VGS, (g0vgs@gb7mbc.net) -July 2002 revision 0.3 +Iain Philipps, G0RDI (g0rdi@77hz.com), +Ian Maude, G0VGS, (g0vgs@gb7mbc.net) and Charlie +Carroll, K1XX, (k1xx@ptcnh.net) +September 2002 revision 0.4 A reference for SysOps of the DXSpider DXCluster program. @@ -887,7 +888,7 @@ This is dealt with in the previous section Allowing telnet connects from users

    -From version 1.47 there is a new (more efficient) way of doing this +>From version 1.47 there is a new (more efficient) way of doing this (see next section) but, if you prefer, the method of doing it described here will continue to work just fine. @@ -939,7 +940,7 @@ You should now get the login prompt and be able to login as before. Setting up telnet connects (from 1.47 onwards)

    -From version 1.47 you can choose to allow the perl cluster.pl program to +>From version 1.47 you can choose to allow the perl cluster.pl program to allow connections directly (i.e. not via the /spider/src/client interface program). If you are using Windows then this is the only method available of allowing incoming telnet connections. @@ -1356,12 +1357,9 @@ you should find everything running nicely. IMPORTANT: What you'll be left with once you've followed these instructions -is (hopefully) a working DX Spider v1.47 system that is capable +is (hopefully) a working DX Spider v1.50 system that is capable of accepting or originating "internet" connections, plus inbound -AX.25 and TCP/IP radio connections. If the absence of outbound -radio connections is a serious limitation for you, it would be -better for you to wait a couple more weeks until this support has -been added. +and outbound AX.25 and TCP/IP radio connections. On the other hand, you may have an enquiring mind, or better yet, may be looking for a useful way of connecting your current @@ -1422,16 +1420,22 @@ and I have zero intention of trying to make them say otherwise. Install your chosen Perl environment. Unless you have a very good reason for not doing so, I strongly suggest that you use ActivePerl v5.6. For my testing & development, I used build 623. -You can get this from:- -You will need to choose either the MSI or the AS package. My -recommendation is that you choose the MSI package and deal with -the consequences if your system isn't equipped with support for -the latest MS Installer; you'll be better off in the long run. -The build 623 download is 7,460 KB, so now is a really good time -to have some tea if you're on a slow dial-up connection. +The link takes you to an initial page of System Requirements and +Software Prerequisites. If you do not have it already installed, +you can download and install the Windows Installer 2.0 for a Win98 +installation. Be forewarned, you will have to reboot your PC at the +completion of the installer's installation. + +If you already have the installer on your PC, simply click on the +Next arrow at the bottom of the page. Two clicks will finally get +you to the actual download page. The MSI version of Build 633 is +now 8.6MB in size, so make that a big cup of tea or coffee if you're +on a slow dial-up connection. During installation, please ensure that you do choose the options to "Add Perl to the PATH environment variable" and "Create Perl @@ -1474,12 +1478,15 @@ Time-HiRes.zip DB_File.zip -Make yourself a convenient directory to unpack all of these zip -files into (I put mine in "D:\ppm>") and do the following (the -bits you type in are blue ). Note that where these files land -will be directly related to where you chose to install your -ActivePerl (mine, as you can probably guess from what follows, -went into "D:\Perl"):- +If this is a new installation, now would also be a good time to +install a copy of WinZip on your PC. Make yourself a convenient +directory to unpack all of these zip files into (I put mine in +"D:\ppm>" but "C:\ppm" works just as well.) and do the following +(the bits you type in are blue ). You can upzip all of the files into +the same directory. When prompted, simply overwrite the Readme file +from each zip package. Note that where these files land will be +directly related to where you chose to install your ActivePerl +(mine, as you can probably guess from what follows, went into "D:\Perl"):- D:\ppm>ppm install Data-Dumper.ppd @@ -1515,10 +1522,10 @@ do it that way because it suits me.

    Get the current version of the DX Spider distribution. This needs -to be v1.47 or later. You've got two ways (currently) of getting +to be v1.50 or later. You've got two ways (currently) of getting this; either get a CVS update from sourceforge (if you don't know what this is, then it isn't for you) or get the latest "official" -release from:- +release from: @@ -1532,28 +1539,34 @@ date. However, there is always the very slight chance that it might unstable. Generally, there will be a note on the website if this is the case. -

    The only difference between "CVSlatest.tgz" and the latest -"official" release version is that it is more up to date. Don't confuse -this TGZ file with "Downloading from Sourceforge with CVS" - they are two -quite different things. -

    -If you went down the CVS route (ie installed wincvs and downloaded from -sourceforge), then everything will be nicely -set out on your local disk. If you got the TGZ file, unpack it to -somewhere convenient. The following examples assume that you put -it on drive "C:\", for convenience. +The only difference between "CVSlatest.tgz" and the latest +"official" release version is that it is more up to date. Do not confuse +the "CVSlatest.tgz" file with "Downloading from Sourceforge with CVS" - they +are two quite different things. "Downloading from Sourceforge with CVS" is +explained in a section within the Admin manual. -

    You will need to -manipulate the TGZ files (they are bit like ZIP files) if you are not using CVS. +

    +If you go down the CVS route (ie installing WinCVS as explained in the Admin +manual and downloaded from sourceforge), then everything will be nicely +installed on your local disk. If you got the CVSlatest.tgz file, unzip +() it to "C:\". +This is an important point since paths are included within the .tgz +file. Make sure you unzip to the root directory of whichever drive you use... +"C:\" or "D:\" or .., not "C:\spider." If you double click on CVSlatest.tgz, +WinZip should open with a dialogue box that says the Archive contains a single +file (CVSlatest.tar) and asks whether WinZip should decompress it to a +temporary fold and then open it. Say "Yes" and then you will get the typical +Classical WinZip listing of files ready for extraction. Remember, extract +them to your desired root directory ("C:\" or "D:\" or ...). The following +examples assume that you put it on drive "C:\", for convenience. Installing the software

    -Ensure that your CVS session or your WINunZIPped file have left you with -a directory "C:\spider\local" and C:\spider\local_cmd"; if not, go to -"C:\spider\" and create them. If "C:\spider" is missing, go back and -figure out why, because it shouldn't be. +At this point you will need to create 2 additional directories under +"C:\Spider." Make directories "C:\spider\local" and "C:\spider\local_cmd". +If "C:\spider" is missing, go back and figure out why, because it shouldn't be. Now create your own local copy of the DXVars.pm file by:- @@ -1562,7 +1575,7 @@ copy c:\spider\perl\DXVars.pm.issue c:\spider\local\DXVars.pm -Now you'll need to edit this file using a text editor. If nothing +Now you'll need to edit this file using a text editor like Notepad. If nothing else, you can simply @@ -1594,12 +1607,11 @@ should change nothing else in this file. Note that if you use an "@" or a "$" character in one of the above strings (typically in $myemail) you must write them as "\@" or "\$". - Incoming telnets

    If you want to enable inbound "TELNET" connections (or you are running -Windows NT, 2000 or XP), you've got a little more work to do. From a +Windows 98, NT, 2000 or XP), you've got a little more work to do. From a handy "DOS box" that's not doing anything else, do the following:- @@ -1608,23 +1620,23 @@ cd \spider\local notepad listeners.pm -The following lines need attention:- +The following line need attention:- -["0.0.0.0", 7300], +# ["0.0.0.0", 7300], On my machine, I've simply uncommented the "0.0.0.0" entry by removing the '#' from the front of the line. You MUST carry out this step if you are -running on a Windows NT, 2000 or XP based system +running on a Windows 98, NT, 2000 or XP based system If you don't have a static hostname for your machine, and you intend to allow folk to connect to your machine across the internet, then I'd suggest you pay a visit to www.dyndns.org and create one for yourself. While it's free, it will take a modest -an amount of effort on your part to read, understand and +amount of effort on your part to read, understand and implement what needs to be done to set this up.

    If your machine is connected to the internet and you don't @@ -1640,8 +1652,25 @@ addresses).

    On the assumption that you'll be using the SV2AGW Packet Engine -to interface your radios to the cluster, you should now create -your own local copy of AGWConnect.pm by:- +to interface your radios to the cluster, it would be a good idea to +download the Packet Engine software! You can get this software from: + + + +Depending upon your TNCs, you may also need to get: + + + +A couple of the tools: + + + + + +will also help with troubleshooting of the RF links themselves. + +Install and configure AGWPE. You should now create your own local copy of +AGWConnect.pm by:- copy c:\spider\perl\AGWConnect.pm @@ -1663,6 +1692,9 @@ consider adjusting the following items in AGWConnect.pm:- $passwd - password that matches $login +The login ID and passwd only need to be set if you are accessing AGW separately +via its web interface. This interface is normally not needed for use with DXSpider. + Setting up the initial user files

    @@ -1689,8 +1721,8 @@ If you did everything you were told, your DOS window will now hold a display which looks something like:- -DXSpider DX Cluster Version 1.47 -Copyright (c) 1998-2001 Dirk Koopman G1TLH +DXSpider DX Cluster Version 1.50 +Copyright (c) 1998-2002 Dirk Koopman G1TLH loading prefixes ... loading band data ... loading user file system ... @@ -1746,7 +1778,7 @@ name="PuTTY">).

    Anyway, if you are rewarded with a display which looks something like:- -Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.47 +Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.50 Cluster: 1 nodes, 1 local / 1 total users Max users 2 Uptime 0 00:00 M0ADI de GB7SJP 4-Mar-2001 1511Z > @@ -1807,3 +1839,5 @@ If you want to know more about it, look at the at the cron page where it is explained more fully. + + diff --git a/sgml/usermanual.sgml b/sgml/usermanual.sgml index 55fddae9..8c0b89ce 100644 --- a/sgml/usermanual.sgml +++ b/sgml/usermanual.sgml @@ -4,9 +4,9 @@ -The DXSpider User Manual v1.49 +The DXSpider User Manual v1.50 Ian Maude, G0VGS, (g0vgs@gb7mbc.net) -December 2001 revision 4.1 +September 2002 revision 0.1 A complete reference for users of the DXSpider DXCluster program. @@ -46,9 +46,9 @@ relatively old DOS software today. There are several new compatible cluster programs around now, including DXSpider. DXSpider is a clone of PacketCluster software that runs -under the Linux operating system. Linux is fast becoming the choice -for amateur radio stations because of it's flexibility, reliability -and the lack of the memory limitations of DOS. Linux supports +under several operating systems including Linux and Windows. Linux is fast +becoming the choice for amateur radio stations because of it's flexibility, +reliability and the lack of the memory limitations of DOS. Linux supports multitasking and is also multiuser. It has support for AX25, ROSE, NetROM and TCPIP built in, making it the ideal choice for amateur radio. It is also totally free! @@ -57,7 +57,7 @@ DXSpider was conceived and begun in 1998 by Dirk Koopman, G1TLH as an exercise in perl programming. It has developed rapidly and today is a very powerful cluster program. It was designed to be totally compatible with the AK1A program, although several commands have been extended to -try and improve functionality. +improve functionality. This manual is designed to help you become familiar with the commands that DXSpider supports and to help you get the best from the program so @@ -115,10 +115,8 @@ connect MBCDX Telnet logins.

    -Because DXSpider runs under the Linux operating system, it is possible to -make a direct telnet connection into the cluster. With telnet -connections, the source callsign is not seen by DXSpider, so you will be -asked to login with your callsign. +With telnet connections, the source callsign is not seen by DXSpider, so +you will be asked to login with your callsign. To telnet to DXSpider, you would connect to a specific port. There is no standard at the moment for a cluster telnet port but ask the sysop if you are unsure. @@ -144,11 +142,11 @@ You could also send a disconnect if you are using AX25, or a CLOSE command if you are connected via telnet. If you do not log out gracefully using one of the above commands, you may find you are unable to get a full connect next time. This -may also happen if a NETRom connection drops. You may get connected, +may also happen if a netrom connection drops. You may get connected, but nothing else will happen because the program thinks you are still connected and will not let you connect twice under the same call. However you could reconnect by adding a number to the end of your call, -for example G0YLM2. +for example G0YLM-2. This can be done by either altering your MYCALL setting in the TNC or by altering your program configuration. diff --git a/txt/installation.txt b/txt/installation.txt index e3f7eb75..192f9a00 100644 --- a/txt/installation.txt +++ b/txt/installation.txt @@ -1,7 +1,8 @@ The DXSpider Installation Manual v1.50 - Iain Philipps, G0RDI (g0rdi@77hz.com) and Ian Maude, G0VGS, - (g0vgs@gb7mbc.net) - July 2002 revision 0.3 + Iain Philipps, G0RDI (g0rdi@77hz.com), Ian Maude, G0VGS, + (g0vgs@gb7mbc.net) and Charlie Carroll, K1XX, + (k1xx@ptcnh.net) + September 2002 revision 0.4 A reference for SysOps of the DXSpider DXCluster program. ______________________________________________________________________ @@ -61,7 +62,6 @@ - 1. Linux Installation @@ -1233,7 +1233,7 @@ 4.2. Allowing telnet connects from users - From version 1.47 there is a new (more efficient) way of doing this + >From version 1.47 there is a new (more efficient) way of doing this (see next section) but, if you prefer, the method of doing it described here will continue to work just fine. @@ -1300,7 +1300,7 @@ 4.3. Setting up telnet connects (from 1.47 onwards) - From version 1.47 you can choose to allow the perl cluster.pl program + >From version 1.47 you can choose to allow the perl cluster.pl program to allow connections directly (i.e. not via the /spider/src/client interface program). If you are using Windows then this is the only method available of allowing incoming telnet connections. @@ -1776,11 +1776,9 @@ IMPORTANT: What you'll be left with once you've followed these instructions is - (hopefully) a working DX Spider v1.47 system that is capable of - accepting or originating "internet" connections, plus inbound AX.25 - and TCP/IP radio connections. If the absence of outbound radio - connections is a serious limitation for you, it would be better for - you to wait a couple more weeks until this support has been added. + (hopefully) a working DX Spider v1.50 system that is capable of + accepting or originating "internet" connections, plus inbound and + outbound AX.25 and TCP/IP radio connections. On the other hand, you may have an enquiring mind, or better yet, may be looking for a useful way of connecting your current (perhaps) AK1A @@ -1842,16 +1840,23 @@ Install your chosen Perl environment. Unless you have a very good reason for not doing so, I strongly suggest that you use ActivePerl - v5.6. For my testing & development, I used build 623. You can get - this from:- + v5.6. For my testing & development, I used build 623. (A recent + installation used the newer ActivePerl v5.6.1, build 633 without any + noticable difficulty.) You can get this from: http://www.activestate.com/Products/ActivePerl/Download.html - You will need to choose either the MSI or the AS package. My - recommendation is that you choose the MSI package and deal with the - consequences if your system isn't equipped with support for the latest - MS Installer; you'll be better off in the long run. The build 623 - download is 7,460 KB, so now is a really good time to have some tea if - you're on a slow dial-up connection. + + The link takes you to an initial page of System Requirements and + Software Prerequisites. If you do not have it already installed, you + can download and install the Windows Installer 2.0 for a Win98 + installation. Be forewarned, you will have to reboot your PC at the + completion of the installer's installation. + + If you already have the installer on your PC, simply click on the Next + arrow at the bottom of the page. Two clicks will finally get you to + the actual download page. The MSI version of Build 633 is now 8.6MB + in size, so make that a big cup of tea or coffee if you're on a slow + dial-up connection. During installation, please ensure that you do choose the options to "Add Perl to the PATH environment variable" and "Create Perl file @@ -1894,24 +1899,19 @@ - Make yourself a convenient directory to unpack all of these zip files - into (I put mine in "D:\ppm>") and do the following (the bits you type - in are blue ). Note that where these files land will be directly + If this is a new installation, now would also be a good time to + install a copy of WinZip on your PC. Make yourself a convenient + directory to unpack all of these zip files into (I put mine in + "D:\ppm>" but "C:\ppm" works just as well.) and do the following (the + bits you type in are blue ). You can upzip all of the files into the + same directory. When prompted, simply overwrite the Readme file from + each zip package. Note that where these files land will be directly related to where you chose to install your ActivePerl (mine, as you can probably guess from what follows, went into "D:\Perl"):- - - - - - - - - - D:\ppm>ppm install Data-Dumper.ppd Installing package 'Data-Dumper.ppd' Installing D:\Perl\site\lib\auto\Data\Dumper\Dumper.bs @@ -1950,9 +1950,9 @@ 5.6. Getting Spider Get the current version of the DX Spider distribution. This needs to - be v1.47 or later. You've got two ways (currently) of getting this; + be v1.50 or later. You've got two ways (currently) of getting this; either get a CVS update from sourceforge (if you don't know what this - is, then it isn't for you) or get the latest "official" release from:- + is, then it isn't for you) or get the latest "official" release from: http://www.dxcluster.org/download/index.html @@ -1968,26 +1968,34 @@ The only difference between "CVSlatest.tgz" and the latest "official" - release version is that it is more up to date. Don't confuse this TGZ - file with "Downloading from Sourceforge with CVS" - they are two quite - different things. - - - If you went down the CVS route (ie installed wincvs and downloaded - from sourceforge), then everything will be nicely set out on your - local disk. If you got the TGZ file, unpack it to somewhere - convenient. The following examples assume that you put it on drive + release version is that it is more up to date. Do not confuse the + "CVSlatest.tgz" file with "Downloading from Sourceforge with CVS" - + they are two quite different things. "Downloading from Sourceforge + with CVS" is explained in a section within the Admin manual. + + + If you go down the CVS route (ie installing WinCVS as explained in the + Admin manual and downloaded from sourceforge), then everything will be + nicely installed on your local disk. If you got the CVSlatest.tgz + file, unzip (winzip) it to "C:\". This is an important point since + paths are included within the .tgz file. Make sure you unzip to the + root directory of whichever drive you use... "C:\" or "D:\" or .., + not "C:\spider." If you double click on CVSlatest.tgz, WinZip should + open with a dialogue box that says the Archive contains a single file + (CVSlatest.tar) and asks whether WinZip should decompress it to a + temporary fold and then open it. Say "Yes" and then you will get the + typical Classical WinZip listing of files ready for extraction. + Remember, extract them to your desired root directory ("C:\" or "D:\" + or ...). The following examples assume that you put it on drive "C:\", for convenience. - You will need winzip to manipulate the TGZ files (they are bit like - ZIP files) if you are not using CVS. 6. Installing the software - Ensure that your CVS session or your WINunZIPped file have left you - with a directory "C:\spider\local" and C:\spider\local_cmd"; if not, - go to "C:\spider\" and create them. If "C:\spider" is missing, go back - and figure out why, because it shouldn't be. + At this point you will need to create 2 additional directories under + "C:\Spider." Make directories "C:\spider\local" and + "C:\spider\local_cmd". If "C:\spider" is missing, go back and figure + out why, because it shouldn't be. Now create your own local copy of the DXVars.pm file by:- @@ -1999,8 +2007,8 @@ - Now you'll need to edit this file using a text editor. If nothing - else, you can simply + Now you'll need to edit this file using a text editor like Notepad. If + nothing else, you can simply @@ -2035,6 +2043,7 @@ o $mylongitude - The station longitude in degrees and decimal fractions + o $mylocator - The Maidenhead (or QRA) locator of the station You really also ought to update the $myqth and $myemail variables. And @@ -2047,8 +2056,8 @@ 6.1. Incoming telnets If you want to enable inbound "TELNET" connections (or you are running - Windows NT, 2000 or XP), you've got a little more work to do. From a - handy "DOS box" that's not doing anything else, do the following:- + Windows 98, NT, 2000 or XP), you've got a little more work to do. From + a handy "DOS box" that's not doing anything else, do the following:- @@ -2059,11 +2068,11 @@ - The following lines need attention:- + The following line need attention:- - ["0.0.0.0", 7300], + # ["0.0.0.0", 7300], @@ -2071,15 +2080,15 @@ On my machine, I've simply uncommented the "0.0.0.0" entry by removing the '#' from the front of the line. - You MUST carry out this step if you are running on a Windows NT, 2000 - or XP based system + You MUST carry out this step if you are running on a Windows 98, NT, + 2000 or XP based system If you don't have a static hostname for your machine, and you intend to allow folk to connect to your machine across the internet, then I'd suggest you pay a visit to www.dyndns.org and create one for yourself. - While it's free, it will take a modest an amount of effort on your - part to read, understand and implement what needs to be done to set - this up. + While it's free, it will take a modest amount of effort on your part + to read, understand and implement what needs to be done to set this + up. If your machine is connected to the internet and you don't want to @@ -2094,8 +2103,25 @@ 6.2. The AGW packet engine On the assumption that you'll be using the SV2AGW Packet Engine to - interface your radios to the cluster, you should now create your own - local copy of AGWConnect.pm by:- + interface your radios to the cluster, it would be a good idea to + download the Packet Engine software! You can get this software from: + + http://www.raag.org/sv2agw/agwpe.zip + + Depending upon your TNCs, you may also need to get: + + http://www.raag.org/sv2agw/drivers.zip + + A couple of the tools: + + http://www.raag.org/sv2agw/agwterm.zip + + http://www.raag.org/sv2agw/agwmonitor.zip + + will also help with troubleshooting of the RF links themselves. + + Install and configure AGWPE. You should now create your own local + copy of AGWConnect.pm by:- @@ -2109,8 +2135,7 @@ - - notepad AGWConnect.pm + notepad AGWConnect.pm @@ -2126,6 +2151,10 @@ o $passwd - password that matches $login + The login ID and passwd only need to be set if you are accessing AGW + separately via its web interface. This interface is normally not + needed for use with DXSpider. + 6.3. Setting up the initial user files @@ -2147,7 +2176,6 @@ following:- - perl cluster.pl @@ -2158,46 +2186,28 @@ - - - - - - - - - - - - - - - - - - - DXSpider DX Cluster Version 1.47 - Copyright (c) 1998-2001 Dirk Koopman G1TLH - loading prefixes ... - loading band data ... - loading user file system ... - starting listeners ... - Internal port: localhost 27754 - load badwords: Ok - reading in duplicate spot and WWV info ... - reading existing message headers ... - load badmsg: Ok - load forward: Ok - load swop: Ok - @msg = 0 before delete - @msg = 0 after delete - reading cron jobs ...v cron: reading /spider/cmd/crontab - cron: adding 1 0 * * 0 - DXUser::export("$main::data/user_asc") - reading database descriptors ... - doing local initialisation ... - orft we jolly well go ... - queue msg (0) + DXSpider DX Cluster Version 1.50 + Copyright (c) 1998-2002 Dirk Koopman G1TLH + loading prefixes ... + loading band data ... + loading user file system ... + starting listeners ... + Internal port: localhost 27754 + load badwords: Ok + reading in duplicate spot and WWV info ... + reading existing message headers ... + load badmsg: Ok + load forward: Ok + load swop: Ok + @msg = 0 before delete + @msg = 0 after delete + reading cron jobs ...v cron: reading /spider/cmd/crontab + cron: adding 1 0 * * 0 + DXUser::export("$main::data/user_asc") + reading database descriptors ... + doing local initialisation ... + orft we jolly well go ... + queue msg (0) @@ -2232,8 +2242,6 @@ On getting the login: prompt, enter your sysop callsign (the one you put in DXVars.pm as $myalias). - - I would recommend strongly that you obtain a better telnet client than that which comes with windows (I use PuTTY). @@ -2242,7 +2250,8 @@ like:- - Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.47 + + Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.50 Cluster: 1 nodes, 1 local / 1 total users Max users 2 Uptime 0 00:00 M0ADI de GB7SJP 4-Mar-2001 1511Z > @@ -2299,8 +2308,6 @@ going to connect to. This will now check every 10 minutes to see if gb7xxx is connected, if it is then nothing will be done. If it is not, then a connect attempt will be started. - - There are probably lots of other things you could use this crontab file for. If you want to know more about it, look at the DXSpider website at the cron page where it is explained more fully. @@ -2308,3 +2315,62 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/txt/usermanual.txt b/txt/usermanual.txt index a931da0c..a373bc0d 100644 --- a/txt/usermanual.txt +++ b/txt/usermanual.txt @@ -1,6 +1,6 @@ - The DXSpider User Manual v1.49 + The DXSpider User Manual v1.50 Ian Maude, G0VGS, (g0vgs@gb7mbc.net) - December 2001 revision 4.1 + September 2002 revision 0.1 A complete reference for users of the DXSpider DXCluster program. ______________________________________________________________________ @@ -214,18 +214,19 @@ There are several new compatible cluster programs around now, including DXSpider. DXSpider is a clone of PacketCluster software - that runs under the Linux operating system. Linux is fast becoming - the choice for amateur radio stations because of it's flexibility, - reliability and the lack of the memory limitations of DOS. Linux - supports multitasking and is also multiuser. It has support for AX25, - ROSE, NetROM and TCPIP built in, making it the ideal choice for - amateur radio. It is also totally free! + that runs under several operating systems including Linux and Windows. + Linux is fast becoming the choice for amateur radio stations because + of it's flexibility, reliability and the lack of the memory + limitations of DOS. Linux supports multitasking and is also + multiuser. It has support for AX25, ROSE, NetROM and TCPIP built in, + making it the ideal choice for amateur radio. It is also totally + free! DXSpider was conceived and begun in 1998 by Dirk Koopman, G1TLH as an exercise in perl programming. It has developed rapidly and today is a very powerful cluster program. It was designed to be totally compatible with the AK1A program, although several commands have been - extended to try and improve functionality. + extended to improve functionality. This manual is designed to help you become familiar with the commands that DXSpider supports and to help you get the best from the program @@ -261,7 +262,6 @@ - connect GB7MBC connect GB7MBC-1 @@ -291,12 +291,11 @@ 22..33.. TTeellnneett llooggiinnss.. - Because DXSpider runs under the Linux operating system, it is possible - to make a direct telnet connection into the cluster. With telnet - connections, the source callsign is not seen by DXSpider, so you will - be asked to login with your callsign. To telnet to DXSpider, you - would connect to a specific port. There is no standard at the moment - for a cluster telnet port but ask the sysop if you are unsure. + With telnet connections, the source callsign is not seen by DXSpider, + so you will be asked to login with your callsign. To telnet to + DXSpider, you would connect to a specific port. There is no standard + at the moment for a cluster telnet port but ask the sysop if you are + unsure. EExxaammppllee:: @@ -321,13 +320,14 @@ command if you are connected via telnet. If you do not log out gracefully using one of the above commands, you may find you are unable to get a full connect next time. This may also happen if a - NETRom connection drops. You may get connected, but nothing else will + netrom connection drops. You may get connected, but nothing else will happen because the program thinks you are still connected and will not let you connect twice under the same call. However you could reconnect by adding a number to the end of your call, for example - G0YLM2. This can be done by either altering your MYCALL setting in + G0YLM-2. This can be done by either altering your MYCALL setting in the TNC or by altering your program configuration. + 33.. SSeettttiinngg yyoouurr ppeerrssoonnaall ddeettaaiillss.. Once logged in to the cluster, you should set your details so that -- 2.34.1