]> scm.dxcluster.org Git - spider.git/blob - html/wininstallation-2.html
Add Iains Windoze manual
[spider.git] / html / wininstallation-2.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <HTML>
3 <HEAD>
4  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
5  <TITLE>The Installation Guide for DXSpider under Microsoft Windows: Installing the software</TITLE>
6  <LINK HREF="wininstallation-1.html" REL=previous>
7  <LINK HREF="wininstallation.html#toc2" REL=contents>
8 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
9 </HEAD>
10 <BODY>
11 Next
12 <A HREF="wininstallation-1.html">Previous</A>
13 <A HREF="wininstallation.html#toc2">Contents</A>
14 <HR>
15 <H2><A NAME="s2">2. Installing the software</A></H2>
16
17 <P>Ensure that your CVS session or your unZIPped file have left you
18 with a directory "C:\spider\local"; if not, go to "C:\spider\"
19 and create one. If "C:\spider" is missing, go back and figure out
20 why, because it shouldn't be.
21 <P>Now create your own local copy of the DXVars.pm file by:-
22 <P>
23 <BLOCKQUOTE><CODE>
24 <PRE>
25 copy c:\spider\perl\DXVars.pm.issue
26 c:\spider\local\DXVars.pm
27 </PRE>
28 </CODE></BLOCKQUOTE>
29 <P>Now you'll need to edit this file using a text editor. If nothing
30 else, you can simply
31 <P>
32 <BLOCKQUOTE><CODE>
33 <PRE>
34 cd \spider\local
35 </PRE>
36 </CODE></BLOCKQUOTE>
37 <P>and then
38 <P>
39 <BLOCKQUOTE><CODE>
40 <PRE>
41 notepad DXVars.pm
42 </PRE>
43 </CODE></BLOCKQUOTE>
44 <P>to bring up an editor window containing the file. As an absolute
45 minimum you must adjust the following items in DXVars.pm:-
46 <P>
47 <UL>
48 <LI> $mycall  - Should hold the callsign of your DX Cluster</LI>
49 <LI> $myname  - The SysOp's first name</LI>
50 <LI> $myalias - the SysOp's callsign. Cannot be the same as $mycall!</LI>
51 </UL>
52 <P>You really also ought to update the $mylatitude, $mylongitude,
53 $myqth and $myemail variables. And unless you are absolutely
54 certain you know what you're doing, you should change nothing
55 else in this file.
56 <P>
57 <H2><A NAME="ss2.1">2.1 The AGW packet engine</A>
58 </H2>
59
60 <P>On the assumption that you'll be using the SV2AGW Packet Engine
61 to interface your radios to the cluster, you should now create
62 your own local copy of AGWConnect.pm by:-
63 <P>
64 <BLOCKQUOTE><CODE>
65 <PRE>
66 copy c:\spider\perl\AGWConnect.pm
67 c:\spider\local\AGWConnect.pm
68 </PRE>
69 </CODE></BLOCKQUOTE>
70 <P>and then
71 <P>
72 <BLOCKQUOTE><CODE>
73 <PRE>
74 notepad AGWConnect.pm
75 </PRE>
76 </CODE></BLOCKQUOTE>
77 <P>to bring up an editor window containing the file. You must
78 consider adjusting the following items in AGWConnect.pm:-
79 <P>
80 <UL>
81 <LI>$enable - set to '1' to enable AGWPE interface </LI>
82 <LI>$login  - the login ID you chose when you set up the SV2AGW security :-)</LI>
83 <LI>$passwd - password that matches $login</LI>
84 </UL>
85 <P>
86 <H2><A NAME="ss2.2">2.2 Setting up the initial user files</A>
87 </H2>
88
89 <P>Next you need to create the initial user files, etc. A tool is
90 supplied which will do this for you. To run the tool:-
91 <P>
92 <BLOCKQUOTE><CODE>
93 <PRE>
94 cd \spider\perl
95 perl create_sysop.pl
96 </PRE>
97 </CODE></BLOCKQUOTE>
98 <P>If all goes according to plan, you will see no output from this
99 program, and after a brief wait, your DOS prompt will be
100 returned.
101 <P>Depending on how brave you are, you might now care to try the
102 following:-
103 <P>
104 <BLOCKQUOTE><CODE>
105 <PRE>
106 perl cluster.pl
107 </PRE>
108 </CODE></BLOCKQUOTE>
109 <P>If you did everything you were told, your DOS window will now
110 hold a display which looks something like:-
111 <P>
112 <BLOCKQUOTE><CODE>
113 <PRE>
114 DXSpider DX Cluster Version 1.47
115 Copyright (c) 1998-2001 Dirk Koopman G1TLH
116 loading prefixes ...
117 loading band data ...
118 loading user file system ...
119 starting listeners ...
120 Internal port: localhost 27754
121 load badwords: Ok
122 reading in duplicate spot and WWV info ...
123 reading existing message headers ...
124 load badmsg: Ok
125 load forward: Ok
126 load swop: Ok
127 @msg = 0 before delete
128 @msg = 0 after delete
129 reading cron jobs ...v cron: reading /spider/cmd/crontab
130 cron: adding 1 0 * * 0
131 DXUser::export("$main::data/user_asc")
132 reading database descriptors ...
133 doing local initialisation ...
134 orft we jolly well go ...
135 queue msg (0)
136 </PRE>
137 </CODE></BLOCKQUOTE>
138 <P>Now, if that's what you've got, you are very nearly home and dry
139 (in as far as these particular experiments are concerned, anyhow)
140 <P>To access your new cluster (from the local machine) find yourself another
141 "DOS box" and do the following:-
142 <P>
143 <BLOCKQUOTE><CODE>
144 <PRE>
145 cd \spider\perl
146 perl winclient.pl
147 </PRE>
148 </CODE></BLOCKQUOTE>
149 <P>If you are rewarded with a display which looks something like:-
150 <P>
151 <BLOCKQUOTE><CODE>
152 <PRE>
153 Hello Iain, this is GB7SJP in Amersham, Bucks running DXSpider V1.47
154 Cluster: 1 nodes, 1 local / 1 total users Max users 2 Uptime 0 00:00
155 M0ADI de GB7SJP 4-Mar-2001 1511Z >
156 </PRE>
157 </CODE></BLOCKQUOTE>
158 <P>You've arrived. Try some commands, and see how they feel. (In
159 case you were wondering, "Iain", "M0ADI" and "GB7SJP" all came
160 from the version of DXVars.pm that was on the machine when I
161 started the winclient.pl)
162 <P>
163 <H2><A NAME="ss2.3">2.3 Incoming telnets</A>
164 </H2>
165
166 <P>If you want to enable inbound "TELNET" connections, you've got a
167 little more work to do. From a handy "DOS box" that's not doing
168 anything else, do the following:-
169 <P>
170 <BLOCKQUOTE><CODE>
171 <PRE>
172 copy \spider\perl\listeners.pm \spider\local
173 cd \spider\local
174 notepad listeners.pm
175 </PRE>
176 </CODE></BLOCKQUOTE>
177 <P>The following lines need attention:-
178 <P>
179 <BLOCKQUOTE><CODE>
180 <PRE>
181 ["localhost", 7300],
182 ["foo.dxcluster.net", 7300],
183 </PRE>
184 </CODE></BLOCKQUOTE>
185 <P>On my machine, I've simply uncommented the "localhost" entry by
186 removing the '#' from the front of the line. I've also
187 uncommented the second line, and changed the hostname to point at
188 "spud.ath.cx".
189 <P>If you don't have a static hostname for your machine, and you
190 intend to allow folk to connect to your machine across the
191 internet, then I'd suggest you pay a visit to www.dyndns.org and
192 create one for yourself. While it's free, it will take a modest
193 an amount of effort on your part to read, understand and
194 implement what needs to be done to set this up.
195 <P>
196 <H2><A NAME="ss2.4">2.4 Connecting to other clusters</A>
197 </H2>
198
199 <P>If you want to connect this to another cluster, then you'll want
200 to negotiate a link with someone. For experimental purposes, I'm
201 happy to allow folk to connect to GB7DXA (spud.ath.cx), on the
202 understanding that the system may or may not be there and may or
203 may not be connected to anything particularly useful at any given
204 moment. Contact me by Email if you want me to set up a connection
205 for you.
206 <P><I>Last updated: 05-Mar-01</I>
207 <P>
208 <HR>
209 Next
210 <A HREF="wininstallation-1.html">Previous</A>
211 <A HREF="wininstallation.html#toc2">Contents</A>
212 </BODY>
213 </HTML>