SmarterMail 14.x Help

General Settings

To access the general settings for SmarterMail server, click the settings icon and click General Settings in the navigation pane. The general settings will load and the following tabs will be available:

Server Info

Use this tab to specify the following server settings:

  • Hostname - The hostname of the server. Note: Hostnames should be in the format computername.domain.com.
  • Postmaster Mailbox - This is usually the mail server system administrator's email address as this is where errors in e-mail processing are generally directed.
  • IP of Primary DNS - The IP address of the primary DNS server. If left blank, the DNS server information will be pulled from the the Windows Networking settings (recommended).
  • IP of Secondary DNS - Enter the IP address of the secondary DNS server. If left blank, the DNS server information will be pulled from the the Windows Networking settings (recommended).
  • Logout URL - The URL to which users are redirected when they log out of SmarterMail. By default, users are presented with the log in page for the mail server. If this should be different, a new URL can be added.
  • Allow domain admins to override logout URL - Select this option to allow domain administrators to specify a Logout URL for their domain. If this option is not enabled, the option will not be visible to domain administrators.
  • Do not deliver postmaster messages at global level if handled at domain level - Select this option if postmaster messages should not be delivered to the global postmaster mailbox if the message was delivered to a domain account.

Login Display

Small businesses using SmarterMail on their own servers, or even companies using SmarterMail from their hosting provider, will benefit from the ability to customize the SmarterMail login page to add a company logo, provide additional branding text, or simply adjust the default “Login to SmarterMail” text to be more in line with an overall brand message. Note: System Administrators can allow Domain Administrators to override the custom login screen by editing the Domain, clicking on the Features tab and checking Login Display Customization.

Use this tab to adjust the SmarterMail login display settings:

  • Custom Help URL - Entering a full URL in this field will add a custom button to the Help menu that users can access in the SmarterMail interface. Administrators can link to a variety of things, including server-specific instructions for syncing, help resources, contact information, etc.
    • Enabled - Check this box to enable the custom help URL in the Help menu.
  • Custom Help Text - The hyperlink text for the custom URL in the Help menu.
  • Custom Login Text - Use this field to adjust the default "Log into SmarterMail" text with something more in line with an overall brand message.
    • Enabled - Check this box to enable the Custom Login Text.
  • Company Logo - Click on Choose File to upload a company logo. Uploading a logo using this upload control will host the image publicly on the server and enter the
    <img src="URL" /> tag in the HTML section. Note: Uploading an image here alone will NOT display the image on the login screen. The HTML must be entered in the Login Page HTML section. This upload control can be used by those who don't have their logo publicly hosted or who wish the image source to point back to their mail server. Furthermore, regardless of the image uploaded, the image's source URL will remain the same; only one image may be hosted at a time.
  • Enable custom login page HTML - Check this box to enable the ability to use HTML to further modify the login screen to add additional text or adjust the layout. This is used in conjunction with the Login Page HTML section below.
  • Login Page HTML - Enter the custom HTML that will be used to further modify the login screen (in-line custom CSS can be used as well). Note: To include white space around the company logo, the div id "companyinfo" must be included.

The following options are available in the content pane toolbar:

  • Save - Saves the custom login display settings.
  • Preview - Opens a new popup window displaying what the current settings render on the login screen. If this window remains open, live changes can be seen as settings are adjusted.

Spool

Use this tab to specify the following spool settings:

  • Spool Path - The full path in which messages are stored prior to delivery. If you are using a real-time virus scanner, this is the path that must be scanned in order to properly handle viruses.
  • SubSpools - SubSpools are within the spool path and allow SmarterMail to work around the NTFS limitation of 30,000 objects in an individual folder. SmarterMail will utilize subspools by allocating up to 10,000 messages per subspool. (Default is 10)
  • Delivery Delay - This number of seconds mail will be held in the spool before it is delivered. A delivery delay is beneficial when you are running a secondary service (such as a virus checker) that needs access to messages prior to delivery, as it provides ample time for the secondary service to interact with the message. By default, the delivery delay is 1 second.
  • Retry Intervals - When the mail server is unable to contact the receiving server, the email attempting to be sent is held for a period of time before the mail server attempts to resend it. This is the time between retries. Users can specify multiple retry attempts to resend emails before it is bounced. By default, this is set to 4 attempts - at 15 min, 30 min, 60 min, and 90 min intervals.
  • Bounce DNS errors after - The maximum number of attempts SmarterMail should make before the message is bounced due to a DNS error. The most common cause of a DNS error is a misspelled domain. Limiting the number of attempts before DNS errors are bounced is beneficial because messages will not sit in the queue for long periods of time taking up processing on the mail server and possibly slowing the system down. This will be helpful to users because messages will be bounced sooner and will give users the opportunity to fix any mistakes and get a message resent. By default, the server will make 2 attempts. Note: Setting this at 1 retry can be dangerous if the DNS server fails or if there is a loss of Internet connectivity. To disable this feature, set the number of bounces equal to the number of retry intervals.
  • Notify senders of delay after - Sets the number of delivery attempts before the sender is notified that the email delivery is delayed. This can be beneficial as it lets the sender know that the mail server is still attempting to deliver the message but that the recipient has not received it yet.
  • Command-Line File - Enable this and enter the full path to an executable you wish to use to process incoming messages. Use %filepath as an argument to pass the path of the email file to the executable. It is allowable for the executable to delete the message to prevent delivery. Example: If you set this field to "c:\program files\myexe.exe %filepath", the program myexe.exe will be launched with the full path to the spool file as its first argument. Note: The command will not be executed if the Enabled box is not checked.
  • Command-Line Timeout - The number of seconds that the server will wait for information from the remote server. In general, a timeout of 5 seconds should suffice.

Reports

Use this tab to specify the following settings:

  • Delete Server Stats After - The length of time server stats should be kept before being deleted. By default, server stats are deleted after 13 months.
  • Delete Domain Stats After - The length of time domain stats should be kept before being deleted. By default, the domain stats are deleted after 13 months.
  • Delete User Stats After - The length of time user stats should be kept before being deleted. By default, the user stats are deleted after 13 months.

Indexing

Use this tab to specify the following settings:

  • Max Threads - The maximum number of threads to use for search indexing. Increasing this value will cause SmarterMail to use more CPU, but will allow the system to simultaneously index more users.
  • Segment Count Before Optimizing - The number of segment counts in an index before the index is reorganized. Increasing this number will increase file counts per mailbox, but will use less CPU.
  • Items Before Garbage Collection - The number of indexed items across the server before freeing as much memory as possible. Increasing this number will increase memory usage and lower CPU usage.
  • Items to Index Per Pass - The number of items to index per user per index attempt. Increasing this number will increase memory usage and decrease the time it takes to index one user. However, it will increase the length of time it takes to index many small users if there are a few large users.
  • Seconds In Queue Before Indexing - The amount of time a user must be in the indexing queue before being indexed. This setting provides a buffer for many changes to a mailbox to ensure the same user is not indexed multiple times. Increasing this number will cause search results to be delayed further, but will result in indexing heavier users less frequently.
  • Deleted Items Before Optimizing - The number of items that will be removed from the index before an optimization will occur. Increasing this number will slow search results. Decreasing this number will increase CPU and disk usage, but will increase search result speed.