Backup / Export configuration

To upgrade from one Metadefender Core version to another or clone same configuration to multiple instances, you should back up your current configuration so that you can restore the settings into your upgraded version. You can back up these settings either by using your Metadefender Core Management Console, or by exporting the settings using the command line.

Backup Using The Management Console

Backup using the management console does NOT contain process history and other application logs. If you want to backup process history, refer to "Exporting process history" section below.

If using Mail Agent see Mail Agent Upgrade

The preferred method of backing up your settings is by using the Metadefender Core Management Console. The following procedure downloads your current configuration settings in a file to a location of your choosing.
Note: The "Maximum File Size for files scanned through the web interface" setting (found on the Configuration > Scan Configuration page of the Metadefender Core Management Console) is NOT backed up and must be manually reconfigured, if necessary, after upgrading Metadefender Core.

  1. Access the Metadefender Core Management Console.

  2. Click the Backup/Restore tab.
    images/download/attachments/12319547/BackupRestore.png

  3. Optionally, you can select Encrypt Backup with the following password to create a password for your download.

  4. Click DOWNLOAD BACKUP .
    images/download/attachments/12319547/DownLoadBackup.png

  5. Save the download to the location where you want to store the backup.

Exporting process history

Optionally, you can export your process history (scan results) and then import them after you have installed the upgrade.

  1. Open the Windows command line as an administrator.

  2. Navigate to <Metascan installation folder>\Mongo\64+ (e.g. C:\Program Files (x86)\OPSWAT\Metadefender Core 4\Mongo\64+).

  3. Run the following command:

    mongodump.exe --host localhost --port 27018 --db metascan --collection files --out <path>

    Replace <path> with a path to where you would like to save the exported database. See https://docs.mongodb.com/manual/reference/program/mongodump/#bin.mongodump for more information about mongodump.exe.

Exporting your current configuration using the command line

Export the Metadefender Core configuration.

omsConfig.exe export <directory> [<option>]

The following command exports the Metadefender Core Properties (e.g., max archive size or temporary directory), database settings, REST server settings (e.g., API keys or REST port), SYSLOG settings, and MongoDB settings into a zip file.

[<option>] is optional, it should be in the format /pass=password

Exporting Quarantined file and email history

If you would like to export your quaratined file and email history for import after an update we recommend you use mongodump.exe.

  1. Open a Windows command prompt as administrator

  2. Navigate to <Metascan installation folder>\Mongo\64+ (e.g. C:\Program Files (x86)\OPSWAT\Metadefender Core 4\Mongo\64+).

  3. Run the following command:

mongodump.exe --host localhost --port 27018 --db MetadefenderQuarantine --out <path>

Replace <path> with a path to where you would like to save the exported database. See https://docs.mongodb.com/manual/reference/program/mongodump/#bin.mongodump for more information about mongodump.exe.

Exporting/Importing the MetadefenderQuarantine database is a slow process and may take hours if your database is larger than a few GB.