X-Git-Url: http://gb7djk.dxcluster.net/gitweb/gitweb.cgi?a=blobdiff_plain;f=sgml%2Fadminmanual.sgml;h=d5af7064566a5b3de33d9fdde9e3b5ff76bcdad4;hb=cfa4c1acfabeda359815ca58670b4dde4f260a79;hp=2dc01d83de453229d416df47f355d7a3549471f6;hpb=6b892fb053b8a1c28e68d7dd34d6bb006bc18bc5;p=spider.git diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml index 2dc01d83..d5af7064 100644 --- a/sgml/adminmanual.sgml +++ b/sgml/adminmanual.sgml @@ -4,9 +4,9 @@ -The DXSpider Administration Manual v1.49 +The DXSpider Administration Manual v1.50 Ian Maude, G0VGS, (g0vgs@gb7mbc.net) -February 2002 revision 1.3 +July 2002 revision 0.1 A reference for SysOps of the DXSpider DXCluster program. @@ -554,7 +554,7 @@ all work on their specific area of the protocol. The set/hops command overrides any hops that you have set otherwise.

-You can set what hops have been set using the show/hops command. +You can show what hops have been set using the show/hops command. Isolating networks @@ -798,6 +798,9 @@ only be sent to the UK links and not to PA4AB-14.

To force the cluster to reread the file use load/forward +

+NB: If a user tries to send mail to a bulletin address that does not exist +in this file, they will get an error. The msg command @@ -910,7 +913,7 @@ below and is included in the distribution as startup.issue. # startup script example # # set maximum no of spots allowed to 100 -# set/var $Spot::maxspots = 1 +# set/var $Spot::maxspots = 100 # # Set registration on # set/var $main::reqreg = 1 @@ -927,8 +930,7 @@ above there are three options. The first option is the amount of spots that a user can request with the sh/dx command. Normally the default is to give 10 spots unless the user specifies more. Without this line enabled, the maximum a user can request is 100 spots. Depending on your link quality -you may wish to enable more or less by specifying the number. If you simply -uncomment the line, the maximum would be 1 spot! +you may wish to enable more or less by specifying the number.

The other 2 options are dealt with more fully in the security section. @@ -1341,6 +1343,107 @@ ID and password. You also at this point need to set $allow=1 to complete the setup. Many thanks to Fred Lloyd, the proprieter of for allowing this access. +Connecting logging programs + +

+There appear to be very few logging programs out there that support telnet +especially the popular ones like LogEQF, Turbolog etc. This can make it +difficult to connect to your own cluster! +The way to do it is to make the logging program think it has a TNC attached +to a com port on the logging PC and 'push' a linux login out to it. +This is achieved very simply by the use of agetty. + +

+All that is required is to add a line in /etc/inittab to have the client +ready for a connection on the com port of your choice. Remember that in +Linux, the com ports start at ttyS0 for com1, ttyS1 for com2 etc. + + +c4:2345:respawn:/sbin/agetty -L 9600 ttyS1 + + +

+Add this after the standard runlevel lines in /etc/inittab. The above +line works on ttyS1 (com2). Now as root, issue the command telinit q +and it should be ready for connection. All that is required is a 3 wire +serial lead (tx, rx and signal ground). Tell you logging program to use +8n1 at 9600 baud and you should see a Linux login prompt. Login as normal +and then telnet from there to the cluster. + +Java Web applet + +

+In the spider tree will be a directory spider-web. This is a +neat little java web applet that can be run from a website. The applet +must run on the same machine as the cluster. The included README file is +shown below. + +

+I should comment here that the applet is precompiled, that is, ready to go. +It was compiled using JDK1.3.1. If your version is earlier than this then it +may not work. Should that be the case you need to recompile or update your +JDK. To recompile do the following ... + + +cd /spider/spider-web +rm *.class +/usr/bin/javac spiderclient.java + + +

+I have used /usr/bin/javac as an example, your path to javac may be different. + + +Spider-WEB v0.6b + +Completely based on a clx web client written in Java by dl6dbh +(ftp://clx.muc.de/pub/clx/clx-java_10130001.tgz) + +The webserver has to run on the same machine as your DxSpider software! + +It is assumed that you have Java installed. You need JDK1.3.1 at least. + +Installation instructions (Performed as root): + +Put all the files in the spider-web directory into a newly created directory +under the DocumentRoot of your websever for instance 'client'. In my case +this is: /home/httpd/html/client/ although ymmv. For Suse the correct +path should be /usr/local/httpd/htdocs/client/ for example. + +Move spider.cgi to the cgi-bin directory of your webserver, in my case that is +/home/httpd/cgi-bin/ although ymmv. For Suse the correct path should be +/usr/local/httpd/cgi-bin/ for example. + +Change the permissions of the files to ensure they are correct, obviously you +will need to use the correct path the the files according to your system: + +chmod 755 /home/httpd/html/cgi-bin/spider.cgi +chmod -R 755 /home/httpd/html/client/ + +By default the spider.cgi script should pick up your hostname (As long as this +is set correctly). If it does not or your hostname differs from the name that +you attach to the public address that you are using, then edit spider.cgi : + +# Uncomment and set the hostname manually here if the above fails. +# $HOSTNAME = "gb7mbc.spoo.org" ; +$PORT = "8000" ; + +'HOSTNAME' is the hostname of your cluster. + +'PORT' is the portnumber that you use to connect to your DxSpider via +telnet (see Listeners.pm) + +NOTE: If you can start the console but cannot connect to the cluster from it, +then it is possible that the machine you are on cannot resolve the hostname of +your cluster machine. If this is the case, you need to set your hostname +manually as above. + +You also need to set the $NODECALL variable. This prints the name of your +choosing (probably your cluster callsign) on the html page. + +You now can connect to Spider-Web via http://yourserver/cgi-bin/spider.cgi + + Security

@@ -2230,6 +2333,27 @@ There is NO SECOND CHANCE. It goes without saying that you should use this command CAREFULLY! +demonstrate (9) + +

+ +demonstrate <call> <command> Demonstrate a command to another user + + +

+This command is provided so that sysops can demonstrate commands to +other users. It runs a command as though that user had typed it in and +then sends the output to that user, together with the command that +caused it. + + + DEMO g7brn sh/dx iota oc209 + DEMO g1tlh set/here + + +Note that this command is similar to SPOOF and will have the same side +effects. Commands are run at the privilege of the user which is being +demonstrated to. directory (0)