Instance Management

Revision as of 18:35, 22 January 2014 by Admin (talk | contribs) (Auto-Create Stores)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Jump to: navigation, search

For each instance further individual administrative functions exist. These functions are accessible through the instance details, which appear in pane below the instance list (General > Instances) of the Management Console when double-clicking on an entry in the list.

All these functions are group by tabs, for which further details are provided below.

Overview

On the Overview tab of the instance details a summary of the configuration is shown along with a diagram that shows the distribution of used instance storage by indexes, content files and databases.

Ms spe instance overview.png

Archive Stores

The Archive Stores tab allows the administration of the instance storage as well as the search indexes. New archive stores are automatically created in the base directory of the instance every 500.000 messages.

Creating Archive Stores

Although MailStore Service Provider Edition creates new archive stores automatically, this can also be done manually as described in the following:

  • Log on to the Management Console.
  • Click on General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Stores tab.
  • Click Create Store.
  • Fill out the Create Archive Store form:
    Ms spe create archivestore 01.png
  • Name: Meaningful name for the archive store.
  • Archive new messages here: If checked, new message will be archived in the newly created archive store (default: checked).
  • Directory: Directory in which the new archive store will be created. A proposal is created from the Name of the archive store and the base directory of the instance. Use the swung dash to point to a directory relative to the base directory of the instance, e.g. ~/Messages-2013-10
  • Click OK to create the new archive store.

Attach Existing Archive Store

Archive stores from MailStore Service Provider Edition instances or from on-premises MailStore Servers can be attached to an instance as described below:

  • Log on to the Management Console.
  • Click General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Stores tab.
  • Click Attach Store.
  • Fill out the Attach Archive Store form:
    Ms spe attach archivestore 01.png
  • Name: Meaningful name for the archive store
  • Archive new messages here: If checked, new message will be archived in the newly created archive store. (default: unchecked)
  • Directory: Directory of the archive store to attach. This directory must contain the file "MailStoreFileGroup.fdb". Use the tilde to point to a directory relative to the base directory of the instance, e.g. ~/Messages-2013-10.
  • Click OK to attach the archive store.

Maintain FS Databases

For storing meta data of the archive store's content embedded Firebird databases exist in every archive store. Under certain circumstances (e.g. after a disaster recovery of the server or storage) it might become necessary to perform a maintenance task on those databases. This can easily be done for all archive stores of a particular instance be following the instructions below:


  • Log on to the Management Console.
  • Click General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Stores tab.
  • Click Maintain FS Databases to start the maintenance.
  • A progress windows will appear.
  • Wait until the process is completed successfully and click OK. Otherwise click Cancel to interrupt maintenance process at any time.

Auto-Create Stores

MailStore Service Provider Edition automatically creates new archive stores every 500.000 messages. This setting can be adjusted to your need:

  • Log on to the Management Console.
  • Click General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Stores tab.
  • Click Auto-create.
  • Adjust the settings in the Auto-Create Archive Stores dialog.
    Ms spe autocreate stores 01.png
    Important notice: Non-optimal settings can have a negative impact on the overall performance of the instance.
  • Click OK to save the settings.

Store Commands

Advanced store commands are accessible by following these steps:

  • Log on to the Management Console.
  • Click General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Stores tab.
  • Select an archive store and click on Store Commands or right-click on an archive store to open a context menu.

A summary of the available store commands can be found in the tables below:

Requested State

State Description
Disabled Disabled archive stores are not in use but the instance still knows about their existence. The content is not available to users or administrators while the archive store is disabled. This state is useful when moving archive stores to a new directory.
Write Protected The content of write protected archive stores is available to users, but cannot be modified (e.g. delete or move messages, rename or move folders)
Normal The content of archives store is available to users and can be modified if the user has the appropriate permission.
Current Same as Normal but new messages will be archived in the archive store that is set to Current.

Commands

Command Description
Detach Detaches the selected archive store. The archive store can be re-attached by using the Attach function. Please note that the archive store's name and ID will not be retained when detaching and re-attaching. Therefore, when moving an archive store to a new location, disabling the the archive store and using Set Path afterwards is preferred over re-attaching.
Rename Specify a new name for the archive store.
Set Path Change the path of the archive store. The archive store must be disabled before changing the path. Please note that the file system directory must be moved manually to the new location before re-enabling the archive store.
Compact Optimizes the data structures.
Upgrade If an archive store from a MailStore Server 5 or older was attached to an instance, it is highly recommended to upgrade the archive store to the latest format by using this function. Upgrade process can be interrupted and continued at any time.
Verify Verification of the data integrity between folder information and meta data as well as email headers and content.

Search Indexes

Additionally to container files storing the actual email content and the embedded Firebird databases used for storing meta information, a full-text index file is created for each archive that has emails stored in an archive store. By default the full-text index only included email bodies, but virtually any file type is supported (see Configure).

To access these functions, follow the instructions below:

  • Log on to the Management Console.
  • Click General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Stores tab.
  • Click Search Indexes.

The below functions are available in the search index menu to configure and maintain the full-text indexes of an instance.

Rebuild Broken Indexes

Starts a rebuild of all search indexes across all archive stores that are marked a broken.

Rebuild All Indexes

Starts a rebuild of all search indexes in all archives stores. This is usually only required after making changes to the list of attachment extensions to be included in the full-text index.

Configure

Specify a list of file extensions for attachments to be included in the full-text index. MailStore Service Provider Edition can index all file types for which a so-called IFilter driver is installed on the instance host on which the MailStore Server instance is running.

Under the name Office 2010 Filter Packs Microsoft offers a package that, additionally to all legacy as well as recent Microsoft Office Formats, supports the Open Document Format (OpenOffice/LibreOffice).

For reasons of stability and performance, MailStore Server processes the following file types directly, regardless of the IFilter drivers that are installed:

  • Text files (TXT)
  • HTML files (HTM and HTML)
  • PDF files (PDF)

Archive Access

The Archive Access tab provides access to the service provider archive access as well as download links for MailStore Client and MailStore Outlook Add-in.

Please note: Details about the logon process for end customers can be found in the article End Customer Access.

Enable or Disable Service Provider Archive Access

Service provider archive access is only necessary if the administration of the instance is not done by the end customers or if the end customer requests support from the service provider. To enable or disable service provider archive access follow these instructions:

  • Log on to the Management Console.
  • Click General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Access tab.
  • Click either Enable or Disable
  • When enabling click OK to confirm that the service provider archive access really should be enabled.
    Please notice: Enabling the service provider archive access is logged in the audit log of the instance.

Using Service Provider Archive Access

Before the service provider archive access can be used, this access method must be enabled (see previous section) and the MailStore Client must be installed on the computer from where you want to connect.

  • Log on to the Management Console.
  • Click General > Instances.
  • Open the instance details by double-clicking on an instance in the list.
  • Click on the Archive Access tab.
  • Click Open MailStore Client
  • Depending on your web browser's settings further security related questions may appear.
  • Afterwards MailStore Client will automatically log on to the instance using the special $archiveadmin system account and a one-time password.

Inside the Instance

No matter whether logging on to an instance as the end customer's administrator or as service provider via service provider archive access, the available functions of the MailStore Client are always the same. Only email content preview is always blocked for the $archiveadmin user.

As each instance of the MailStore Service Provider Edition has the same capabilities in terms of managing users, archiving and exporting email, etc. the instructions from the MailStore Server Help also apply to instances.

Therefore no further documentation is provided here.

As MailStore Service Provider Edition's development is currently ahead of MailStore Server's, please understand that certain features like scheduling of server side archiving profiles may work slightly different than described in the MailStore Server Help. This differences will remain until the next major release of MailStore Server. Please do not hesitate to contact our support if you have further questions regarding these differences.

Live Statistics

The Live Statistics tab shows real time graphics about the instance activity such as I/O, memory and CPU usage as well as number of Remote Procedure Calls (RPC) and the number of emails verified and archived by the instance's archiving mechanism.