In this article:  

• Objective

• Prerequisites

• Steps to follow

• Validation and confirmation

• Tips

• Related topics and articles

Objective  

This article explains how to migrate ADAudit Plus data from an older build of ADAudit Plus to a new server using backup and restore method.

Prerequisites  

• Administrative access to both the source (old) and destination (new) ADAudit Plus servers.

• Both installations must be on the same build version before migration.

• Ensure sufficient disk space on both servers to store the backup and extracted data.

• ADAudit Plus services must be stopped during backup and restore operations.

• The password used during backup must be securely noted, as it will be required for restoration.

Steps to follow  

1. Stop ADAudit Plus, go to the Start menu > Services > Right-click the ADAudit Plus service, and select Stop.

2. Go to <Installation-directory>\ManageEngine\ADAudit Plus\bin, open an elevated command prompt (right-click Command Prompt and select Run as administrator), and execute StartDB.bat.

3. Execute BackupDB.bat.

On executing BackupDB.bat, the back up file will be saved at the default location (<Installation-directory>\ManageEngine\ADAudit Plus\backup), under the default name (OfflineBackup_<timestamp>.ezip), with the default password (Backup@123$).

 Note 1: On executing BackupDB.bat, in addition to a timestamped .ezip file titled OfflineBackup_<timestamp>.ezip getting created under <Installation-directory>\ManageEngine\ADAudit Plus\backup, a timestamped folder will also get created under <Installation-directory>\ManageEngine\ADAudit Plus\backup\EventData. 

 Alternately, if you want to specify a location, name, and password for the back up file, execute
BackupDB.bat BackupDirectory BackupFileName -p <password>. 

 Here, BackupDirectory is the location where you want to save the back up file. BackupFileName is the name you want to provide for the back up file. -p <password> is the password you want to configure for the back up file. 

For example, if you want to save the back up file at E:\smith\backup, name the file as ADAPBackup, and configure the password as Pass@123$, execute:
BackupDB.bat E:\smith\backup ADAPBackup -p Pass@123$

 Note 2: Ensure that you remember the configured password, without which the back up file cannot be recovered. 

4. Install a new instance of ADAudit Plus with the same build number as the old one. Start the new instance, go to the Start menu > Services > Right-click the ADAudit Plus service, and select Start. Now, stop the new instance, go to the Start menu > Services > Right-click the ADAudit Plus service, and select Stop.

5. Go to <Installation-directory of old instance>\ManageEngine\ADAudit Plus, copy and paste the folder titled patch to <Installation-directory of new instance>\ManageEngine\ADAudit Plus.

6. Go to <Installation-directory of new instance>\ManageEngine\ADAudit Plus\bin, open an elevated Command Prompt (right-click Command Prompt and select Run as administrator), and execute RestoreDB.bat ZipFileLocation -p password.

Here, ZipFileLocation is the location of the back up file. -p password is the password of the back up file.

For example, in step 3, if you have saved the back up file at E:\smith\backup, named the file as ADAPBackup, and configured the password as Pass@123$, execute:
RestoreDB.bat E:\smith\backup\ADAPBackup -p Pass@123$

In step 3, if you did not specify a location, name, and password for the back up file and simply executed BackupDB.bat, execute:
RestoreDB.bat <Installation-directory>\ManageEngine\ADAudit Plus\backup\OfflineBackup_<timestamp>.ezip -p Backup@123$

7. Execute RestoreEventTables.bat FolderLocation.
   Here, FolderLocation is the location of the folder mentioned in Note 1 under step 3.

For example, in step 3, if you have saved the back up file at E:\smith\backup, execute:
RestoreEventTables.bat E:\smith\backup\EventData

In step 3, if you did not specify a location, name, and password for the back up file and simply executed BackupDB.bat, execute:
RestoreEventTables.bat <Installation-directory>\ManageEngine\ADAudit Plus\backup\EventData

8. Go to <Installation-directory of new instance>\ManageEngine\ADAudit Plus\conf, rename the customer-config.xml and database_params.conf files to any name.

9. Go to <Installation-directory of old instance>\ManageEngine\ADAudit Plus\conf, copy and paste the customer-config.xml and database_params.conf files into <Installation-directory of new instance>\ManageEngine\ADAudit Plus\conf.

10. Go to <Installation-directory of old instance>\ManageEngine\ADAudit Plus, copy and paste the apps folder into <Installation-directory of new instance>\ManageEngine\ADAudit Plus.

11. Start ADAudit Plus, go to the Start menu > Services > Right-click the ADAudit Plus service, and select Start.

Validation and confirmation  

• Log in to the ADAudit Plus web console on the new server.

• Verify that all configurations, reports, and archived data are accessible.

• Check if all configured domains, alerts, and scheduled reports are intact.

• Ensure the event collection resumes successfully after startup.

Tips  

• Always ensure that both old and new servers are running the same ADAudit Plus build before performing the migration.

• Retain a copy of the backup file in a secure location before restoring.

• Avoid changing the default backup password unless necessary, and document any custom password securely.

• After migration, monitor the ADAudit Plus logs for any data integrity or connectivity errors.

Related topics and articles  

• How to upgrade ADAudit Plus