Configuring enaio® mail-archive-service

enaio® mail-archive-service is configured using the masmailbox-prod.yml, masstorage-prod.yml, massmtp-prod.yml, and application-mas.ymlconfiguration files located in the \config\ directory of enaio® service-manager.

Customizable configuration files are available to download, which you can use as a basis for the configuration.

'mas-mailbox' Service

The service reads from an alternate (backup) mailbox or from multiple mailboxes in order to ensure that no e-mails are lost in the event of an online journaling service outage. The e-mails are added to the queue and further processed by the 'mas-storage' service. In the case of mailbox archiving, this service marks the e-mails in the mailboxes to inform the user that a particular e-mail is filed in enaio®.

The configuration is done via the masmailbox-prod.yml file.

'mas-smtp' Service

The 'mas-smtp' service contains an SMTP server that waits for incoming e-mail messages. It can accept regular e-mails or Microsoft Exchange online journal reports or reports about undeliverable messages. The SMTP server can be bound to a configurable port and can work with or without TLS. This service extracts MailMessage objects from received e-mails and passes them on to the 'mas-storage' service for storage in enaio®.

The configuration is done via the massmtp-prod.yml file.

The 'mas-smtp' service is not obligatory for plain mailbox archiving.

'mas-storage' Service

The 'mas-storage' service saves e-mail metadata and e-mail content in 'eml' format in enaio®. Whether these were saved successfully or an error occurred is reported back to the initiating service – mas-smtp or mas-mailbox. After saving to enaio®, post-processing, such as creating additional reference documents, may be performed.

The service receives the e-mails from the SMTP or mailbox service and files them in enaio®. Further processing steps, such as the creation of reference documents, are then carried out if necessary. A result status is reported back to the service delivering the e-mail.

The configuration is done via the masstorage-prod.yml file.

'application-mas.yml' Profile File

The application-mas.yml profile file contains parameters for accessing Microsoft Exchange Online and storage parameters used by multiple services. The profile is assigned to the services of enaio® mail-archive-service in the servicewatcher-sw.yml file.

The profile file is available as a template and must be found in the \config\ directory of enaio® service-manager.