Editing the Email Archive Service's Configuration File
Use the configuration file found here: C:\Program Files\Laserfiche\EmailArchive\config.xml to configure:
- Running the Email Archive service on multiple threads
- A location where the database file can cache any emails the service cannot process immediately or that fail to import. The database file will also cache pieces of large emails that have been sent in parts until the parts arrive or a timeout period has been reached. Learn more about mail caching.
- TLS settings
Note: The TLS options are also configurable in the Email Archive Service Settings.
Note: You must restart the Email Archive service for changes to the Config.xml file to take effect.
Options in the Config.xml file
| Name | Type | Default Value | Notes |
|---|---|---|---|
| MaxEmailSize* | Long | 20971520 | The maximum email size in bytes that Email Archive can accept. |
| RequireTLS* | Boolean | False | If the Email Archive Service requires TLS or not. If true, Email Archive and the email server must be configured to use TLS. |
| Thumbprint* | String | Thumbprint of the certificate used by the Email Archive Service TLS. This will be ignored if RequireTLS is false. | |
| ClientCertificateRequired* | Boolean | False | If the Email Archive Service requires the client who sends emails to the service to send a certificate for TLS negotiation. This will be ignored if RequireTLS is false. |
| CheckClientCertificate* | Boolean | False | If the Email Archive Service will check certificate revocation for the TLS negotiation. This will be ignored if RequireTLS false. |
| ThreadCount | Integer | 4 |
The maximum number of threads the Email Archive Service can create when importing to Laserfiche. |
| Location* | String | The location of the database file that caches emails. If this option is left empty, C:\ProgramData\Laserfiche\EmailArchiveService\cache.db will be used. Learn more. | |
| QueueCapability | Integer | 1000 | The capability for incoming emails to be processed. If there are more incoming emails than specified in this parameter, they will be put into a database file to be cached first and will then be processed when the service is idle. Learn more. |
| PartialMessageReceiveTimeout* | Integer | 30 minutes | Timeout for collecting partial messages, in minutes. After this timeout, any remaining partial messages will be imported to Laserfiche. |
| RetryInterval* | Integer | 1440 minutes (1day) | The interval at which the Email Archive Service will try to process emails cached in the database, in minutes. |
| CompactInterval* | Integer | 1440 minutes (1day) | The interval at which the database file will be compacted, in minutes. E.g., Given the default value, the database file will be compacted once a day. |
| Port* | Integer | 25 | Available in Import Agent 10.3.1 and later: The TCP port for SMTP communication. This option is configurable through Email Archive Service Settings accessed from the Email Archive Configuration dialog box. Restart the Email Archive Service after modifying the value. Additionally, ensure you have a firewall exception for this port. |
* The starred items are only applicable for Email Archive configurations that use SMTP and are not applicable to Email Archive configurations that run using IMAP.
