Difference between revisions of "Management Console - General"

[checked revision]

Revision as of 15:01, 25 July 2018

Dashboard

The dashboard of the Management Console is divided into the following parts.

Service Health

This sections gives a quick overview of the status of all configured hosts and their roles which are under the control of the Management Server. The root node of the tree always represents the Management Server, the left branch the Instance Hosts and the right branch shows the Client Access Servers. Instance Host nodes also show the number of available and active instances.

Version and License Information

Details about the product version in use and the licensee including their customer number are displayed here.

My Resources

The My Resources sections lists all resources created in the MailStore Service Provider Edition. This includes the number of Management Server, Instance Hosts, Client Access Server and the total number of instances available and running.

Messages

System messages that might require further administrative actions are shown in the Messages section of the dashboard. Typical message may contain warnings about license update failures or necessary search index rebuilds.

Instances

The main task of each MailStore Service Provider Edition administrator will be the management of instances. General administrative tasks such as creating, configuring, stating, stopping and deleting instances is described in the following.

Individual instance tasks like managing archive stores and search indexes, managing users and creating setting up archiving is covered in Instance Management.

Creating Instances

To create new instances for customers follow these steps:

Log on to the Management Console, if not already logged on.
Click on General > Instances.
Click Create Instance.
Enter a unique Instance ID.

Hint: It is not necessary to choose a meaningful instance ID, as an alias name can define in the next step. The instance ID could for example be a customer number or any other unique identifier from a CRM system.
Click OK.
Fill out the Instance Configuration form:

Tab: Base Configuration
URL Alias Meaningful unique alias name that can be used as an alternative to the instance ID.

Display Name: Additional identification information for the instance, e.g. customer name.

Instance Host: Instance Host on which the new instance gets created.

Start Mode: Defines how the instance is started. Choose from the following options (Default: Automatic):
Disabled: The instance can neither be started automatically nor manually.

Manual: The instance can only be started manually.

Automatic: The instance will automatically be started with the Instance. Host.

Base Directory: Directory where instance's data will be stored.

Tab: Advanced Configuration
Enable VSS Writer: Enable support for Volume Shadow Service.
Exclude Indexes from VSS Backup: Excludes the unencrypted search index files from the backup set reported by the VSS writer.
Please note: This option can be set so that administrators which have access to the backup files cannot access the unencrypted search index files. When restoring backups that do not include search index files, the search indexes have to be rebuilt.

Enable Debug Log: Enable debug logging for the instance.

Enable IMAP Server Connection Log: Enable IMAP Server connection logging for the instance.
Click OK to create the instance.
MailStore Service Provider Edition will now create the new instance and displays the login credential for afterwards.

If the end customer should be able to administrate the newly created MailStore Server instance on his own, these credentials must be made available to him. Otherwise it is not necessary to save these credentials.
Click OK to finish.

Irrespective of the configured Start Mode, the newly created instance must be started manually before it can be used. Read more about starting, stopping and restarting of instances in the next section.

Controlling Instances

To start, stop or restart instances follow the steps:

Log on to the Management Console, if not already logged on.
Click on General > Instances.
Select one or multiple instances from the list using the appropriate checkboxes.
Click either on Start, Safe Mode, Stop or Restart.

Please notice that the Start Mode of an instance must be set to Automatic or Manual in order to start an instance.

Safe Mode

An instance can be started in Safe Mode to perform maintenance on its configuration.

While the Safe Mode is active:

Only administrators can log in to the instance
Automatic archiving and export profiles are not started
Jobs are not started automatically
All internal heartbeats are disabled

Configuring Instances

Most configuration settings of existing instances can be modified. The instance to modify must be stopped before its configuration can be changed. To change the configuration proceed as follows:

Log on to the Management Console, if not already logged on.
Click on General > Instances.
Select the instances to modify.
Click on Configure....
Make the desired configuration changes.

Tab: Base Configuration
URL Alias Meaningful unique alias name that can be used as an alternative to the instance ID.

Display Name: Additional identification information for the instance, e.g. customer name.

Instance Host: Instance Host on which the new instance gets created.

Start Mode: Defines how the instance is started. Choose from the following options (Default: Automatic):
Disabled: The instance can neither be started automatically nor manually.

Manual: The instance can only be started manually.

Automatic: The instance will automatically be started with the Instance. Host.

Base Directory: Directory where instance's data will be stored.

Tab: Advanced Configuration
Enable VSS Writer: Enable support for Volume Shadow Service.
Exclude Indexes from VSS Backup: Excludes the unencrypted search index files from the backup set reported by the VSS writer.
Please note: This option can be set so that administrators which have access to the backup files cannot access the unencrypted search index files. When restoring backups that do not include search index files, the search indexes have to be rebuilt.

Enable Debug Log: Enable debug logging for the instance.

Enable IMAP Server Connection Log: Enable IMAP Server connection logging for the instance.
Click OK to save the changes.

Important notice: Neither changing the Instance Host nor the Base Directory will move the archive data to the new location. If necessary this must be done manually before starting the instance again.

Deleting Instances

Instances can be deleted at any time as long as they are stopped. Deleting an instance only removes it from the management database of the MailStore Service Provider Edition. All instance data remains on the hard disk and must be removed manually if necessary. To delete an instance follow these instructions:

Log on to the Management Console, if not already logged on.
Click on General > Instances.
Select the instances to delete.
Click on Command > Delete.
Confirm the security query with OK to delete the instance, otherwise click Cancel to abort.

License Information

Clicking on the License Information menu item opens an overview of all data that is used by the billing process.

Used Licenses per Instance

Displays a list off all instances and their respective amount of used licenses.

Used Resources

This is a statistical overview of used resources.

Raw Licensing Request

The raw licensing request tab shows how the actual licensing request to our accounting servers looks like. The Management Server sends this information once every 24 hours to renew the local licensing information of the MailStore Service Provider Edition.

SMTP Settings

To be able to send emails to system administrators, the Service Provider Edition needs SMTP access data. The SPE sends notifications by email if product updates are available, if a new Web Access version was installed automatically or if the license renewal was not possible for three consecutive days.

Enter the host name of the SMTP server or its IP address into the field Server.
By default, MailStore uses port 587. If you want to use a different port, enter the port to use in the Port field.
From the drop-down Protocol, select SMTP for an unencrypted connection to the SMTP server. For an encrypted connection, select SMTP-TLS (STARTTLS, Explicit SSL) or SMTP-SSL (Implicit SSL). If the SMTP server does not have an official or trusted SSL certificate, check Ignore SSL Warnings; otherwise, the sending process will fail.
Especially SMTP servers which are accessible through the internet require a login (SMTP authentication). Check the corresponding checkbox and enter the appropriate credentials into the User Name and Password fields.
In the Sender section, enter the Display Name and the Email Address of the email sender. Many SMTP servers require an existing email address to be entered. The display name can be chosen freely; ideally the name indicates that the email was sent by the Service Provider Edition.
Under Recipient for Notifications, select the system administrators who should receive notifications. When there are no administrators with configured email address, this list remains empty.
Once all settings have been specified, the SPE can be instructed to send a test email to the selected system administrators; simply click on Apply and Test. If an error message appears or the recipient specified does not receive the email, the following hints for troubleshooting may be helpful.

Troubleshooting

If no error occurs upon sending but the email does not arrive, please check the spam or junk mail folder of the mailbox. Perhaps the email was filtered out.
If an error message appears because of an invalid certificate ("Server's certificate was rejected by the verifier because of an unknown certificate authority."), check Ignore SSL Warnings and try again.
If an error message appears indicating that "One or more recipients rejected", the SMTP server probably requires authentication. Enter the appropriate access data as described above.
If an error message appears because of invalid access data ("Incorrect authentication data"or "Authentication failed"), verify the data entered.
If further error messages appear or other problems arise, please check your input for possible mistakes.

@@ Line 81: / Line 81: @@
 == SMTP Settings ==
-To be able to send emails to system administrators, the Service Provider Edition needs SMTP access data. The SPE sends notifications by email if  product updates are available or if a new Web Access version was installed automatically.
+To be able to send emails to system administrators, the Service Provider Edition needs SMTP access data. The SPE sends notifications by email if product updates are available, if a new Web Access version was installed automatically or if the license renewal was not possible for three consecutive days.
 * Enter the host name of the SMTP server or its IP address into the field ''Server''.