FastObjects

From Icbwiki

Jump to: navigation, search

FastObjects is a JDO compliant database used by various projects within the ICB.

Contents

Server management

The FastObjects database server currently runs on planck.med.cornell.edu and groucho.med.cornell.edu. The client programs are available on most Linux based systems.

Configuration

On Unix systems, the FastObjects application is installed into a location identified by the environment variable FASTOBJECTS_HOME. Traditionally, this is /opt/FastObjects_t7_9.5. The database files themsevles are located in /var/FastObjects. The main configuration file for the FastObjects server is called ptserver.cfg and is located in ~fastobjects.

Starting the server

The FastObjects server must be run from the fastobjects account. It can be started by executing the following command on the server.

 $FASTOBJECTS_HOME/runtime/bin/ptserver -config ~/ptserver.cfg &

Stopping the server

The FastObjects server can be shutdown from a the local server or any machine on the network. It can be terminated by executing the following command.

 $FASTOBJECTS_HOME/runtime/bin/ptsu -shutdown servername

where servername is the hostname of the FastObjects server.

Data backup and retrieval

Each logical database is stored as a set of files into a subdirectory defined by the configuration file. The convention used is to store each project into a subdirectory under /var/FastObjects. So, for example, the database for the SigPath NMR project is located at /var/FastObjects/sigpath_nmr. When the server is not running, these files can be copied and stored just like any other flat files on the disk. The following sections describe how to backup and restore files without shutting the server completely down.

Backing up a database

The following will backup a database called sigpath_nmr from a server running on the localhost to a compressed tar file called 'backup.tgz'.

 $FASTOBJECTS_HOME/bin/ptadmin -backup begin -base sigpath_nmr -server localhost
 cd /var/FastObjects
 /bin/tar -zcvf backup.tgz sigpath_nmr
 $FASTOBJECTS_HOME/bin/ptadmin -backup end -base sigpath_nmr -server localhost

A script to backup a fastobjects database in this fashion can be found at ~fastobjects/bin/fastobjects-backup.sh on planck. This script runs nightly on planck for the SigPath production and nmr databases.

Restoring up a database

The following will restore the sigpath_nmr in the previous example from the backup file.

 $FASTOBJECTS_HOME/bin/ptadmin -backup begin -base sigpath_nmr -server localhost
 cd /var/FastObjects
 /bin/tar -zxvf backup.tgz
 $FASTOBJECTS_HOME/bin/ptadmin -backup end -base sigpath_nmr -server localhost

A script to restore a fastobjects database in this fashion can be found at ~fastobjects/bin/fastobjects-restore.sh on planck.

Local Installation

The FastObjects software can be found in the ICB Webdav folder. The current recommended version is t7 9.5.16.157. License information can be found in the ICB Intranet.

See Also

Personal tools