Configure the RTG.json file for multiple environments
- Last UpdatedAug 07, 2024
- 4 minute read
To update the default RTG.json configuration file
-
In case a file named RTG.json does not exist in %DNADataRoot%\RealTime\config\Settings, copy the default RTG.json file from the source DNAInstallRoot to the target DNADataRoot directories as follows:
Source: %DNAInstallRoot%\RealTime\config\Settings\RTG.json
Target: %DNADataRoot%\RealTime\config\Settings\RTG.json
-
To define the configuration file, refer to the "RTG.json GasMeasurement section property value details" and "RTG.json GasDayOperations section property value details" tables below for detailed information on each property.
-
Edit the target RTG.json file to define your configuration (refer to the tables at the end of this section for detailed information on each property).
Example:
{
"GasMeasurement":
{
"enableMeas2RealTimeProcess": false,
"enableMeasUnitMonProcess": false,
"enableMonitorGasQualityProcess": false,
"enableMonitorGasQualityHostCalcProcess": false,
"enableMonitorMeterProcess": false,
"enableMonitorMeterHostCalcProcess": false,
"enableRealtime2MeasProcess": false,
"SQLSrvName": ".\\OASySHDB",
"SQLDBName": "EFM",
"RTG2GMASConnectionString": "DAL:GasMeas_XFER@dss\\remote_RCS_XFER",
"RDBMS2REALTIMEConnectionString": "DAL:GasMeas_XFER@dss\\remote_RCS_XFER",
"RTG2GMASDPlibConnectionString": "MSDAL:Dir=dss\
\remote_RCS_XFER;Alias=GasMeas_XFER",
"enableMeasRealTimeHCDPBLT": false,
"environmentName": ""
},
"GasDayOperations":
{
"enableMonitorGasContractProcess": false,
"SQLSrvName": ".\\OASySHDB",
"SQLDBName": "EFM",
"DAL:GasMeas_XFER@dss\\remote_RCS_XFER"
}
}
Notes: The example file can also be made suitable for Test and Development Systems that run on a single host by specifying an empty string, "", for these properties: RTG2GMASDPlibConnectionString, RTG2GMASConnectionString, and RDBMS2REALTIMEConnectionString. Thereafter the SQLSrvName will need to reference a valid SQL Server instance.
Gas Day Operations (GDO) configuration is not supported with a cloud endpoint.
If you are configuring the system to connect to a cloud endpoint, update the Data Access layer (DAL) connection strings to reference DAL:GasMeasCloud_XFER instead. -
Using the Network Management Console (NMC), verify that the configuration done in the RTG.json file matches the configuration stored in the Active Directory Application Mode (ADAM) of your installation.
Note: Often SQL Server will be running on a different machine than the machine running the GasMeasurement service.
-
Once the file has been configured, copy it to each RealTime server in your system that will run AVEVA Pipeline Operations for Gas and restart RealTime to pick up any changes or new configuration.
Note: It should not be copied to the RealTime Decision Support System (DSS) servers, as AVEVA Pipeline Operations for Gas (RealTime) processes are not run on the DSS RealTime servers.
RTG.json GasMeasurement section property value details
|
Property |
Value |
|---|---|
|
enableMeas2RealTimeProcess |
Valid values: true or false Starts the meas2realtime process during RealTime startup if set to true.
|
|
enableMeasUnitMonProcess |
Valid values: true or false Starts the MeasUnitMon process during RealTime startup if set to true.
|
|
enableMonitorGasQualityProcess |
Valid values: true or false Starts the monitorGasQuality process during RealTime startup if set to true. |
|
enableMonitorGasQualityHostCalcProcess |
Valid values: true or false Starts the monitorGasQualityHostCalc process during startup if set to true. |
|
enableMonitorMeterProcess |
Valid values: true or false Starts the monitorMeter process during RealTime startup if set to true. |
|
enableMonitorMeterHostCalcProcess |
Valid values: true or false Starts the monitorMeterHostCalc process during RealTime startup if set to true. |
|
enableRealtime2MeasProcess |
Valid values: true or false Starts the realtime2meas process during RealTime startup if set to true.
|
|
environmentName |
Valid values: Empty (not enabled), letters, numbers, and underscores This configuration setting is used by the following processes: • meas2realtime • realtime2meas • rdbms2realtime For more information, see Enable Multiple AVEVA Enterprise SCADA environments to Send Data to AVEVA Measurement Advisor. |
|
SQLSrvName |
The enabling of these settings is not supported for AVEVA Measurement Advisor Cloud Data Connector for AVEVA Enterprise SCADA. |
|
SQLDBName |
|
|
RTG2GMASConnectionString |
An indirect connection string via DAL to the Measurement Advisor SQL Server instance. For example: "DAL:GasMeas_XFER@dss\\remote_RCS_XFER". May be used by the following process:
|
|
RDBMS2REALTIMEConnectionString |
An indirect connection string via DAL to a SQL Server instance. For example: "DAL:GasMeas_XFER@dss\\remote_RCS_XFER". May be used by the following process:
|
|
RTG2GMASDPlibConnectionString |
An indirect connection string via DAL to the Measurement Advisor SQL Server instance. For example: "MSDAL:Dir=dss\\remote_RCS_XFER;Alias=GasMeas_XFER" May be used for the following processes:
|
|
enableMeasRealTimeHCDPBLT |
Valid values: true or false Starts the MeasRealTimeHCDP BLT process during RealTime startup if set to true. |
RTG.json GasDayOperations section property value details
|
Property |
Value |
|---|---|
|
enableMonitorGasContractProcess |
The enabling of these settings is not supported for AVEVA Measurement Advisor Cloud Data Connector for AVEVA Enterprise SCADA. |
|
enableGDO2RealTimeProcess |
|
|
SQLSrvName |
|
|
SQLDBName |
|
|
RTG2GDOConnectionString |