Difference between revisions of "Configuration Tool"

[unchecked revision][unchecked revision]
Line 2: Line 2:
 
[[File:MailStore_Gateway_Configuration.png|right|300px]]
 
[[File:MailStore_Gateway_Configuration.png|right|300px]]
  
The MailStore Gateway Configuration tool, allows administrators to make basic configuration changes and necessary settings to successfully run the MailStore Gateway service.  
+
The MailStore Gateway Configuration tool, allows administrators to make basic configuration changes and necessary settings to run the MailStore Gateway service.  
  
The MailStore Gateway Configuration tool is either started automatically as part of the initial installation process, or can be started manually through the corresponding desktop or start menu link.
+
The MailStore Gateway Configuration tool is either started automatically as part of the initial installation process, or can be started manually by using the corresponding desktop or start menu link.
  
 
{{clear}}
 
{{clear}}
Line 13: Line 13:
 
If emails from other email servers (e.g. Microsoft Office 365, Google G Suite, etc.) should be received by MailStore Gateway, the configured ''E-Mail Domain'' must be resolvable via DNS.
 
If emails from other email servers (e.g. Microsoft Office 365, Google G Suite, etc.) should be received by MailStore Gateway, the configured ''E-Mail Domain'' must be resolvable via DNS.
  
'''Example: ''' If the primary domain is ''example.com'' and MailStore Gateway should receive emails, a DNS record like ''msgw.example.com'' needs  be created in the DNS zone ''example.com''. The records must poins to the public IP address on which MailStore Gateway is reachable. If MailStore Gateway is located behind a NAT firewall, additional configuration may be needed. Refer to [[Firewall Configuration]] for further details. In MailStore Gateway, the ''E-Mail Domain'' to be configured would be <tt>msgw.example.com</tt>.  
+
'''Example: ''' If the primary domain is ''example.com'' and MailStore Gateway should receive emails, a DNS record like ''msgw.example.com'' needs  be created in the DNS zone ''example.com''. The records must point to the public IP address on which MailStore Gateway is reachable. In MailStore Gateway, the ''E-Mail Domain'' to be configured would be <tt>msgw.example.com</tt>
 +
If MailStore Gateway is located behind a NAT router or firewall, additional configuration may be needed. Refer to [[Firewall Configuration]] for further details.  
  
 
== Certificate ==
 
== Certificate ==
MailStore Gateway uses TLS certificates to provide encrypted communication with clients and other servers.
+
MailStore Gateway uses TLS certificates to establish encrypted communication channels with clients and other servers.
  
 
The MailStore Gateway Configuration tool allows administrators to specify which certificate is to be used by MailStore Gateway. Administrators may choose from the following options:
 
The MailStore Gateway Configuration tool allows administrators to specify which certificate is to be used by MailStore Gateway. Administrators may choose from the following options:
Line 22: Line 23:
 
* '''Select from Certificate Store'''<br/>A certificate can be selected from the Windows' certificate store. Please note that the ''Personal'' certificate store of the Computers is used, not of the current Windows users.
 
* '''Select from Certificate Store'''<br/>A certificate can be selected from the Windows' certificate store. Please note that the ''Personal'' certificate store of the Computers is used, not of the current Windows users.
 
* '''Create Self-Signed Certificates'''<br/>A new self-signed certificate can be created and is automatically selected afterwards. Please note that self-signed certificates are neither trusted by other clients, which may lead to  warnings on client computers, nor other servers. Therefor, Self-signed certificates are suitable for testing purpose and should be replaced once a system is used in a productions environment.
 
* '''Create Self-Signed Certificates'''<br/>A new self-signed certificate can be created and is automatically selected afterwards. Please note that self-signed certificates are neither trusted by other clients, which may lead to  warnings on client computers, nor other servers. Therefor, Self-signed certificates are suitable for testing purpose and should be replaced once a system is used in a productions environment.
* '''Import from File'''<br/>This option allows administrators to import certificates from ''Private Information Exchange (*.p12;*.pfx)'' files. The configuration tool will automatically import the certificates into the correct Window's certificate store. Since Private Information Exchange files are password protected, a password must be entered to to start the import process.
+
* '''Import from File'''<br/>This option allows administrators to import certificates from ''Private Information Exchange (*.p12;*.pfx)'' files. The configuration tool will automatically import the certificates into the correct Window's certificate store. Since Private Information Exchange files are password protected, a password must be entered to start the import process.
  
 
== Log Level ==
 
== Log Level ==
Line 28: Line 29:
  
 
== Apply Configuration Changes ==
 
== Apply Configuration Changes ==
After the configuration of MailStore Gateway has been changed, the changes need be written to the configuration file by clicking on ''Apply''. Otherwise the changes will not be considered when starting the MailStore Gateway service.  
+
After the configuration of MailStore Gateway has been changed, the changes need be written to the configuration file by clicking on ''Apply''. Otherwise the changes will not be used when starting the MailStore Gateway service.  
  
 
== Starting the MailStore Gateway Service ==
 
== Starting the MailStore Gateway Service ==

Revision as of 11:38, 6 February 2019

MailStore Gateway Configuration.png

The MailStore Gateway Configuration tool, allows administrators to make basic configuration changes and necessary settings to run the MailStore Gateway service.

The MailStore Gateway Configuration tool is either started automatically as part of the initial installation process, or can be started manually by using the corresponding desktop or start menu link.

E-Mail Domain

The value of the E-Mail Domain field specifies the domain part of the individual email addresses that are created for each MailStore Gateway mailbox.

If emails from other email servers (e.g. Microsoft Office 365, Google G Suite, etc.) should be received by MailStore Gateway, the configured E-Mail Domain must be resolvable via DNS.

Example: If the primary domain is example.com and MailStore Gateway should receive emails, a DNS record like msgw.example.com needs be created in the DNS zone example.com. The records must point to the public IP address on which MailStore Gateway is reachable. In MailStore Gateway, the E-Mail Domain to be configured would be msgw.example.com. If MailStore Gateway is located behind a NAT router or firewall, additional configuration may be needed. Refer to Firewall Configuration for further details.

Certificate

MailStore Gateway uses TLS certificates to establish encrypted communication channels with clients and other servers.

The MailStore Gateway Configuration tool allows administrators to specify which certificate is to be used by MailStore Gateway. Administrators may choose from the following options:

  • Select from Certificate Store
    A certificate can be selected from the Windows' certificate store. Please note that the Personal certificate store of the Computers is used, not of the current Windows users.
  • Create Self-Signed Certificates
    A new self-signed certificate can be created and is automatically selected afterwards. Please note that self-signed certificates are neither trusted by other clients, which may lead to warnings on client computers, nor other servers. Therefor, Self-signed certificates are suitable for testing purpose and should be replaced once a system is used in a productions environment.
  • Import from File
    This option allows administrators to import certificates from Private Information Exchange (*.p12;*.pfx) files. The configuration tool will automatically import the certificates into the correct Window's certificate store. Since Private Information Exchange files are password protected, a password must be entered to start the import process.

Log Level

The Log Level defines how much information MailStore Gateway logs into it's log files. The default settings is Information which should not be changed unless troubleshooting is required.

Apply Configuration Changes

After the configuration of MailStore Gateway has been changed, the changes need be written to the configuration file by clicking on Apply. Otherwise the changes will not be used when starting the MailStore Gateway service.

Starting the MailStore Gateway Service

By clicking the Start Service button at the bottom of the configuration tool, the MailStore Gateway service will be will be started. This button is only available if the service is currently stopped.

If there are unsaved configuration changes, the tools will show a warning that old values will be used to start the service. If that is not intended, the process should be canceled to apply changes first.

Stopping the MailStore Gateway Service

By clicking the Stop Service button at the bottom of the configuration tool, the MailStore Gateway service will be will be stopped. This button is only available if the service is currently running.