Overview

In order to run ACS as an end-user or even develop software based on the ACS framework, a number of environment variables must be defined. The majority of these variables are defined in a BASH script provided by ACS (usually located in /alma/ACS-x.y/ACSSW/config/.acs/.bash_profile.acs). ACS does not provide this script in other shell languages although there is nothing wrong with porting .bash_profile.acs to another shell.

Optional Environment Variables

ACS_TMP The directory where temporary files will be stored.  ($ACSDATA/tmp/, when not set)
ACS_INSTANCE Specifies a baseport (ranging from 0-9) used to start an instance of ACS.  There is a one-to-one correlation between this value and the $ACSDATA/tmp/ACS_INSTANCE.$ACS_INSTANCE directories. (Dynamically picks a free baseport when not set)
ACS_LOG_STDOUT Control the amount of information sent to stdout. By default, only LM_INFO log messages are sent to stdout.
ACS_LOG_FILE
 Location and root file name for ACS log files. Each process/thread generates a unique file name by appending process name and PID to the root file name.  ($ACSDATA/tmp/acs_local_log_, when not set)
MANAGER_REFERENCE corbaloc reference to manager.
NAMESERVICE_REFERENCE corbaloc reference to the Naming Service
ACS_NAME_SERVICE CORBA Initial Reference for the Naming Service.  (default: $MANAGER_COMPUTER_NAME:4000/NameService)
ACS_RECOVERY_FILE Name and location of ACS's recovery file.
ACS_BACI_RECOVERY_FILE Name and location of BACI's recovery file.

Environment Variables Set By .bash_profile.acs

ALMASW_ROOTDIR
 Usually "/alma".  The root directory of the ACS installation.
ALMASW_RELEASE
 The ACS release.  An example is "ACS-2.1".
ALMASW_INSTDIR
 Usually "ACSSW".  The directory where ACS libraries are installed.
ACSROOT
 The fully expanded ALMASW_INSTDIR directory.
INTROOT
 Where a developer's personal libraries, executables, etc. are stored.
GNU_ROOT
 Location of GNU tools installation.
TCLTK_ROOT
 Location of tcl and tk installation.
ACE_ROOT_DIR
 Location of ACE+TAO installation.
OSYSTEM
 Name of the operating system.  Should be either "Linux" or "SunOS".
JAVA_HOME
 Location of the Java installation.
VLTROOT
 The same as $ACSROOT.  Used for Very Large Telescope software.
VLTSW_RELEASE
 The same as $ACSSW_RELEASE.  Used for Very Large Telescope software.
ACSDATA
 The root directory where all ACS configuration files (including Configuration Database files) are stored. 
(default: $ALMASW_INSTDIR/acsdata)
VLTDATA
 DEPRECATED
ACS_CDB
 Location of the configuration database files to be used when cdbjDAL is started. (default: $ACSDATA/config/defaultCDB)
RTAPENV
 DEPRECATED
CMM_PORT
 DEPRECATED
CMM_HOST
 DEPRECATED
HOST
 Hostname.
USER
 Username.
PYTHON_ROOT
 Location of Python installation.
FARCH
 Standard C library???
OMNI_ROOT
 Root directory of the omniORB installation.
OMNIORB_CONFIG
 Configuration file for omniORB.
PYTHONPATH
 Search path for Python scripts/modules.
IDL_PATH
 Search path for IDL files.
ANT_HOME
 Location of the Ant installation.
JACORB_HOME
 Location of the JacORB installation.
ACC_HOST
 Host where maciManager is running.  DEPRECATED???
WIND_BASE
 Location of a VxWorks installation.
CPU
 Type of CPU being used on an LCU.
WIND_REGISTRY
 $HOSTNAME
WIND_VERSION
 Directory where VxWorks is installed.
VX_CPU_FAMILY
 Family of CPUs $CPU is in.
WIND_HOST_TYPE
 Type of host hosting VxWorks.  Typically "sun4-solaris2".
VX_HOST_TYPE
 Type of operating system hosting VxWorks.  Typically "solaris".
VXROOT
 Root installation of VxWorks.
VX_VW_BASE
 $VXROOT
VX_HSP_BASE
 $VXROOT
VX_BSP_BASE
 $VXROOT
PATH
 Search path for executables.
LD_LIBRARY_PATH
 Search path for shared libraries.
MANPATH
 Search path for manpage entries.
CLASSPATH
 Search path for Java jar files.

Special Notes

Examples in the ALMA CVS Repository

N/A

Related Documents

None.


Keywords: .bash_profile.acs, BASH, shell