Issue description  

During the migration of ADManager Plus to a new server using the standard procedure, the database restore step may fail. This interruption can prevent the new installation from accessing or loading the existing database, effectively halting the migration process.

Possible causes 

1. Version mismatch: Old and new servers are running different ADManager Plus builds.

2. Incorrect password: The backup file password was entered incorrectly.

3. Corrupt or incomplete backup: The backup file is damaged or missing data.

4. Permission issues: There are insufficient file or folder permissions during restore.

5. Database not running: The database service is stopped or unreachable.

Prerequisites 

• Ensure the same ADManager Plus build version is installed on both the old and new servers.

• Have a valid backup file taken from the old server.

• Make sure you have administrator access on the new server.

• Stop the ADManager Plus service before starting the restore process.

Resolution 

Step 1: Verify ADManager Plus build versions

1. On the old server, log in to ADManager Plus and note the build number shown in the web console footer.

2. On the new server, confirm the build number is identical.

3. If not, upgrade or downgrade as needed so both servers match.

Step 2: Ensure the backup file is intact

1. Check that the backup file copied from the old server is complete and not corrupted.

2. If it’s a compressed file, fully extract it to a folder on the new server.

3. Ensure the directory contains files like fullbackup, database_params.conf, or similar.

Step 3: Identify the correct backup password

• For builds below 7140: The password is the reverse of the backup file name (excluding path and extension).
  Example:

• Backup file name: BackupMarch2025

• Password: 5202hcraMpukcaB

• For builds 7140 and above: The password is the crypttag value found in the customer-config.xml file under the <conf> directory of your old installation.

1. Open the file in a text editor and look for <crypttag>example-value</crypttag>.

2. Use this value as the restore password.

Step 4: Run the restore command with the correct password

1. Open Command Prompt as administrator.

2. Navigate to the bin folder inside your ADManager Plus installation directory.

3. Run the following command:
   

   

   RestoreDB.bat <full_path_to_backup_folder> -p

4. Enter the password when prompted.

 Tips 

• Keep an additional copy of the backup file before initiating the restore process.

• Make sure the ADManager Plus service account on the new server has full access to the installation folder.

• After migration, review and confirm that all scheduled reports, workflows, and delegation settings are intact.

How to reach support