Upgrading or Migrating a Video Project
This section provides instructions for upgrading or migrating a video project to the V7.x version of Desigo CC.
NOTE: The Danger Management Propagation extension is no longer supported in Desigo CC V7. If you are upgrading a project that included this extension, you must remove the extension either before or immediately after upgrading to V7. In addition, any macros, reactions or scripts that relied on propagated properties will have to be reworked.
Full Set of Backups Required
When you back up the video configuration, it is essential that you perform a project backup, a BT Video API backup, a history backup, and a VMS configuration backup all at the same time. You must then store these matching backups as a set, and use them together for a subsequent restore operation. You can only restore from a full set of backups that have all been made at the same time.
Prerequisites
- If you have a Desigo CC V5.x or V6.x project with Video, you can migrate it directly to V7.x using the Backup and Restore procedures below.
For older versions you can use the same method but must upgrade through intermediate versions. See the Upgrade Paths section below.
Back Up a Desigo CC Project with Video
Perform these steps in preparation for upgrading or reinstalling Desigo CC. This will create a backup of the VMS configuration and of the Desigo CC project complete with its Video API configuration.
- The project you want to back up is running and has a valid video configuration.
- Back up the VMS configuration.
- Follow the instructions in the separate VMS documentation
- Do a Refresh to ensure Desigo CC is aligned prior to backup:
- In System Manager select Applications > Video.
- In the Extended Operation tab, next to the VMS Config property, click Refresh.
- Launch a Main Server project backup:
- In System Browser, select Project > Management System > Servers > Main Server.
- In the Extended Operation tab, next to the Backup Status property, click Start.
- Wait for the project backup to complete.
- As part of the general project backup, an automatic backup of the VideoAPI is also performed.
- Check the Video API backups:
- In the project folder GMSProjects>[project]>data>BT_Video_API you should now see the automatically created backup file with name of the form Backup_yyyymmdd_hhmmss_AUTO.CSV.
- In the project backup folder [GMSBackups] > [project backup name] > data > BT_Video_API you should see the same file, since the Video API backup is included in the main project backup.
- If the Video API backup is not present, create it manually as follows:
- In SMC select Projects > [project].
- In the Video Settings tab, click Backup
.
- The resulting backup file is placed in the GMSProjects>[project]>data>BT_Video_API folder. The file has a name of the form Backup_yyyymmdd_hhmmss.CSV.
- Manually copy this Video API backup into the project backup folder specified in step 4.
- Store the Desigo CC project backup folder, inclusive of the Video API backup, together with any other backups (history database, VMS configuration) necessary to restore your project environment.
- You can now upgrade or reinstall Desigo CC.with the video extension.
Restore a Desigo CC Project with Video
Perform these steps to restore a previously backed-up project after upgrading or re-installing Desigo CC with video extension.
- You have a Desigo CC project backup folder that includes a Video API backup performed at the same time, as well as a VMS configuration backup.
- Restore the VMS configuration.
- Follow the instructions in the separate VMS documentation.
- Restore the backed up Desigo CC project:
- In SMC select Projects and in the toolbar click Restore
.
- In the dialog box, browse for and select the previously created project backup folder and click OK.
- Give a name to the restored project, click Next to reach the last project settings screen and click Save
.
- If the project is now marked
Outdated, select it and click Upgrade
.
- In SMC, select the Video Settings tab of the project.
If the User Name field is marked red, you must associate the Video API Service user:
- Click Browse... , in the dialog box select the VideoApiService user, and click OK.
If this user is not present on the computer, see Configuring the VideoApiService Account to configure it.
- Enter the password for the VideoApiService user and in the toolbar click Save .
- In Windows Services, the Siemens Video API Service should now be
Runningand with Log On As =.\VideoApiService.
- Activate and Start the restored project.
- In the Video Settings tab, the Status should change to green (
Video API connected), and the toolbar icons become enabled.
- Restore the Video API backup:
IMPORTANT! This manual step is required when going from V5.x->V7.x or from V4.x or V5.x --> V6.x, to avoid loss of video configuration data.
It is also required when migrating the project to a different computer.
- In the Video Settings tab, click Restore .
- In the GMSProjects>[project]>data>BT_Video_API folder, browse for the backup that you want to restore. Make sure it was done at the same time as the project backup that you restored in step 1 above.
- Click Open and confirm the restore of that Video API backup.
- At this point you can start the installed client and view the video streams.
Risk of Data Loss
It is essential to first restore a consistent configuration of the connected Video Management System (VMS), before you restore the management-system project, its BT Video API configuration, and history.
Failing to restore the VMS first may result in a loss of data, because when the management-system project runs, the system (BT Video API and then System Browser) will be refreshed with an incorrect VMS configuration. This may result in unwanted modifications or deletions of video objects.
If this type of data loss occurs in System Browser, be aware that a subsequent refresh with the correct VMS configuration may not be sufficient to fix all video objects. In such a case, you will have to redo the entire restore procedure from the beginning.
Upgrade Paths for Desigo CC with Video to V7.x
Upgrade/Migrate Video Project to V7.x | Notes | |
|---|---|---|
from V6.x | Back up the project with video, install V7.x and then restore the backed up project. | IMPORTANT! The video API database has changed starting from V6.0. Therefore, if going from V5.x-->V7.x, or from V4.x or V5.x-->V6.x, it is essential to make a backup of the Video API configuration and then manually restore this Video API backup after restoring/upgrading the project. The backup / restore procedures above provide detailed instructions. |
from V5.x | ||
from V4.x | requires intermediate step: | |
from V3.x | requires intermediate step: | |
from V2.0 SP1 | requires intermediate steps: | |
from V2.1 | ||
