Email backups

Introduction to email backups in ConSol CM

Incoming emails which could not be processed are stored as .eml files in the table cmas_nimh_archived_mail of the ConSol CM database. These emails are managed on the Email backups page.

Concepts, terms and definitions

Concept	Other terms	Definition
email backup		Email which was fetched from the mail server and saved to the database because it could not be processed.
mail server		Software to transfer email messages between clients, not part of ConSol CM.

Purpose and usage

Emails which could not be processed are listed on the Email backups page. This is usually caused by one of the following reasons:

• One of the email scripts (see Scripts of the type Email) has a bug, so that emails can be fetched from the mail server, but not be processed further in ConSol CM.
• An email attachment is too large. The size limit is defined by the system property cmas-nimh, mailbox.default.task.max.message.size.
• The email is corrupted or does not conform to the RFC. The system property cmas-nimh, mailbox.default.session.mail.mime.address.strict determines how strict the parsing is.

On the Email backups page, you can retry processing these emails, download them or delete them.

The Email backups page only shows the emails which are saved in the table cmas_nimh_archived_mail and have the value 0 in the processed_success column.

Available settings for email backups

The following information is available for email backups:

• Subject
  The subject of the email.
• From
  The email address of the sender of the email.
• Mailbox
  The mailbox which received the email.
• Backup cause
  The reason why the email could not be processed. For example, because the email is too large.
• Size (MB)
  The size of the email in MB.
• Backup date
  The date when the email backup was saved to the database.

Basic tasks

Finding an email

The list of email backups is displayed directly after accessing the Email backups page of the Web Admin Suite. You can filter the list to locate an email more easily:

• Text search: Perform a free text search.

  Enter a text in the Search field to filter by subject, sender, mailbox or backup cause.

Managing email backups

You can perform the following actions on email backups:

• Retry processing an email
  Click the Process icon in the email’s row to retry processing this email. If the processing succeeds, the email is removed from the Email backups page.

• Download an email
  Click the Download icon in the email’s row to save a copy of the email to your local file system. The email is exported in .eml format. You can open it with an email client or a text editor to check if there are any problems with the email which prevent ConSol CM from processing it.

• Delete an email
  Click the Delete icon in the email’s row to remove the email from the database. The email will be deleted and cannot be recovered.