FastObjects
From Icbwiki
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.
