CORBA 2.6.1 Administration Guide

This section assumes that you have successfully completed installing your NonStop CORBA system as described in Installing NonStop CORBA.
The installation process gives you a fully configured system. Later you may wish to make modifications to your configuration. The information in
this section shows you how to perform these configuration tasks. Most of the commands described in this section are used in the Open System
Services (OSS) environment. You should be familiar with OSS before attempting any of the configuration tasks described in this section. To
modify the scripts described here you need to use a text editor such as the vi editor. For more information about using OSS commands and the
vi editor see the Open System Services User's Guide.
You should also be familiar with the Guardian environment and file system before starting to configure and manage your system. See the
Guardian User's Guide for information about working in the Guardian environment.
Setting Environment Variables (env.sh file)
Each NonStop CORBA setup uses a unique set of environment variables. The file env.sh, found in the etc product subdirectory, sets up the
NonStop CORBA environment variables that are used by the other NonStop CORBA scripts and by some programs.
After you install the NonStop CORBA product, the settings in env.sh are correct for your installation. When using the various NonStop CORBA
programs and shell scripts, you must ensure that the correct environment variables are in effect. To do so, issue the following OSS shell
command from your NonStop CORBA base directory:
. etc/env.sh
This command reads env.sh file and sets the environment variables in your current OSS shell session. Alternatively, you can put the command
in the OSS
.profile script. This script is executed each time you enter OSS. For example, assuming you have installed the NonStop CORBA in
the directory
/usr/tandem/nsdoms, you could put the following line in your .profile file:
. /usr/tandem/nsdoms/etc/env.sh
Customizing the env.sh file
You might want to customize the env.sh file to reflect a special NonStop CORBA setup. For example, if you wanted to move the NonStop
CORBA files from one Guardian subvolume to another, you need to make a change to the
NSD_DIR and NSD_SUBVOL environment variables in
env.sh. Use a text editor to modify env.sh. After editing the file, you must execute the script (as described in Setting Environment Variables) in
order for the new settings to take effect.
Note:
While you can freely move your application files, you should not move NonStop CORBA files to a different
Guardian subvolume or OSS directory if you use the Distributed Systems Management/Software Configuration
Manager (DSM/SCM) to manage your NonStop CORBA Installation. DSM/SCM will not be aware of the location of
any files you move.
The following table gives a brief description of each environment variable set in the env.sh script. The table also shows the default script
settings.
Variable Default Setting* Description
NSD_ROOT /usr/tandem/nsdoms
Sets the root OSS directory for your NonStop CORBA installation.
MY_ROOT $NSD_ROOT
Sets up a custom NSD_ROOT variable to allow for multiple custom installations.
By default, the value is the same as
NSD_ROOT.
NSD_DIR
/G/SYSTEM/ZORBSDK or
/G/SYSTEM/ZORBRTK
Specifies the NonStop CORBA Guardian volume and subvolume for NonStop
Kernel files; must be expressed in OSS directory format.
NSD_SUBVOL
"\$SYSTEM.ZORBSDK" or
"
\$SYSTEM.ZORBRTK"
Same as
NSD_DIR, but expressed in NonStop Kernel (Guardian) format (a
backslash before the dollar sign and a double-quoted directory location).
MY_SUBVOL $NSD_SUBVOL
Sets a custom NSD_SUBVOL, which allows for multiple installations. By default,
the value is the same as
NSD_SUBVOL.
NSD_SRL_SUBVOL $NSD_SUBVOL
Specifies in NonStop Kernel format the Guardian volume and subvolume
where the NonStop CORBA for Java shared run-time libraries (SRLs) reside.
By default, the value is the same as
NSD_SUBVOL.
NSD_SRL_DIR $NSD_DIR
Specifies in OSS format the Guardian volume and subvolume where the
NonStop CORBA for Java SRL resides. By default, the value is the same as
NSD_DIR.
_SRL_01
File NSDSRL in the NSD_SRL_SUBVOL A DEFINE that specifies the location of the NonStop CORBA SRL.
NSDOM_CFG_DBM $MY_SUBVOL.NSDCFGDB
Specifies the NonStop Kernel filename for the configuration database.
NSDOM_ADMIN_DB
Set by installer Specifies the NonStop Kernel filename for the administration database.
MY_PREFIX Z
Specifies a unique prefix letter for the NonStop CORBA process names. Use
this environment variable prevent process name conflicts if you have multiple
NonStop CORBA installations on a single system. You must set this as an
uppercase letter.