Configuring the Environment File
Environment variables should be set or adjusted on startup. If Momentum is started up using the ec_ctl script, any environment variables included in the
environment file will be set.
Environment variables can be set in the
/opt/msys/ecelerity/etc/environment file. The variables that can be set are as follows:
BINDIR– path to the Momentum
CONFFILE– path to the
ecelerity.conffile to be used
CONTROL– path to a Unix domain control listener endpoint
This parameter should match what you have configured for your Control_Listener in
EC_CONF_SEARCH_PATH– this value defines the search path used by ecconfigd to determine the applicable configuration file
Add this variable to the environment file if you wish to change the search order.
EC_DIGEST_REALM– MD5 digest realm (see ec_md5passwd.)
ECELERITY_DNS_BACKEND– the variable for setting the DNS resolver.
The unbound resolver is a modern DNS resolver that is replacing Momentum’s older internal ARES resolver. The unbound resolver will provide more features, more efficient code, and smoother integration with Momentum.
The unbound server is turned off by default, but can be enabled by entering the following lines into
ECELERITY_DNS_BACKEND='unbound' export ECELERITY_DNS_BACKEND
To confirm the resolver's status, look for the following line in the summary command:
DNS Resolver: unbound
The only other valid value is
ECELERITY_MEMORY– to use pipe_io on Linux, this variable must be set to
EXTRA_ARGS– additional parameters to pass to Momentum
HTTPS_PROXY_PASSWORD– for use with Adaptive Delivery (see Using a Proxy Server.)
HTTPS_PROXY_USERNAME– for use with Adaptive Delivery (see Using a Proxy Server.)
LD_LIBRARY_PATH– in case the ld path needs to be augmented
This mechanism is used for module specific adjustments to the environment.
PLAT– platform name
TMPDIR– specify a temporary directory
Ecelerity creates an executable file in TMPDIR (a file used by the Lua Timed Events support). If you do not set TMPDIR, it defaults to
/tmp. If, as a security measure, you mount
noexecoption and you also want to use Lua Timed Events, you need to set TMPDIR to a directory that permits executable scripts.
TRY– number of times to loop waiting for Momentum to start up
For examples of usage, see ec_ctl and ecconfigd_ctl.
GIMLI_WATCHDOG_STOP_INTERVAL variables set the interval for restarting Momentum when it has been unresponsive. For more details execute
man -M /opt/msys/gimli/man monitor .