Starting the Sapphire/Gateway Database Administration

A Sapphire/Gateway daemon should be started on the machine(s) that run web servers as well as machines used for development. If the web server machine and the machine that runs Sapphire/Web are the same, only one Gateway is necessary. See the chapter "Using the Sapphire/Gateway" in this Guide for more information.

Throughout this manual, commands are given both for users of the C shell and of the Bourne/Korn shell. If you are not sure what shell you are using, type ps. C shell users will see a process called csh or -sh (csh), Bourne users will simply see sh, and Korn users will see ksh.

: Note: These commands are case sensitive.

Starting the Sapphire/Gateway under C shell

: 1. Set environment variables specific to the database(s) you will use. On many systems, the Install script will have already set these values. Run env to see if this has happened and, if so, skip to step 2.
: SYBASE

	setenv SYBASE sybase_directory


 where sybase_directory is the directory containing the Sybase interfaces file.

: ORACLE

	setenv ORACLE_HOME oracle_directory
	setenv ORACLE_SID default_oracle_database


 where oracle_directory is the directory in which Oracle is installed and default_oracle_database is the name of a local Oracle database, or a connection string, to a remote Oracle database.

: INFORMIX

	setenv INFORMIXDIR informix_directory


 where informix_directory is the directory containing the etc/sqlhosts file.

: 2. Set the SAPPHIRE environment variable.

	setenv $SAPPHIRE sapphire_home


 where sapphire_home is the full path to the directory that contains the Sapphire/Web distribution.

: 3. Start Sapphire/Gateway on the necessary machine(s).

	$SAPPHIRE/bin/dborbd.sh

Starting the Sapphire/Gateway under Bourne/Korn shell

: 1. Set environment variables specific to the database(s) you will use. On many systems, the Install script will have already set these values. Run env to see if this has happened and, if so, skip to step 2.
: SYBASE

	SYBASE=sybase_directory; export SYBASE


 where sybase_directory is the directory containing the Sybase interfaces file.

: ORACLE

	ORACLE_HOME=oracle_directory
	export ORACLE_HOME
	ORACLE_SID=default_oracle_database
	export ORACLE_SID


 where oracle_directory is the directory in which Oracle is installed and default_oracle_database is the name of a local Oracle database, or a connection string, to a remote Oracle database.

: INFORMIX

	INFORMIXDIR=informix_directory; export INFORMIXDIR


 where informix_directory is the directory containing the etc/sqlhosts file.

: 2. Set the SAPPHIRE environment variable.

	SAPPHIRE=sapphire_home; export Sapphire


 where sapphire_home is the full path to the directory that contains the Sapphire/Web distribution.

: 3. Start Sapphire/Gateway on the necessary machine(s).

	$SAPPHIRE/bin/dborbd.sh

[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com