BANAL version 0.03

Chapter 5: Administration and Setup

The server (bkd) must know where the books (your directory with the tables) is located. It must also have access (including write access if you are going to modify the records).

Here is the usage for the bkd server:

Usage: bkd [ options ]

-b dir set books directory (def. current directory)
-h print this message
-L dir set library directory (sane default based on bkd location)
-p port set server port (def. 1678)
-r dir set RDB directory (def. same directory as bkd)
-s sec interval for batches (def. 3600 seconds - 0 to disable)

5.1: Starting the Server

If you are in the directory containing your books then the server may be started by a command line as simple as:

bkd >> BKLOG 2>&1 &

It is your responsiblity to put the server in the background. In the future, example startup scripts may be available. Feel free to contribute any that you write.

5.2: Installation

The quick details on installation is that if you've untarred the distribution then it is essentially installed.

If your perl executable is not at /usr/lib/perl, you must edit the first line of the bk, bkd, column, headchg, row and tablegen (yep, all of them) scripts.

You will have to generate your books (or use the ones that are provided) and we recommend that they are not in the BANAL distribution hierarchy. See section 3.3 for information on creating your books.

As this application grows in complexity, the installation process may be required.

5.2.1: Installing the Client only

To install only the client portion of this software, copy the following files to your directory of choice:

bk-0.03/bin/bk
bk-0.03/lib/BK/Client.pm
bk-0.03/lib/BK/Composer.pm

If your version of perl is not at /usr/lib/perl, you must edit the first line of the bk, bkd, column, headchg, row and tablegen (yep, all of them) scripts.

If you don't maintain the .../bin/ and .../lib/ relationship then you will need to run bk (and bkd) with the -L option.