X-Git-Url: http://www.dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Fadminmanual-4.html;h=f74b9e43dddbff1bf9cbc1b612a1b8483bb4c400;hb=1bb3ae1a09a6117d93c02041bff9b5cd2d4819ef;hp=37ff648b53ad8efaf2a2bd64c8a4b50cff9364ab;hpb=d2c1a8cb2a31725e3b9084aee3ec43e585e3273f;p=spider.git diff --git a/html/adminmanual-4.html b/html/adminmanual-4.html index 37ff648b..f74b9e43 100644 --- a/html/adminmanual-4.html +++ b/html/adminmanual-4.html @@ -1,8 +1,8 @@ - - The DXSpider Administration Manual v1.48: Scripts + + The DXSpider Administration Manual v1.50: Scripts @@ -13,42 +13,80 @@ Previous Contents
-

4. Scripts

+

4. Scripts

From 1.48 onwards it will become increasingly possible to control DXSpider's -operation with scripts of various kinds. -

-

In the first instance, in 1.48, the sysop can create, with their favorite -text editor, files in the directory /spider/scripts which contain -any legal command for a callsign or class of connection which will be executed -at logon. -

-

-The filename are the callsign of the connection that you want the script to -operate on, eg: /spider/scripts/g1tlh. The filenames are always in -lower case on those architectures where this makes a difference. -

-

In addition to the callsign specific scripts there are three others:- +operation with scripts of various kinds.

+ +

The directory /spider/scripts is where it all happens and is used for several +things. Firstly it contains a file called startup that can be used to call +in any changes to the cluster from the default settings on startup. This +script is executed immediately after all initialisation of the node is done +but before any connections are possible. Examples of this include how many +spots it is possible to get with the sh/dx command, whether you want +registration/passwords to be permanently on etc. An example file is shown +below and is included in the distribution as startup.issue.

-startup
-user_default
-node_default
+#
+# startup script example
+#
+# set maximum no of spots allowed to 100
+# set/var $Spot::maxspots = 100
+#
+# Set registration on
+# set/var $main::reqreg = 1
+#
+# Set passwords on
+# set/var $main::passwdreq = 1
+#
 
-

The startup script is executed immediately after all -initialisation of the node is done, but before any connections are -possible. -

-

The user_default script is executed for every user that does -NOT already have a specific script. -

-

The node_default script is executed for every node that doesn't -have a specific script. -

-

There are a couple of examples in the /spider/scripts directory. +

+ +

As usual, any text behind a # is treated as a comment and not read. To use +this file, simply rename it from startup.issue to startup. In our example +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.

+ +

The other 2 options are dealt with more fully in the security section.

+ +

Secondly, it is used to store the login scripts for users and nodes. Currently +this can only be done by the sysop but it is envisaged that eventually users will +be able to set their own. An example is included in the distibution but here is +a further example.

+

+
+#
+# G0FYD
+#
+blank +
+sh/wwv 3
+blank +
+sh/dx 
+blank +
+t g0jhc You abt?
+blank +
+
+
+

+

The lines in between commands can simply insert a blank line or a character +such as a + sign to make the output easier to read. Simply create this script +with your favourite editor and save it with the callsign of the user as the +filename. Filenames should always be in lower case.

+ +

Commands can be inserted in the same way for nodes. A node may wish a series +of commands to be issued on login, such as a merge command for example.

+ +

Thirdly, there are 2 default scripts for users and nodes who do not have a +specifically defined script. These are user_default and +node_default

+
Next Previous