Delta Watch: Update System diagnostics from v3.4 to v3.10

This article guides the user step-by-step through these adjustments so that when finished, full use of all new functionality can be made.

Who should use this article?

This article is to upgrade an existing database from version 3.4 to 3.10 and:

• Are using the System diagnostics module in v3.4
• Have either meteorological, total station, or Delta Link sensors added in one of the projects.

Use the article: Delta Watch: Configure System Diagnostics for anything else!

What are the differences with older Delta Watch versions?

Default sensor names

In Delta Watch v3.10, the sensor names are defined by the system when adding either a Delta Link or total station to the System diagnostics module. It is possible that these names already exist in the database (DB) when they were created in Delta Watch v3.4. No worries, they will not be lost in conversion.

Import definitions

A small change has been made in the way an import task works for the sensors in the System diagnostics module. This is to allow the improved alarming functions to work. The affected tasks will need to be reconfigured, and new tasks should be added to import the Compensator and Modem data.

Alarms and limit monitoring

Limit monitoring is now configured on a single place in the Limit management section but requires that existing alarm settings (pre v3.10) are removed.

New sensors

Delta Watch can now import the Compensator and Modem data files. These will automatically be added to the Sensor Management if you change the project assignment or add new items to the System diagnostics module.

Below is the general workflow for updating the System diagnostics. These steps will need to be performed for each total station sensor and each Delta Link unit in all projects. A detailed description is found in the next sections. At the bottom of this article, there is also a little troubleshooting guide included, just in case.

1. Adjust names of existing sensors in Sensor management 
2. Add missing sensors (Compensator and Modem) to the Sensor management 
3. Check sensors have a map symbol, project, and WGS84 coordinates 
4. Limits and alarms 
   1. Remove previously configured limit checks from individual sensor channels
   2. Create replacement Limit monitoring rules for them
5. Check unit setting for Compensator data 
6. Import definitions 
   1. Adjust existing imports
   2. Add additional imports for the Compensator and Modem data
   3. Apply limit monitoring rules, if any
7. Check the data 
8. Add the new sensors to Charts and Views 

How to upgrade step-by-step

Check and adjust sensor names

First, existing names of sensors will need to be checked and adjusted where required. The original name does not have to be lost, as this could be copied to the External Name field. In doing so, charts, views, and reports will use the external name, making it look like nothing changed.

1. Navigate to the Sensor Management tab in the Point and Limit Management module.
   There should be some sensors of the following type, as per below list and illustration:
   • Total station
   • Meteorological
   • Delta Link box

2. Adjust the names of each of these 3 sensor types using the below table as a guide. If the current Name value needs to be kept, and the External name field is not in use, cut-and-paste the Name to the External name field. It is assumed that these sensors exist from the DW3.4 configuration. If not then, this time only, add these sensors manually, making sure the Sensor Type and Serial number are set correctly.
   

   Adjusting v3.4 names to v3.10 naming requirements

   Type	Old name	New name	Note
   Total station	????	????	Does not need to change!
   Meteorological	DLxxxxxx	DLxxxxxx (Meteo-Sensor)	xxxxxx are the last 6 digits of the serial number of the Delta Link unit
   Delta Link box	????	DLxxxxxx

    

3. Apply all changes. When finished, it should look similar as in the below illustration.

Add new sensor types

Once the existing sensor names have been adjusted, the remaining sensor type can be added. To be able to process the Compensator data, at least DeltaLog v2.1.0 or higher is required.

1. Click on Add  and enter the new details, making sure the Name, serial number, and Type are set correctly. For each existing total station and Delta Link box, add these new sensors. Use the below table as a naming guide.
   

   Adding new sensors to the Sensor management

   Type	Name	Note
   Compensator	???? (Compensator)	???? is the same name as the total station entry
   Modem	DLxxxxxx (Modem)	xxxxxx are the last 6 digits of the serial number of the Delta Link unit

    

2. Apply the new additions. The below illustration shows the new sensors added to our project.

Limits and alarms

If alarms were configured for a Delta Link or total station sensor, then these will need to be removed and replicated using the new method. If no alarms were configured previously and no new alarms have to be added, then this section can be skipped.

1. Navigate to the Sensor Management section in the Point and Limit Management module, and select the sensor with an alarm. It can easily be checked if a sensor had an alarm by looking at the individual sensor channels in the bottom half of the screen. If there is any value in one of the limit columns, as per the below illustration, then this is an old alarm configuration.

2. Select the channel with the old alarm configuration and Edit  it.
3. Remove any Limit value, click OK and then Apply.
4. Repeat steps 2 and 3 for any other channel of this sensor.
5. Repeat for any other Delta Link or total station sensor.

After removing all old limit settings, they will have to be recreated in the new Limit Management section. This new method has benefits, including sending email and SMS messages in case there is an alarm. See the What's New document of Delta Watch v3.10 for more details. Below is just a bulleted list on creating the new limits. More details can be found in the article Configure System Diagnostics in v3.10 under section: Configure alarming and messaging.

6. Open the Limit monitoring tab.
7. Add  a new Limit definition for Geotechnical sensors.
8. Select the sensor type, which in our case could be: Delta Link box, Total Station, Meteorological, Compensator, or Modem.
9. Enable and configure the channels of interest. More than one channel can be configured in the same definition.
10. Apply the changes and repeat for any other sensor type. Note that a single Limit definition could now be used for multiple sensors, for example, one definition to monitor multiple Delta Link units.

The below illustration shows the earlier identified alarm, on free disk space, reconfigured in the Limit monitoring tab.

Check unit setting for Compensator data

It is possible that the default raw data unit for the compensator sensor is incorrect. This depends on settings made in Delta Watch v3.4 before upgrade. To check:

1. Open the System Configuration module and select the section Units and decimal places.
2. Activate the subsection Raw data processing.
3. Look for the Compensator and check if the unit is set to GON, see below illustration. Adjust if required.
4. Apply the changes.

Adjust and configure data import

The current import tasks for a total station or Delta Link unit need to be adjusted in order to work again. At the same time, some additional import tasks will need to be created for the newly introduced Compensator and Modem sensors. In short, an import definition for each sensor type needs to be defined. This allows, for example, for the limit checking upon import of data.

There is a separate support article that goes into details on the Import & Export module and fine-tuning of settings. In this section, only the minimum details will be given to complete the conversion from DW3.4 to DW3.10.

In short, an import definition for each sensor type needs to be defined. This allows, for example, for the limit checking upon import of data.

Navigate to the Import & Export module, and then continue with the next section.

Adjusting existing imports

Start with checking and adjusting the current import configurations. These will be for the sensor types: Meteorological and AMTS Import.

1. Select the first import and open it by clicking on Edit . It might look like in the below illustration.
2. Check if there is a RED warning circle on the left bottom of the window. If yes, correct this by selecting one or more sensors to import.
3. If a limit was configured, then select here the limit to use.
4. Possibly add some comments.
5. For Meteorological data, if previously the (*.THP) files were used, change this to the (*.ENV) data. This data comes in more regular intervals, even if no rounds of observations are performed. See item Humidity data units seem to be wrong in the Troubleshooting section below for additional checks.
6. Accept the new values by clicking OK.
7. Repeat the checks for any other import task of type Meteorological and AMTS import.

The below illustration shows the old Delta Link info import that will be changed to import only Control Unit Information (CUI) data. The import type, as visible in the table column Sensor Types, changes from AMTS Import to Control unit (info).

Add import tasks for remaining sensors

After adjusting the existing import tasks, additional import tasks need to be created for the remaining sensor types. These are:

• Station Information (STNI files)
• Compensator (BUB files)
• Modem Information (MDM files)

1. Either Add  a new item or select the import task for a Control unit and click on .
2. Adjust the name to reflect the new import.
3. Select the sensor type and import type. This should be one of the following combinations: 
   

   Import sensor type combinations

   Sensor type	Import type
   Control unit (info)	Control unit info (*.CUI)
   	Modem log file (*.MDM)
   Total station (hardware info)	Total station info (*.STNI)
   	Compensator (*.BUB)

4. Select the sensor(s) to import to. Delta Watch will automatically show all the available sensors.
5. Make any other customizations such as comments, limits, or data transfer monitoring.
6. Repeat for all applicable sensor types in the above table at item 3. When done, the import section could look something like in the below illustration.
7. Apply the changes.

Check the data

With the adjustments made to the Sensor Management and Import definitions, it is a matter of waiting for the automatic import to import again. When importing starts depends on the settings of each individual tasks and the amount of data to import the first time. This could be 10 minutes or more. To trick Delta Watch and force importing to start, simply close and restart Delta Watch.

Once the various data files are imported, an initial inspection of the data can be done in the System diagnostics module. More details on how to use this module can be found in the related article on Configure System diagnostics under the section How to use the System Diagnostics module.

Update charts and views [OPTIONAL]

This is the moment to add the new sensors to any existing views or user defined charts. The extra information of the new sensor type might assist in fault-finding and troubleshooting. For more details on how to do this, see the related article on Configure System Diagnostics under the header Configure a view or user defined chart.

Once configured and having waited a reasonable time, or even having restarted Delta Watch and there is still no data available in the System diagnostics module, then there are a few things that could be checked. For an extensive list of checks, see the related article on System Diagnostics in DW3.10.

The main things to check after upgrading from v3.4 to v3.10 are:

• Have the new sensors been added to the correct project?
  • Check the Sensor Management tab in each of the projects in the Point and Limit Management module.
• Are the new sensors active?
  • Check in the Sensor Management section of the Point and Limit management module.
• Are all existing import tasks adjusted?
  • In the Import and Export module, edit each import task and check if there are any warnings.
• Are the correct import tasks created for the new sensors?
  • Check that the copied import tasks were adjusted correctly for Sensor type and Import type.
• Are there datafiles to import?
  • For Compensator data (*.BUB), these files can only be processed if created by DeltaLog version 2.1.0 and higher.
• Consult the Message archive and see if there are any warnings about data import.

Humidity data units seem to be wrong

If in any module where the humidity channel from a meteorological sensor is showing values between 0 and 1 instead of between 0 and 100%, then a small adjustment to the setting in the Point and Limit management module needs to be made.

1. Navigate to the Sensor Management tab in the Point and Limit management module.
2. Locate the affected Meteorological sensor and select it.
3. In the bottom half of the screen, check the Unit-of-Raw-data for the Humidity channel. This should be set to Percentage [%]. Edit the channel to adjust the unit setting if this is not the case. See below illustration.
4. Close all open modules.
5. Now check the charts again. All should be correct.