Setting the user environment for Legion 1.0

A properly set-up Unix environment is necessary for configuring and running a Legion system. The Legion compilation, configuration, and start-up processes all use certain Legion-specific environment variables, which must be correctly set in order to use the system, start applications, and run command-line utility programs.

Among the variables that are set is the OPR directory. Legion objects are endowed with a persistent representation in which they can store volatile state, in the event that they must be deactivated during the operation of the system. Objects might also use their persistent representation to store data structures that are too large to contain in volatile storage (e.g., a file object need not keep its entire state, including the contents of the file, in memory). The persistent representation of an object is referred to as a Legion Object Persistence Representation, or OPR. OPRs are stored in vaults. The OPR directory organizes storage of this data and allows the system to locate and reactivate objects as necessary.

Before continuing with the installation process, you must do the following:

These steps are shown below. This procedure must be repeated EACH TIME you start a new shell, or log in to use Legion. Therefore, it is a good idea to add the appropriate lines from above to your .profile or .login file.

For the OPR root directory path, $LEGION/../OPR is suggested.

ksh or sh users should enter:

export LEGION=<Legion root dir path>
export LEGION_OPR=<Legion OPR root dir path>
. $LEGION/bin/legion_env.sh
csh users should enter:
setenv LEGION <Legion root dir path>
setenv LEGION_OPR <Legion OPR root dir path>
source $LEGION/bin/legion_env.csh