minor update on manuals
[spider.git] / html / adminmanual-4.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 DXSpider Administration Manual v1.49: Scripts</TITLE>
6  <LINK HREF="adminmanual-5.html" REL=next>
7  <LINK HREF="adminmanual-3.html" REL=previous>
8  <LINK HREF="adminmanual.html#toc4" REL=contents>
9 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
10 </HEAD>
11 <BODY>
12 <A HREF="adminmanual-5.html">Next</A>
13 <A HREF="adminmanual-3.html">Previous</A>
14 <A HREF="adminmanual.html#toc4">Contents</A>
15 <HR>
16 <H2><A NAME="s4">4. Scripts</A></H2>
17
18 <P>From 1.48 onwards it will become increasingly possible to control DXSpider's
19 operation with scripts of various kinds.
20 <P>
21 <P>The directory /spider/scripts is where it all happens and is used for several 
22 things.  Firstly it contains a file called startup that can be used to call 
23 in any changes to the cluster from the default settings on startup.  This
24 script is executed immediately after all initialisation of the node is done
25 but before any connections are possible.  Examples of this include how many 
26 spots it is possible to get with the sh/dx command, whether you want 
27 registration/passwords to be permanently on etc.  An example file is shown 
28 below and is included in the distribution as startup.issue.
29 <P>
30 <BLOCKQUOTE><CODE>
31 <PRE>
32 #
33 # startup script example
34 #
35 # set maximum no of spots allowed to 100
36 # set/var $Spot::maxspots = 1
37 #
38 # Set registration on
39 # set/var $main::reqreg = 1
40 #
41 # Set passwords on
42 # set/var $main::passwdreq = 1
43 #
44 </PRE>
45 </CODE></BLOCKQUOTE>
46 <P>
47 <P>As usual, any text behind a # is treated as a comment and not read.
48 <P>Secondly, it is used to store the login scripts for users and nodes.  Currently
49 this can only be done by the sysop but it is envisaged that eventually users will 
50 be able to set their own.  An example is included in the distibution but here is 
51 a further example.
52 <P>
53 <BLOCKQUOTE><CODE>
54 <PRE>
55 #
56 # G0FYD
57 #
58 blank +
59 sh/wwv 3
60 blank +
61 sh/dx 
62 blank +
63 t g0jhc You abt?
64 blank +
65 </PRE>
66 </CODE></BLOCKQUOTE>
67 <P>The lines in between commands can simply insert a blank line or a character
68 such as a + sign to make the output easier to read.  Simply create this script
69 with your favourite editor and save it with the callsign of the user as the
70 filename.  Filenames should always be in lower case.
71 <P>
72 <P>Commands can be inserted in the same way for nodes.  A node may wish a series
73 of commands to be issued on login, such as a merge command for example.
74 <P>
75 <P>Thirdly, there are 2 default scripts for users and nodes who do not have a
76 specifically defined script.  These are <EM>user_default</EM> and
77 <EM>node_default</EM>
78 <P>
79 <HR>
80 <A HREF="adminmanual-5.html">Next</A>
81 <A HREF="adminmanual-3.html">Previous</A>
82 <A HREF="adminmanual.html#toc4">Contents</A>
83 </BODY>
84 </HTML>