Objectivity/DB

Testing Objectivity/DB Installation

Purpose

A set of test programs to test that Objectivity/DB has been correctly installed and that the various platforms interoperate correctly.

Method

The main script mainsc will run the test on a number of remote platforms, each of which will serve in turn as the database client. It will then use all combinations of remote hosts, creating remote federations and databases, populating them and reading the objects back.

A diagram can be found here.

In case of errors, processing terminates.

The following scripts and programs exist:

conf - which contains all the variables needed by script. You have to set path to current program directory, path to the executable directory, paths to executables. You have to specify hosts names on which you want make tests with assigning them appropriate variables according to platforms. You should specify also database ID and federation and database directory (default /tmp). 

mainsc - which starts sc1 script for each host.

sc1 - which calls test1sc program with lock servers on each host.

sc2 - which executes reading for each database on each host.

test1sc - which creates federation on a given host and databases on each one. In each database an object is created and read from each other host. Finaly program checks if there is no remaining locks and removes databases and federation.

serversc - which calls for each platform servsc script.

servsc - which starts lockserver and ams on each host.

To execute mainsc you should:

• Copy all files files form /afs/cern.ch/rd45/tests/install/testplatf1 to a new_directory in which you will run test program.
• Create in your new directory subdirectories: AIX,OSF1,HP-UX,Solaris,Linux which represent five platforms IBM, DEC,HP,Sun and Linux. They will contain executable files for different platforms. Copy executable files from /afs/cern.ch/rd45/tests/install/$OS to your new_directory/$OS.
• Make changes in conf file setting all the variables from #local variables for test program. You have to set current program directory (your new_directory), path to executable directory (your new_directory in this case), paths to executables directory (new_directory/$OS), host names on which you want to test program ("rsh" for IBM, "dxh" for DEC, "hph" for HP, "sunh" for Sun, "sgih" for SGI, "lnxh" for Linux. You can change federation ID and place where federation and databases are created - changes not suggested escpecially to second one.
• At the beginning of mainsc, sc1, sc2, servsc set correct path a configuration file (new_directory/conf).
• Start serversc script and check if lockserver and ams is running on all hosts you want run the test.
• Execute mainsc script which will test all the hosts from configuration file. In case of error program will stop execution which allows to find out problems with a given platform.