mirror of
git://scm.dxcluster.org/scm/spider
synced 2024-09-21 15:57:12 +00:00
211 lines
6.2 KiB
HTML
211 lines
6.2 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
|
|
<TITLE>The DXSpider Installation Manual v1.48: Installing the software</TITLE>
|
|
<LINK HREF="installation-6.html" REL=next>
|
|
<LINK HREF="installation-4.html" REL=previous>
|
|
<LINK HREF="installation.html#toc5" REL=contents>
|
|
<link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
|
|
</HEAD>
|
|
<BODY>
|
|
<A HREF="installation-6.html">Next</A>
|
|
<A HREF="installation-4.html">Previous</A>
|
|
<A HREF="installation.html#toc5">Contents</A>
|
|
<HR>
|
|
<H2><A NAME="s5">5. Installing the software</A></H2>
|
|
|
|
<P>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.
|
|
<P>Now create your own local copy of the DXVars.pm file by:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
copy c:\spider\perl\DXVars.pm.issue
|
|
c:\spider\local\DXVars.pm
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>Now you'll need to edit this file using a text editor. If nothing
|
|
else, you can simply
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
cd \spider\local
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>and then
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
notepad DXVars.pm
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>to bring up an editor window containing the file. As an absolute
|
|
minimum you must adjust the following items in DXVars.pm:-
|
|
<P>
|
|
<UL>
|
|
<LI> $mycall - Should hold the callsign of your DX Cluster</LI>
|
|
<LI> $myname - The SysOp's first name</LI>
|
|
<LI> $myalias - the SysOp's callsign. Cannot be the same as $mycall!</LI>
|
|
</UL>
|
|
<P>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.
|
|
<P>
|
|
<H2><A NAME="ss5.1">5.1 The AGW packet engine</A>
|
|
</H2>
|
|
|
|
<P>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:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
copy c:\spider\perl\AGWConnect.pm
|
|
c:\spider\local\AGWConnect.pm
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>and then
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
notepad AGWConnect.pm
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>to bring up an editor window containing the file. You must
|
|
consider adjusting the following items in AGWConnect.pm:-
|
|
<P>
|
|
<UL>
|
|
<LI>$enable - set to '1' to enable AGWPE interface </LI>
|
|
<LI>$login - the login ID you chose when you set up the SV2AGW security :-)</LI>
|
|
<LI>$passwd - password that matches $login</LI>
|
|
</UL>
|
|
<P>
|
|
<H2><A NAME="ss5.2">5.2 Setting up the initial user files</A>
|
|
</H2>
|
|
|
|
<P>Next you need to create the initial user files, etc. A tool is
|
|
supplied which will do this for you. To run the tool:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
cd \spider\perl
|
|
perl create_sysop.pl
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>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.
|
|
<P>Depending on how brave you are, you might now care to try the
|
|
following:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
perl cluster.pl
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>If you did everything you were told, your DOS window will now
|
|
hold a display which looks something like:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
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)
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>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)
|
|
<P>To access your new cluster (from the local machine) find yourself another
|
|
"DOS box" and do the following:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
cd \spider\perl
|
|
perl winclient.pl
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>If you are rewarded with a display which looks something like:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
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 >
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>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)
|
|
<P>
|
|
<H2><A NAME="ss5.3">5.3 Incoming telnets</A>
|
|
</H2>
|
|
|
|
<P>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:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
copy \spider\perl\listeners.pm \spider\local
|
|
cd \spider\local
|
|
notepad listeners.pm
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>The following lines need attention:-
|
|
<P>
|
|
<BLOCKQUOTE><CODE>
|
|
<PRE>
|
|
["0.0.0.0", 7300],
|
|
</PRE>
|
|
</CODE></BLOCKQUOTE>
|
|
<P>On my machine, I've simply uncommented the "0.0.0.0" entry by
|
|
removing the '#' from the front of the line.
|
|
<P>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.
|
|
<P>
|
|
<H2><A NAME="ss5.4">5.4 Connecting to other clusters</A>
|
|
</H2>
|
|
|
|
<P>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.
|
|
<P>
|
|
<HR>
|
|
<A HREF="installation-6.html">Next</A>
|
|
<A HREF="installation-4.html">Previous</A>
|
|
<A HREF="installation.html#toc5">Contents</A>
|
|
</BODY>
|
|
</HTML>
|