Environment Variables

Environment variables are used by ska-oso-scripting to define the execution environment and which Tango devices should be controlled. This in turn modifies the behaviour of the code, giving different behaviour depending on whether the code is running in an SKA MID environment (default) or an SKA LOW environment. For example, when configured for SKA MID, connections to a subarray will connect to an SKA MID subarray, and validation code will reject CDM payloads intended for SKA LOW.

Environment variables recognised by ska-oso-scripting
Variable	Default value	Description
`SKA_TELESCOPE`	`skamid`	Controls the behaviour of telescope-specific functions to expect SKA LOW (`skalow`) or SKA MID (`skamid`). If the environment variable is not recognised, `skamid` will be assumed.
`CENTRALNODE_TRL`	`mid-tmc/central-node/0`	The Tango Resource Locator (TRL) of the TMC CentralNode Tango device. If left unset, an appropriate TRL for SKA MID will be used.
`SUBARRAYNODE_TRL_PREFIX`	`mid-tmc/subarray`	Prefix to use when constructing the TRL for a TMC SubarrayNode Tango device. If left unset, an appropriate TRL prefix for SKA MID will be used.
PGHOST	The address of the PostgreSQL instance of the ODA.	`null` in this repository - set by OET
PGDATABASE	The name of the database within a PostgreSQL instance that contains the ODA schemas.	`null` in this repository - set by OET
PGUSER	The user that will be used to connect to the ODA database.	`null` in this repository - set by OET
PGPASSWORD	The password for the `PGUSER`.	`null` in this repository - set by OET
PGPORT	The port of the PostgreSQL instance of the ODA.	`null` in this repository - set by OET
`OSO_SERVICES_URL`	`null`	Optional value, only used to capture ExecutionBlock data in a notebook session. Should be a value like `$(HOST)/$(KUBE_NAMESPACE)/oso/api/v$(OSO_SERVICES_API_VERSION)`
`SDP_SCRIPT_TMDATA`	`car://gitlab.com/ska-telescope/sdp/ska-sdp-script?master#tmdata`	The TMData location for SDP Script information used by oso-scripting functions to retrieve compatible script version for the deployed SDP version.
`OET_EVENT_PROCESSING_THREAD_JOIN_TIMEOUT`	`3.0`	Grace period in seconds for ska-oso-scripting’s Tango event rebroadcasting thread to gracefully exit. This is an advanced option and should normally be left at the default value.
`OET_WAIT_FOR_QA_READY`	`False`	Sets the initial value for whether observing scripts will wait for Subarray Quality Monitor to indicate the system is ready to scan before sending the Scan command. This can be overridden at runtime via the OET UI.