Objective   

Prerequisites   

• You need administrative access to both the old and new ADSelfService Plus servers.
• The new ADSelfService Plus installation must be the exact same version and build number as the old one. To verify your current build number, log into the admin portal and click the License link in the top-right corner.

Steps to manually back up and restore the database during migration   

1. Stop the ManageEngine ADSelfService Plus service via services.msc to ensure data consistency.
2. Open the Command Prompt and run it as an administrator.
3. Navigate to the bin directory inside your ADSelfService Plus installation folder using the cd command. The default path is C:\Program Files\ManageEngine\ADSelfService Plus\bin.
4. Execute the database backup script:

 backupDB.bat 

5. This will create a compressed backup file (e.g., OfflineBackup_20250812103000.ezip) inside the Backup folder in the ADSelfService Plus installation directory.
6. Gather the essential configuration files. Copy the following items from the old server and save them in a temporary folder:
1. The .ezip backup file you just created from the \Backup folder.
2. The entire \conf folder located in the main installation directory (default path: C:\Program Files\ManageEngine\ADSelfService Plus\conf). This folder contains all your configuration settings, including the database encryption password.

1. Rename the copied customer-config.xml from the old server to new-customer-config.xml.
2. Paste new-customer-config.xml into C:\Program Files\ManageEngine\ADSelfService Plus\conf. Do not delete the existing customer-config.xml on the new server.
3. Paste the .ezip backup file into C:\Program Files\ManageEngine\ADSelfService Plus\bin.
4. Open the Command Prompt as an administrator.
5. Navigate to the bin folder using the cd command. The default path is C:\Program Files\ManageEngine\ADSelfService Plus\bin.
6. Run the restore command:

 restoreDB.bat <filename.ezip> -p <password> true 

The password required for the restore command (-p <password>) depends on how your environment was configured when the backup was made. 

Default password: If no custom password was set, the password is the reverse string of the backup filename excluding the .ezip extension.   For a file named OfflineBackup_20250813160300, the password would be 00306131805202_pukcaBenilffO. 

Admin-configured password: If a password was configured in the admin portal, you must use that password. This setting is located under Admin > Product Settings > Security and Privacy > Privacy Settings in the Encrypt database backup files field. 

What if I forgot the password? If you have forgotten the admin-configured password, you can find it in the customer-config.xml file located in the <Installation_Dir>\conf folder. Please contact the ADSelfService Plus support team to decrypt the file and retrieve the password. Without the password or access to this file, the backup is unusable. 

How to reach support