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 | + | 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 | + | 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 | + | '''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 | + | 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 | + | * '''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 | + | 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
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.
