X-Git-Url: http://scm.dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=html%2Fadminmanual-4.html;h=a54fa8ceb29de474306fad4952140af5aedcee30;hb=75abae88c65a19102d4a633a273a71750aa97728;hp=9faec43772389c921bd621159da7e775fe48fa0e;hpb=6624dcdf07d628e8d6a16fc6549edf40be25b7b2;p=spider.git diff --git a/html/adminmanual-4.html b/html/adminmanual-4.html index 9faec437..a54fa8ce 100644 --- a/html/adminmanual-4.html +++ b/html/adminmanual-4.html @@ -2,7 +2,7 @@
-Spider allows the creation of local or remote databases. It supports -chained databases, allowing several different databases to be scanned -with one simple command. Importing of databases is limited at present -to the standard AK1A databases such as OBLAST and the DB0SDX QSL -database but will expand with time. +
From 1.48 onwards it will become increasingly possible to control DXSpider's +operation with scripts of various kinds.
-
Creating a database could not be more simple. All the commands are -sent from the cluster prompt as the sysop user. -
To create a database you use the command dbcreate. It can -be used in 3 different ways like so .. -
-
-
-dbcreate <name>
-
-
-To simply create a database locally, you just tell the command the -name of the database. This does not create the actual database, it -simply defines it to say that it exists. -
-
-
-dbcreate <name> chain <name> [<name>...]
-
-
-This creates a chained database entry. The first database will be -scanned, then the second, the third etc... -
-
-
-dbcreate <name> remote <name>
-
-
-This creates a remote entry. the first name field is the database -name at the remote node, then the remote switch, then the actual -node_call of the remote node, for example... -
-
-
-dbcreate buckmaster remote gb7dxc
-
-
-Remote databases cannot be chained, however, the last database in a -chain can be a remote database. -
-
The only databases that Spider can currently import are the standard -AK1A databases such as OBLAST or the DB0SDX qsl and address database. -This will be added to with time. -
To import such a database, first put the file somewhere useful like /tmp -and then issue the following command ... -
-
-
-dbimport oblast /tmp/OBLAST.FUL
-
-
-This will update the existing local oblast database or create it if -it does not exist. +
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.
-
Once a database is created, you will want to check that it has been -added. To do this use the dbavail command. This will -output the available databases. For example ... -
-
-
-dbavail
-DB Name Location Chain
-qsl Local
-buck GB7ADX
-hftest GB7DXM
-G0VGS de GB7MBC 3-Feb-2001 1925Z >
-
-
++The filename is 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.
-
To look for information in a defined database, simply use the dbshow -command, for example ... +
In addition to the callsign specific scripts there are three others:-
-dbshow buckmaster G0YLM
+startup
+user_default
+node_default
-will show the information for the callsign G0YLM from the buckmaster -database if it exists. To make things more standard for the users -you can add an entry in the Aliases file so that it looks like a standard -show command like this ... +
The startup script is executed immediately after all +initialisation of the node is done, but before any connections are +possible.
-
-
-'^sh\w*/buc', 'dbshow buckmaster', 'dbshow',
-
-
-Now you can simply use show/buckmaster or an abreviation. +
The user_default script is executed for every user that does +NOT already have a specific script.
-
To delete an existing database you use the dbremove command. -For example ... +
The node_default script is executed for every node that doesn't +have a specific script.
-
-
-dbremove oblast
-
-
-would remove the oblast database and its associated datafile from the -system. There are no warnings or recovery possible from this command. -If you remove a database it ceases to exist and would have to be created -from scratch if you still required it. +
There are a couple of examples in the /spider/scripts directory.