EGO environment variables

Environment variables are used to set the environment for commands, daemons, and processes.

On Windows, the EGO environment variables are set by the installer. On Linux®, the EGO environment variables are set by the script profile.ego or cshrc.ego.
Environment variables are primarily used internally by the software, but can be used as shortcuts to locate a particular directory. The most important environment variable to be set is EGO_CONFDIR, which, if not set in the current logon session, may prevent a user from running EGO clients.
Note: The platform used in the following table represents the operating system; for example, for Linux: linux2.4-glibc2.3-x86.
Table 1. Environment variable details
Environment variable Description Default Value
EGO_TOP (Linux only)

On Windows, there is no EGO_TOP environment variable; Windows uses the registry to obtain the product installation directory instead. Documentation refers to this location as Installation_top.

 The directory where EGO is installed.

On Windows: C:\Program Files\IBM\SpectrumComputing

On Linux: /opt/ibm/spectrumcomputing
EGO_BINDIR The directory where commands are installed. Added to Path on Windows and PATH on Linux.

On Windows: Installation_top\4.0\bin

On Linux: $EGO_TOP/4.0/platform/bin
EGO_CLIENT_ADDR Used with firewalls and rfa. Range of listening ports for clients to connect back to rfa.

This environment is useful if you have a firewall configured on the client side.

Example:

EGO_CLIENT_ADDR=56000-56020

 There is no default value. If not set, the client will listen on a random port.
EGO_CONFDIR The directory where the ego.conf EGO configuration file is stored. The file may be duplicated in the system, but the cluster only uses the file stored in this location.

On Windows: Installation_top\kernel\conf

or

shared_dir\kernel\conf

On Linux: $EGO_TOP/kernel/conf

shared_dir/kernel/conf

EGO_ESRVDIR The directory where EGO service configuration files are stored.

On Windows: Installation_top\eservice

or

%EGO_CONFDIR%\..\..\eservice

On Linux: $EGO_TOP/eservice or $EGO_CONFDIR/../../eservice
EGOSC_INSTANCE_CGROUP_PATH Indicates the cgroup path name for service instances. There is no default value. The value is set at run time when the service instance is started.
EGO_LIBDIR The directory where the EGO libraries are installed, added to Path on Windows and LD_LIBRARY_PATH on Linux.

On Windows: Installation_top\4.0\lib

On Linux: $EGO_TOP/4.0/platform/lib
EGO_LOCAL_CONFDIR The local configuration directory.

On Windows: Installation_top\kernel\conf

On Linux: $EGO_TOP/kernel/conf
EGO_SERVERDIR The directory where the EGO server binaries and shell scripts are installed, added to Path on Windows or PATH on Linux.

On Windows: Installation_top\4.0\etc

On Linux: $EGO_TOP/4.0/platform/etc
EGO_MASTER_LIST The list of hosts that are primary host candidates in the cluster to which you want to connect. The host names indicated here must exactly match the host names specified in the primary ego.conf file, accessible from the primary host. If the values do not match, IBM® Spectrum Symphony does not work as expected.
Important: The values defined for the EGO_MASTER_LIST environment variable override the values defined for EGO_MASTER_LIST in ego.conf.

ego.conf on Windows at: Installation_top\kernel\conf or

%EGO_CONFDIR%

ego.conf on Linux at: $EGO_TOP/kernel/conf or

$EGO_CONFDIR