Capital™ Network Designer How to restore and migrate CNXML or VSABKP files using the AdminConsole
Summary
This guide describes how to use the AdminConsole to restore a CNXML or a VSABKP file for manual or automated migration. By following this guide the user will be able to restore an older CNXML or VSABKP file as a repository into the CND - Administrator client. Please note that older versions of CND(Called Capital Networks) only support the previous VSAX version. Later versions support the previous four.
Details
Since the 2021.1.1 version of the Capital Network Designer (called "Capital Networks" before version 2207) the Administrator client comes with an example for the AdminConsole that can be used to reattach and migrate backups created with previous versions of the tool.
With this example, CNXML and VSABKP files can be restored as a repository, for manual or automated migration to a newer or the latest VSAX version.
Follow these steps to restore the backup file as a repository:
- Go to the installation directory of the latest installed Administrator client(Or right-click on the Desktop shortcut for the Capital Network Designer - Administrator and choose "Open file location").
- Open the "examples" folder.
- Find the file "AdminConsole_sample.bat" and create a copy in the same directory.
- Edit the newly created copy.
- Add the complete destination after "SET DB_BACKUP=" with the filename at the end.
- example: SET DB_BACKUP=c:\Users\windowsuser\downloads\testproject.cnxml
- The AdminConsole can migrate the file automatically to the latest supported VSAX version, right after restoration.
- To enable the auto-migration remove "//" and "REM " from line 16.
- Save the file and close it.
- Find "AdminConsole_sample.properties" in the same directory and edit the file.
- There are a few attributes that may need to be modified depending on how the local architecture has been set up:
- NAME (Repository name can be changed from the default "testrepo_restored_from_cmdline").
- CDO_SERVER_PORT (The port number assigned to the CND Server - default is 2036)
- DS_PORT_NUMBER (The port number assigned to the PostgreSQL)
- DS_DB_PASSWORD (The password assigned to the user "postgres" in PostgreSQL)
- Save the file and close it.
Double-clicking on the modified .bat file will start the restoration and add the file as a new repository.
The user can migrate the repository manually(one version at a time), or the tool will migrate it to the latest version(If enabled).
When the process finishes, it's recommended to create a backup file.
Before starting another restoration it is also recommended to change the assigned repository name in the "AdminConsole_sample.properties" file to avoid losing data due to overwrite.