X-Git-Url: http://scm.dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;ds=inline;f=html%2Finstall.html;h=72be551124103e22916500dcc6c45034501e5856;hb=cd5a9bf8711c676352b647705008bc59d66a354a;hp=74c432ce4bf80c7bce1c4df118da682a4d353bb1;hpb=69c8aeb338cc485103e289fbab7ec4e7e056ed20;p=spider.git diff --git a/html/install.html b/html/install.html index 74c432ce..72be5511 100644 --- a/html/install.html +++ b/html/install.html @@ -17,7 +17,7 @@
Iain Phillips G0RDI -Last modified: Sat Dec 19 16:10:14 GMT 1998 +Last modified: Fri Jan 8 00:29:25 GMT 1999This HOWTO describes the installation for DX Spider v1.11 on a "vanilla" RedHat 5.1 platform, @@ -25,6 +25,10 @@ Last modified: Sat Dec 19 16:10:14 GMT 1998 Red Hat 5.1 distribution. I always select 'everything', and that seems to ensure that nothing is missed out :-) [ more normal people may like to try with less Ed ]. +
WARNING The perl on the vanilla RedHat 5.2 + (perl-5.004m4-1.i386.rpm) is BROKEN, please use the one + in the Download section. +
The crucial ingredient for all of this is Perl 5.004. Now I know Perl 5.005 is out and this will almost certainly work with it, but RedHat 5.1 comes with 5.004. @@ -158,25 +162,76 @@ spider:x:251:sysop,g0rdi,root
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. -
-exec /spider/perl/client.pl <callsign> telnet --
Alternatively you can set up a real login for a person (or another cluster) by creating a login using:- -
-# useradd gb7djk +
+# useradd -m gb7djk # passwd gb7djk New UNIX password: Retype new UNIX password: passwd: all authentication tokens updated successfully-
and editing the /etc/passwd file to look like this (do substitute the correct callsigns here ;-):- + +
You can then either 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 ++ +
Alternatively you can alter the /etc/passwd thus:- +
fbb:x:505:505::/home/fbb:/bin/bash gb7djk:x:506:506::/home/gb7djk:/usr/bin/perl /spider/perl/client.pl gb7djk 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.). + Don't forget to give them a real password. 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.). If the user or other cluster + program requires AX25 conventions to operate then you can use + ax25 instead. + +
Another thing you can do is to get inetd to listen + on a specific port and then start the client up directly. To + do this, create an entry in /etc/services with a + port number > 1000 that isn't used elsewhere eg:- + +
+gb7djk 8001/tcp +gb7tlh 8002/tcp ++ + Then create some lines in /etc/inetd.conf that look + like this:- + +
+gb7djk stream tcp nowait sysop /usr/sbin/tcpd /usr/bin/perl /spider/perl/client.pl gb7djk telnet +gb7tlh stream tcp nowait sysop /usr/sbin/tcpd /usr/bin/perl /spider/perl/client.pl gb7tlh telnet ++ + Please DON'T run the client as root you will only + come to regret it later when the next person finds a security hole + in DX Spider (there are bound to be some although I have tried to + avoid the obvious ones I could think of). + +
The only reason I would use this mechanism is for Internet connections + to other or from other clusters. Don't use this for normal users. + +
In the example I have used tcpd as the access control + mechanism to the port. Don't (I can't be bothered to emphasize + it any more) run a system like this without one, you are asking + for trouble. In fact I use the TIS + Firewall Toolkit myself, you may find this more intuitive + to use. The point is that gb7djk would only be coming + from one IP address, if it coming from another, it is an imposter! + +
You are responsible for arranging and looking after your + security - not me. +
[ether] @@ -195,7 +250,7 @@ default * * * * * * - sysop /spider/perl/client.pl client.pl %u ax25
This has to be done to allow you to specify the correct callsigns on outgoing connects -
$ startx (much easier to use X) $ cd /spider @@ -258,8 +313,7 @@ PC38^GB7JIM^~ <- the cluster thinks this is a clusterYou should now have a basic working system. Best of luck! Can I now draw your attention to - the Bug Reporting System. Some mailing lists will - be created RSN for more general discussions. + the Bug Reporting System.
Can I commend to you the Announcements mailing list to which you may subscribe. @@ -268,7 +322,7 @@ PC38^GB7JIM^~ <- the cluster thinks this is a cluster
If you like what you see and want to be a part of the ongoing development then subscribe - to the support mailing list which will be the initial focus of any discussions. + to the support mailing list which will be the focus of any discussion/bug fixing etc.