Configuring the Server Platform Environment

 

This section provides instructions for configuring your UNIX shell environment for the Business Process Option Servers running under BEA eLink Platform. This entails editing the variable assignments in the Business Process Option UNIX environment script env.sh. This section describes the env.sh script in detail and provides instructions for modifying its contents to suit your particular configuration. Topics include:

• The env.sh File

• The env.sh Environment Variables

• Modifying the env.sh File

The env.sh File

In order to function properly, the various Business Process Option components require certain information concerning the operating system environment in which the servers reside. When you installed the Business Process Engine, a script was created that sets the environment variables required for operation of that component. This script file is env.sh and is located in the directory $IC_HOME/config. As part of the Business Process Option Server installation, this file was additionally enhanced to include environment variables required for the eLink Platform. The updated env.sh is placed in the directory <$TUXDIR>/eLink/BusProc.

Note: If you modify the configuration for your Business Process Option system or the supporting software (for example, the Oracle database), you must also update the env.sh file to reflect those changes.

A sample env.sh file is provided in Sample Configuration Files.

The env.sh Environment Variables

The following table describes each of the variables contained in the env.sh file.

Note: You must manually add or edit the following variables and their assignments in the env.sh file:

• TUXCONFIG

• FIELDTBLS32

• FLDTBLDIR32

  Warning: The TUXCONFIG environment variable is not provided as part of the installation, because the TUXCONFIG file location is not known or required as part of the installation process. This environment variable must be set, however, for the eLink Platform to compile the UBB configuration file and boot the eLink Business Process Option application. The values of the two FML environment variables FIELDTBL32 and FLDTBLDIR32 contain only the data necessary for the Business Process Option Servers to run. They must be updated for any other FML definitions that you will use.

env.sh Variable	Description
IC_HOME	This is the eLink Business Process Engine home directory.
IC_CLIENT	This is the eLink Business Process Engine client login string. This string specifies the eLink Business Process Engine user, server, and optionally the user's password, in the format <username>[/<password>]@<servername>. IcTuxInstall generates the IC_CLIENT string icdba@<servername> ; icdba is the default user ID for the eLink Business Process Engine administrative user, and <servername> is replaced by your specification for the variable IC_SERVER_NAME. For security reasons, the administrator password is not specified in the generated IC_CLIENT string.
TUXDIR	This is the eLink Platform home directory.
TUXCONFIG	This is the explicit location of the binary configuration file for the eLink Platform. Note: This environment variable is not provided as part of the installation, because the TUXCONFIG file location is not known or required as part of the installation process. This environment variable must be set, however, for the eLink Platform to compile the UBB configuration file and boot the eLink application.
PATH	Contains a list of the directories to be searched to locate executables. The following directories are appended to the setting for this variable: $IC_HOME/bin $TUXDIR/bin $ORACLE_HOME/bin
LANG	This is the NLS language. If it has not already been set, it will be set to C.
NLSPATH	This specifies the directories to be searched for locating message catalogs. The following directory specifications are appended to the setting for this variable: $IC_HOME/data/%L/messages/%N $IC_HOME/data/messages/%N $IC_HOME/data/C/messages/%N
LD_LIBRARY_PATH	Solaris only. This is the search path for shared libraries. The following directory specifications are appended to the setting for this variable: $IC_HOME/lib - Path for the Business Process Engine shared libraries $TUXDIR/lib - Directories in which the platform shared libraries reside $ORACLE_HOME/lib - Path for the database shared libraries
SHLIB_PATH	HP-UX only. This is the search path for shared libraries. The following directory specifications are appended to the setting for this variable: $IC_HOME/lib - Path for the Business Process Engine shared libraries $TUXDIR/lib - Directories in which the platform shared libraries reside $ORACLE_HOME/lib - Path for the database shared libraries.
ORACLE_HOME	This is the Oracle home directory.
TWO_TASK	Identifies the Oracle instance for SQL*Net. If you have chosen to bypass SQL*Net, TWO_TASK is replaced by ORACLE_SID.
FIELDTBLS32	Contains the list of table files required by FML data-dependent routing. Note: This variable is provided with only the settings required by the Business Process Option. You must update these to include any other FML definitions that you will be using.
FLDTBLDIR32	This contains the list of table files required by FML. Note: This variable is provided with only the settings required by the Business Process Option. You must update these to include any other FML definitions that you will be using.
WSNADDR	Identifies the host machine and port number used by the eLink Platform Workstation Listener (WSL).

Modifying the env.sh File

To alter the env.sh environment variable settings after the installation, do the following:

1. Shut down the Business Process Option system.

2. Edit the env.sh script file, using any plain text editor such as UNIX vi or emacs.

3. Save the newly modified env.sh file.

4. Execute the env.sh script at the UNIX shell prompt, as follows:

   . ./env.sh

   You can also add this command to the icadmin .profile file, and then source the .profile file. The .profile file is also sourced upon login.

5. Restart the eLink Business Process Option system.