How can we help?

Restore vSEC:CMS

Anthony - Versasec Support
Anthony - Versasec Support
  • Updated

Introduction

For the vSEC:CMS, in the unlikely event that the application needs to be reinstalled it is possible to restore the application such that the application will be restored to its previous state before the reinstall. Follow the instructions below to restore the vSEC:CMS application.

Important
If you are restoring vSEC:CMS from version 5.8 or above then before starting a restore it is important that you have a backup database file available.
Important
If you are restoring vSEC:CMS from version before 5.8 then before starting a restore it is important that you have a backup database file available and that you have knowledge of the backup database passcode.
Important
Depending on which version of vSEC:CMS you are restoring from, different procedures should be followed. Only follow the instructions in the sections below that are applicable to your setup.

Restore From Versions 5.8 or Above

If you are running version 5.8 or above then following the instructions here to perform a restore.

1. If you are attempting to restore vSEC:CMS on a server where vSEC:CMS was installed before it will be necessary to remove the previous version. Follow the instructions in the article Uninstall vSEC:CMS to remove the previous version.

2. Install a clean installation of the vSEC:CMS as described in the section Setup in the article Setup Evaluation Version.

Important
If you had the vSEC:CMS Service configured to run under a dedicated Windows account (this is the recommended way to run the vSEC:CMS Service) then follow the instructions in the article Configure Dedicated Windows Service Account to set this up before moving to the next step.

3. Start the vSEC:CMS and on the first start up you get prompted to set a passcode like below.

Important
Select Later as you should not set a passcode at this step.

From file menu select File - System Restore.

You will be prompted to browse to the location where the backup file is located. Select the backup file and click Open.

img1.png

The restore procedure will now take place. On successful completion a success dialog will appear. Your system will now be restored.

Important
It is necessary to manually restart the vSEC:CMS Service at this time.

Restore From Versions Before 5.8

If you are running a version that was bootstrapped below version 5.8 then follow the instructions here to perform a restore. This means any vSEC:CMS system that was setup initially with version 5.8 or lower, regardless of whether the system has been updated to later versions such as 6.X.

Important
You will need to perform the below steps using version 6.7.0 or later AND you will need to have possession of the backup file OperatorTool_Audit.db.bak and have knowledge of the password to unlock this file.
Additionally, you will need to have a Maintenance Code (MC) ready before performing the restore. See here and look at point 1 for details on how to get a MC.

1. If you are attempting to do the restore onto the same server where vSEC:CMS was running before then perform an uninstall as described in the Uninstall vSEC:CMS article.

2. Perform a clean installation of the vSEC:CMS - this needs to be a version 6.7.0 or later.

3. With the System Owner card or a Fully Featured operator card attached that has a role that includes System Administrator, start the vSEC:CMS console on the server.

4. The operator will be prompted to browse to the location where the backup database file is located. Browse to the backup file. The name for the backed-up database file should be OperatorTool_Audit.db.bak. On selecting the database file, enter the operator passcode and the backup database file passcode as was created during the initialization phase of the original installation.

5. Stop the vSEC:CMS service and open a command prompt. Go to the location where vSEC:CMS service is running and run the command: CmsService.exe -installproductcode:xxxxxxxx

Where xxxxxxxx is the actual MC code.

6. Start the vSEC:CMS service.

7. If the vSEC:CMS is configured to use key store then you will need to go to log onto the console and go to Options – Operators and select the key store operator and click the Activate button.