Back up and Restore Your License Database

About the Acrolinx License Database

The Core Platform stores all information about licensed users in the Acrolinx license database. After you connect to the server for the first time, the server creates the license database.

The license database is created and stored at the following location:

%ACROLINX_CONFIGURATION_ROOT%\server\bin\acrolinx.aldb.h2.db

The H2 license database replaces the license, user, and roles databases used in Core Platform version 3.1 and lower. 

Backups

The Core Platform regularly creates backups of the database in the following directory:

%ACROLINX_CONFIGURATION_ROOT%\server\bin\license-backups

Add these database backups to your daily backup. Don’t add the active database (the acrolinx.aldb.h2.db file) to the backup. Accessing an active database might cause errors.

Upgrades from Earlier Server Versions

In Core Platform versions 3.1 and lower, the license, user, and roles database were stored in a different format (<NAME>.ald/.aud/.ard ) in the configuration directory. To upgrade to a later version from Core Platform versions 3.1 and lower, you first need to upgrade to Core Platform version 3.2, to make sure the existing databases are converted and merged into the new license database. You can then upgrade to a more recent Acrolinx version. The legacy database files are moved to the following directory:

%ACROLINX_CONFIGURATION_ROOT%\server\bin\deprecated

Restoring License Database Backups

The Core Platform creates backups of the license database in the following directory:

%ACROLINX_CONFIGURATION_ROOT%\server\bin\license-backups

The backups are created on an hourly basis. The file names contain a one-letter identifier, followed by an epoch timestamp. The identifier helps you to distinguish between hourly (H), daily (D), weekly (W) and monthly (M) backups. If you encounter an issue with the license database, you can use the backups to restore the database to a working state.

To restore a database backup, follow these steps:

  1. Stop the core server.
  2. Unpack the relevant backup archive into the following directory:

    %ACROLINX_CONFIGURATION_ROOT%\server\bin\

  3. Restart the core server.
  4. Use the Dashboard to verify that the backup was correctly restored.

    For example, check that all users are present and that the role assignments are correct.