[Prev] [Next] [Top] [Bottom] [Contents] (4 out of 6)

Starting a Gateway Daemon

Required For All Configurations

To run the ORB for any configuration, the environment must be setup to talk to the desired database vendors. Set the variables for only the Databases you wish to install as follows:

ORB Environment (cshell):

setenv SYBASE sybase_root
setenv ORACLE_SID default_database_name
setenv INFORMIXDIR informix_root

ORB Environment (Bourne or Korn shell):

SYBASE=sybase_root_directory
ORACLE_SID=default_database_name
INFORMIXDIR=informix_root_directory
export SYBASE ORACLE_SID INFORMIXDIR

Daemon On Same Machine As CGI or Sapphire/Web

The simplest way to start a Gateway Daemon is to start one on the same machine as you will run the CGI or Sapphire/Web on. For this configuration, do this:

dborbd.sh&
To start Sapphire/Web so it talks to this Gateway, do this:

saweb.sh&
To configure CGIs to talk to this Gateway, you don't need to do anything, as long as the CGI and Gateway are to run on the same machine.

Daemon On Different Machine Than CGI or Sapphire/Web

Running Sapphire/Web and CGIs on different machines than your Gateway is very straight forward. For this configuration, do this:

On the machine you want the Gateway to run, type:

dborbd.sh&
To start Sapphire/Web so that it talks to this Gateway, execute one of these options:

saweb.sh -Hhostname&
where hostname is the machine's name on which the Gateway was started.

Another way to do it is with environment variables:

Cshell:

setenv ORB_HOST hostname
saweb.sh&
Bourne/Korn Shell:

ORB_HOST=hostname
export ORB_HOST
saweb.sh&
where hostname is the machine's name on which the Gateway was started.

To configure CGIs to talk to this Gateway, you need to add one line of code to the project's function main. This can be done inside the Project Code Dialog by adding this line of C code to the /* main function Initial Code */ section:

putenv("ORB_HOST=hostname");
where hostname is the name of the machine on which the Gateway was started.

Multiple Daemons On Different Machine Than CGI or Sapphire/Web

Running multiple Gateway Daemons on the same host is not usually necessary. If you find this is a need, do the following:

On the machine where you want the Gateways to run, type:

dborbd.sh -r10&
dborbd.sh -r20&
You can start as many Gateways as necessary by changing the -r# value to a different integer value less than 100,000 for each instance. The -r# option provides the RPC seed number necessary for the Gateway daemon to communicate with its clients.

To start Sapphire/Web so that it talks to a specific Gateway, do one of these options:

saweb.sh -Hhostname -r10&
where hostname is the machine's name that the Gateway was started on and -r# is the matching seed number of the Gateway you wish to use.

Another way to do it is with environment variables:

C Shell:

setenv ORB_HOST hostname
setenv ORB_SEED 10
saweb.sh&
Bourne/Korn Shell:

ORB_HOST=hostname
ORB_SEED=10
export ORB_HOST ORB_SEED
saweb.sh&
where hostname is the name of the machine on which the Gateway was started, and the ORB_SEED value is the matching seed number of the Gateway you wish to use.

To configure CGIs to talk to this Gateway, you need to add two lines of code to the project's function main. This can be done inside the Project Code Dialog by adding this line of C code to the /* main function Initial Code */ section:

putenv("ORB_HOST=hostname");
putenv("ORB_SEED=10");
where hostname is the machine name on which the Gateway was started and the ORB_SEED value is the matching seed number of the Gateway you wish to use.

Note: When using multiple Gateways on the same machine, it is not necessary to specify the ORB_HOST if Sapphire/Web and the CGI are run on the same machine as the Gateways.


[Prev] [Next] [Top] [Bottom] [Contents] (4 out of 6)