Synchronize - BCPro - LIT-12011905 - Server - BCPro Data Server - 4.0

BCPro Data Server

Brand
BCPro
Product name
BCPro Data Server
Document type
User Guide
Document number
LIT-12011905
Version
4.0
Revision date
2020-03-27
Language
English

Note: Read this section thoroughly before using the Synchronize feature to fully understand the implications of synchronizing databases. We recommend that you create a backup of the BCT database before proceeding with a synchronization. Also, upload the database to the archive or download the database from the archive before synchronization.

The Manage Archive Wizard Synchronize option synchronizes a BCPro Workstation, Router, or Gateway database with the BCT archive database. In synchronization, changes made since the last load process in the online database merge with changes made in the BCT database since the last load process, resulting in two databases that contain the same information. One of the benefits of the Synchronization feature is that the BCPro Workstation, Router, or Gateway do not have to restart after the synchronization is complete.

If changes made since the last load process conflict, the BCT data supersedes the BCPro Workstation, Router, or Gateway data. For example, if a Relinquish Default attribute of a setpoint is changed to 77° in the SCT and the same attribute is changed to 78° in the BCPro Workstation, Router, or Gateway device, the attribute after synchronization is set to 77° in both databases.

Note: The UI does not indicate where discrepancies exist between the BCT data and the BCPro Workstation, Router, or Gateway data. Use care when using the synchronize option.

See Table 1 for examples of synchronization scenarios.

Table 1. Synchronization Scenarios

Change in SCT

Change in Device 1

Final Result after Synchronization

Delete an Object

No Change

Object is deleted from both databases.

No Change

Delete an Object

Object is deleted from both databases.

Add an Object

No Change

Object is added to both databases.

No Change

Add an Object

Object is added to both databases.

No Change

Edit an Attribute

Attribute value is changed in both databases.

Edit an Attribute

No Change

Attribute value is changed in both databases.

Edit an Attribute

Edit Same Attribute to a Different Value

BCT attribute value is used in both databases.

Add an FEC to the FC Bus with an Address of 11

Add an IOM to the Same FC Bus with an Address of 11

The FEC with an address of 11 is added to both databases.

Add Object to the XYZ Folder

Delete the XYZ Folder

The databases stay the same as they were prior to the synchronization attempt.
Note: Structural errors like this cause the synchronization process to fail with an error.

Synchronize Process and Table 2 describe the synchronization process.

Figure 1. Synchronize Process

Table 2. Database Synchronization Process

Number

Process Description

1

After configuring a synchronization load in the Load Wizard, the Manage Archive Wizard sends the synchronization command to the ActionQ in the BCT.

2

  1. The ActionQ locks the BCPro Workstation, Router, or Gateway in the archive database. See Database Locking.
  2. The ActionQ polls for progress during the synchronization process.

3, 4

  1. The ActionQ begins the synchronization process at the time defined for the load by uploading the BCPro Workstation, Router, or Gateway database into the BCT archive database. See the Upload section.
  2. The BCT archive database saves a copy of the BCPro Workstation, Router, or Gateway database, then rebuilds the BCPro Workstation, Router, or Gateway database using the new file.
  3. The BCT archive database applies all changes from the BCPro Workstation, Router, or Gateway database to its own archive database.
  4. If structural errors are detected, the saved copy of the original BCPro Workstation, Router, or Gateway database is restored to the BCPro Workstation, Router, or Gateway, an error message appears, and the BCPro Workstation, Router, or Gateway and BCT databases remain unchanged.
    Note: A structural error is a change made to one database that invalidates the other database. For example, a structural error occurs if you add an object to a folder in the BCT, but delete the corresponding folder online from the BCPro Workstation, Router, or Gateway database.
  5. If structural errors are not detected, the ActionQ continues by downloading the new file from the BCT to the BCPro Workstation, Router, or Gateway database. See the Download section. However, the BCPro Workstation, Router, or Gateway applies the changes from the new file to the database and goes through the startup process without resetting.
  6. The ActionQ unlocks the BCPro Workstation, Router, or Gateway in the archive database.
  7. The ActionQ displays the final status of the synchronization.
1 This is most commonly done from the online device UI.