X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Finstallation-5.html;fp=html%2Finstallation-5.html;h=fde7e8fb73e03533932bae112e64af82448c1388;hb=b8ff94755eecda16276c449274c6a76c4f14a8d1;hp=0000000000000000000000000000000000000000;hpb=888f29019bd55b89ee5c506ee7d2d71f0c3dafb8;p=spider.git diff --git a/html/installation-5.html b/html/installation-5.html new file mode 100644 index 00000000..fde7e8fb --- /dev/null +++ b/html/installation-5.html @@ -0,0 +1,210 @@ + + + + + The DXSpider Installation Manual v1.47: Installing the software + + + + + + +Next +Previous +Contents +
+

5. Installing the software

+ +

Ensure that your CVS session or your unZIPped file have left you +with a directory "C:\spider\local"; if not, go to "C:\spider\" +and create one. 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:- +

+

+
+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 +else, you can simply +

+

+
+cd \spider\local
+
+
+

and then +

+

+
+notepad DXVars.pm
+
+
+

to bring up an editor window containing the file. As an absolute +minimum you must adjust the following items in DXVars.pm:- +

+

+

You really also ought to update the $mylatitude, $mylongitude, +$myqth and $myemail variables. And unless you are absolutely +certain you know what you're doing, you should change nothing +else in this file. +

+

5.1 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:- +

+

+
+copy c:\spider\perl\AGWConnect.pm
+c:\spider\local\AGWConnect.pm
+
+
+

and then +

+

+
+notepad AGWConnect.pm
+
+
+

to bring up an editor window containing the file. You must +consider adjusting the following items in AGWConnect.pm:- +

+

+

+

5.2 Setting up the initial user files +

+ +

Next you need to create the initial user files, etc. A tool is +supplied which will do this for you. To run the tool:- +

+

+
+cd \spider\perl
+perl create_sysop.pl
+
+
+

If all goes according to plan, you will see no output from this +program, and after a brief wait, your DOS prompt will be +returned. +

Depending on how brave you are, you might now care to try the +following:- +

+

+
+perl cluster.pl
+
+
+

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
+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)
+
+
+

Now, if that's what you've got, you are very nearly home and dry +(in as far as these particular experiments are concerned, anyhow) +

To access your new cluster (from the local machine) find yourself another +"DOS box" and do the following:- +

+

+
+cd \spider\perl
+perl winclient.pl
+
+
+

If you are rewarded with a display which looks something like:- +

+

+
+Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.47
+Cluster: 1 nodes, 1 local / 1 total users Max users 2 Uptime 0 00:00
+M0ADI de GB7SJP 4-Mar-2001 1511Z >
+
+
+

You've arrived. Try some commands, and see how they feel. (In +case you were wondering, "Iain", "M0ADI" and "GB7SJP" all came +from the version of DXVars.pm that was on the machine when I +started the winclient.pl) +

+

5.3 Incoming telnets +

+ +

If you want to enable inbound "TELNET" connections, you've got a +little more work to do. From a handy "DOS box" that's not doing +anything else, do the following:- +

+

+
+copy \spider\perl\listeners.pm \spider\local
+cd \spider\local
+notepad listeners.pm
+
+
+

The following lines need attention:- +

+

+
+["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. +

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. +

+

5.4 Connecting to other clusters +

+ +

If you want to connect this to another cluster, then you'll want +to negotiate a link with someone. For experimental purposes, I'm +happy to allow folk to connect to GB7DXA (spud.ath.cx), on the +understanding that the system may or may not be there and may or +may not be connected to anything particularly useful at any given +moment. Contact me by Email if you want me to set up a connection +for you. +

+


+Next +Previous +Contents + +