9.2 Backing Up and Restoring the Configuration

You should back up your MailMarshal configuration at the following times:

Before and after you make substantial MailMarshal configuration changes.

Before applying an upgrade.

Information 

Note: You can make backups automatically once a day and/or after every configuration commit. Daily backups are enabled by default. See “Automatic Configuration Backup”.

You can restore the configuration when you want to make the following changes:

Create a new Array Manager server.

Return to a previous version of your email policy.

In addition to the following backup and restore procedures, you can back up and restore the configuration using a command line prompt. For more information see “Using the Configuration Export Tool”.

You can import your user and group information using the MailMarshal Management Console. For more information see, “Configuring User Groups”.

You can also import user group information using a command line prompt. For more information see “Using the Group File Import Tool”.

For more information about backing up the \Quarantine folders and the MailMarshal database, see the Trustwave Knowledge Base.

9.2.1 Backing Up the Configuration

Backing up the MailMarshal configuration includes running Backup in the Management Console and backing up the following additional files:

Table 24: Files to include in configuration backup

Computer

Folder

Files

Array Manager

Folder you specify during Backup operation (by default, InstallPath\ConfigurationBackup)

manual or automatic backup zip file (for example, MailMarshal-ver-Manualbackup_
datetime.zip)

Array Manager

InstallPath

filetype.cfg

Array Manager (optional)

InstallPath\Logging

*.log

Email processing servers

InstallPath\Quarantine and
InstallPath\Quarantine\ValidFingerprints

*.*

Where InstallPath indicates the location where you installed the product. The default install path is \Program Files\Trustwave\Secure Email Gateway.

Information 

Note: Backups do not include members of groups imported through directory connectors.

 

To back up the MailMarshal configuration:

1.In the left pane of the Management Console, click System Configuration.

2.In the right pane menu, select Backup.

3.If you use DKIM signing, select the option to include DKIM keys.

4.Click Backup Now. The backup is created in the ConfigurationBackup subfolder on the Array Manager.

Tip 

Tip: To ensure the backup is not deleted by the backup retention policy, copy this file to another location.

 

5.If you have created file type rules, back up the filetype.cfg file in the \InstallPath folder.

6.Make a note of each MailMarshal email processing server computer name.

7.On each MailMarshal email processing server computer, back up the \InstallPath\Quarantine and \InstallPath\Quarantine\ValidFingerPrints folders by following the instructions in Knowledge Base article Q10220.

8.Make a note of the MailMarshal database computer name.

9.On the database computer, back up the MailMarshal database by following the instructions in Knowledge Base article Q10221.

9.2.2 Automatic Configuration Backup

MailMarshal can back up configuration automatically. Automatic backup can be on a daily schedule and/or after each configuration commit. Daily backup is enabled by default.

Automatic backups include the same configuration items included in manual backups. To make a full automatic backup, you should schedule backup of the files mentioned in the previous section.

Automatic backups are stored in the subfolder \ConfigurationBackup within the MailMarshal installation on the Array Manager server. The backup file name shows the product version and date of creation.

To enable, disable, or set the retention period for automatic backups, in the Management Console navigate to MailMarshal Properties > Array Properties > Backup.

9.2.3 Restoring the Configuration

Restoring the MailMarshal configuration requires a number of steps. You can restore the configuration if you are creating a new Array Manager server, or if you want to return to a previous version of your email policy. 

For additional steps required to restore a configuration saved in MailMarshal 8.2, see “Using the Configuration Export Tool” 

Information 

Note: The restored data does not include the members of groups imported through directory connectors. To retrieve the group members: After restoring the configuration, in the left pane of the Configurator right-click User Groups and select Reload User Groups.

  

To restore your MailMarshal configuration:

1.In the left pane of the Management Console, click System Configuration.

2.In the right pane menu, select Restore.

3.Select a file to restore from the list. Backups are stored in the subfolder \ConfigurationBackup within the MailMarshal installation on the Array Manager server. The backup file name shows the product version and date of creation.

4.Click Restore. Enter the password to restore DKIM keys, and then click OK.

5.To restore custom file type definitions, copy the backup filetype.cfg file to the \InstallPath folder on the Array Manager computer.

6.To repopulate users in LDAP and Active Directory user groups with current members:

a.In the left pane of the Management Console, select Policy Elements. In the right pane, expand User Groups.

b.For each Connector based group, select the group and then click Reload.

7.To retrieve the latest Spam Censor definition file, spamfilter.xml:

a.From the left menu, select System Configuration.

b.Select Automatic Updates in the left pane and click Check for Updates Now.

c.When the update is complete, click OK and then click Commit Configuration.

8.On each MailMarshal email processing server computer, restore the \InstallPath\Quarantine and \InstallPath\Quarantine\ValidFingerPrints folders by following the instructions in Knowledge Base article Q10220.

9.On the database computer, restore the MailMarshal database from the backup copy. For more information about restoring a database file, see the Microsoft SQL Server or SQL Express documentation.

10.To connect to a new or existing MailMarshal database, connect to the database using the MailMarshal Server Tool. For more information, see “Joining a Node to an Array” and “Working with Array Communications”.

Trustwave MailMarshal 10.2.5 User Guide August 2024
< Previous Section   |   Next Section >
Full document: see MailMarshal Documentation.