Backup and Restore

The guide covers: built-in database backup (BackupDB.bat), full directory backup, VM-level snapshots, archive data backup, and best practices. For all restore operations, contact ManageEngine Support — ADAudit Plus stores data across multiple stores and restore must be performed with engineering assistance.

The following sections provide a deployment-level summary.

Understanding What Data ADAudit Plus Stores

Data Type Default Location Notes
PostgreSQL database <install_dir>\pgsql\data\ Audit data (current portion) and all product configuration. Audit data is progressively moving to DataEngine in newer builds.
DataEngine index <install_dir>\dataengine\ ⚠️ Critical — Lucene-based index holding audit data for all categories (Identity, Data, Cloud, Infrastructure, Endpoints). BackupDB.bat does NOT cover this store — must be backed up separately.
Elasticsearch data <install_dir>\elasticsearch\data\ AD object snapshots for Identity Resilience (backup and recovery) feature.
Configuration and license <install_dir>\conf\ Product configuration files and license key.
Archive data Configurable (local folder or remote) Older audit data moved out of the primary database for long-term retention.
Scheduled reports Configurable Output folder for scheduled report delivery.
Full installation <install_dir>\ All product binaries, libraries, and executables.

VSS-consistent snapshots: Always enable VSS (Volume Shadow Copy Service) consistent snapshots when taking VM-level backups or cloud disk snapshots. An inconsistent snapshot may corrupt the PostgreSQL database, resulting in an unrecoverable state.

External SQL Server: If using Microsoft SQL Server instead of bundled PostgreSQL, VM-level backup alone does not guarantee SQL transaction-level consistency. An independent SQL Server backup strategy is required.

Application Backup

Recommended layered approach:

BackupDB.bat` — daily baseline (application-consistent PostgreSQL backup):

  • Stop ADAudit Plus → run StartDB.bat (PostgreSQL only) → run BackupDB.bat
  • Output: .ezip file + EventData\ folder — keep both, store off-VM

DataEngine folder backup — daily alongside BackupDB.bat:

  • Copy <install_dir>\dataengine\ to backup destination with service stopped
  • ⚠️ Required — BackupDB.bat does not cover DataEngine

Full directory backup — weekly (service must be stopped):

  • Copy entire <install_dir>\ManageEngine\ADAudit Plus\ to a backup server
  • Covers all data stores including DataEngine, Elasticsearch, and config

VM-level snapshot — daily:

  • AWS: EBS snapshot | Azure: Managed Disk snapshot | GCP: Persistent Disk snapshot | On-premises: hypervisor VSS-consistent snapshot
  • Captures all data stores atomically — foundation for DC-DR

    Note VSS-consistent snapshots required. A crash-consistent snapshot of a running PostgreSQL instance may result in an unrecoverable database. Always use VSS (application-consistent) snapshots, or stop ADAudit Plus before taking a file-level backup.

Database Backup

Database Type Backup Method
Built-in PostgreSQL Use BackupDB.bat daily for an application-consistent database backup. Full directory backup and VM snapshot also cover PostgreSQL when the service is stopped.
External Microsoft SQL Server BackupDB.bat does not support external MS SQL. An independent SQL Server backup strategy is required: SQL Server native backup (BACKUP DATABASE), AlwaysOn Availability Groups, or cloud managed backup (RDS automated backups, Azure SQL automated backups, GCP Cloud SQL backups).

Archive Data Backup

Archive Storage Type Backup Responsibility
Local folder (same VM) Covered by VM disk backup automatically
Remote SMB share Customer responsibility — independent backup of the share required

Restore

Note

[!] All restore operations must be performed with ManageEngine Support assistance.

ADAudit Plus stores audit data across multiple data stores (PostgreSQL, DataEngine, Elasticsearch, configuration, and archive). Restore procedures differ depending on the failure type and which backup method was used. A partial or incorrectly sequenced restore can result in permanent, unrecoverable data loss.

To initiate a restore, contact ManageEngine Support:

Channel Details
Support portal https://www.manageengine.com/products/active-directory-audit/support.html
Email support@adauditplus.com

Prepare before contacting support: backup type and location, ADAudit Plus build number, database backend (PostgreSQL or MS SQL), and a description of the failure.

Data Protection Summary

Data Store BackupDB.bat Directory Backup (stopped) VM Snapshot (VSS) Independent Backup Required
PostgreSQL (built-in) ✅ ✅ ✅ —
DataEngine index ❌ Not covered ✅ ✅ ✅ Back up daily alongside BackupDB.bat
Elasticsearch data ❌ ✅ ✅ —
Configuration and license ❌ ✅ ✅ —
External MSSQL database ❌ ❌ ❌ ✅ Required
Local archive folder (same VM) ❌ ✅ ✅ —
Remote SMB archive ❌ ❌ ❌ ✅ Required
Cloud object storage archive ❌ ❌ ❌ ✅ Configure provider versioning/backup