Environment Variables to Configure DIRAC Behaviour

There is a small number of environment variables that can be set to control the behaviour of some DIRAC components. These variables can either be set in the bashrc file of a client or server installation or set manually when desired.

DIRAC_DEBUG_DENCODE_CALLSTACK

If set, debug information for the encoding and decoding will be printed out

DIRAC_DEBUG_M2CRYPTO

If true or yes, print a lot of SSL debug output

DIRAC_DEPRECATED_FAIL

If set, the use of functions or objects that are marked @deprecated will fail. Useful for example in continuous integration tests against future versions of DIRAC

DIRAC_DISABLE_GCONFIG_REFRESH

If set, attempting to start the gConfig refresh thread will result in an exception. This is used by DiracX to accidental use of vanilla DIRAC in contexts where it won’t work.

DIRAC_FEWER_CFG_LOCKS

If true or yes or on or 1 or y or t, DIRAC will reduce the number of locks used when accessing the CS for better performance (default, no).

DIRAC_GFAL_GRIDFTP_ENABLE_IPV6

If set to false or no, disable IPv6 for the GRIDFTP plugin (default true). See the information in the StorageElement page.

DIRAC_GFAL_GRIDFTP_SESSION_REUSE

If set to true or yes the GRIDFTP SESSION REUSE option will be set to True, should be set on server installations. See the information in the StorageElement page.

DIRAC_HTTPS_SSL_CIPHERS

If set, overrides the default SSL ciphers accepted when using HTTPS. It should be a colon separated list.

DIRAC_HTTPS_SSL_METHOD_MAX

If set, overrides the highest supported TLS version when using HTTPS. It should be a valid value of ssl.TLSVersion.

DIRAC_HTTPS_SSL_METHOD_MIN

If set, overrides the lowest supported TLS version when using HTTPS. It should be a valid value of ssl.TLSVersion.

DIRAC_M2CRYPTO_SPLIT_HANDSHAKE

If true or yes the SSL handshake is done in a new thread (default Yes)

DIRAC_M2CRYPTO_SSL_CIPHERS

If set, overwrites the default SSL ciphers accepted. It should be a colon separated list. See DIRAC.Core.DISET

DIRAC_M2CRYPTO_SSL_METHODS

If set, overwrites the default SSL methods accepted. It should be a colon separated list. See DIRAC.Core.DISET

DIRAC_MYSQL_CONNECTION_GRACE_TIME

If set to an integer, default of the grace time before the connection is reused. See DIRAC.Core.Utilities.MySQL.ConnectionPool

DIRAC_MYSQL_OPTIMIZER_TRACES_PATH

If set, it should point to an existing directory, where MySQL Optimizer traces will be stored. See DIRAC.Core.Utilities.MySQL.captureOptimizerTraces()

DIRAC_NO_CFG

If set to anything, cfg files on the command line must be passed to the command using the –cfg option.

DIRAC_USE_JSON_ENCODE

Controls the transition to JSON serialization. See the information in JSON Serialization page (default=Yes since 8.1)

DIRAC_ROOT_PATH

If set, overwrites the value of DIRAC.rootPath. Useful for using a non-standard location for etc/dirac.cfg, runit/, startup/, etc.

DIRACSYSCONFIG

If set, its value should be (the full locations on the file system of) one of more DIRAC cfg file(s) (comma separated), whose content will be used for the DIRAC configuration (see DIRAC Configuration)

DISABLE_WATCHDOG_CPU_WALLCLOCK_CHECK

This variable only makes sense for DIRAC pilots. When set, the wallclock check done within the watchdog is disabled.

DIRAC_X509_HOST_CERT

Defines the location of the host certificate, and takes precedence over CS options. This option is not meant to be used in the bashrc of DIRAC, but rather by external tools starting DIRAC (read orchestrators).

DIRAC_X509_HOST_KEY

Defines the location of the host key, and takes precedence over CS options. This option is not meant to be used in the bashrc of DIRAC, but rather by external tools starting DIRAC (read orchestrators).

X509_VOMSES

Must be set to point to a folder containing VOMSES information. See Multi-VO DIRAC

BEARER_TOKEN

If the environment variable is set, then the value is taken to be the token contents (https://doi.org/10.5281/zenodo.3937438).

BEARER_TOKEN_FILE

If the environment variable is set, then its value is interpreted as a filename. The content of the specified file is used as token string (https://doi.org/10.5281/zenodo.3937438).

DIRAC_USE_ACCESS_TOKEN

If this environment is set to true, then when trying to connect to the server, access tokens will be used (default=false)