X-Git-Url: http://dxcluster.net/gitweb/gitweb.cgi?p=spider.git;a=blobdiff_plain;f=html%2Fadminmanual-4.html;h=37ff648b53ad8efaf2a2bd64c8a4b50cff9364ab;hp=9faec43772389c921bd621159da7e775fe48fa0e;hb=d2c1a8cb2a31725e3b9084aee3ec43e585e3273f;hpb=a8d4234c702d3cf6049a9e53bd07cfc924eaee25 diff --git a/html/adminmanual-4.html b/html/adminmanual-4.html index 9faec437..37ff648b 100644 --- a/html/adminmanual-4.html +++ b/html/adminmanual-4.html @@ -2,7 +2,7 @@ - The DXSpider Administration Manual v1.48: Databases + The DXSpider Administration Manual v1.48: Scripts @@ -13,129 +13,41 @@ Previous Contents
-

4. Databases

+

4. Scripts

-

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.

-

4.1 Creating databases -

- -

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. -

-

4.2 Importing databases -

- -

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.

-

4.3 Checking available databases -

- -

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 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.

-

4.4 Looking up databases -

- -

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.

-

4.5 Removing databases -

- -

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.


Next