Management Console - Infrastructure - Revision history

Ltalaschus: /* Adding New Client Access Servers */

2021-01-15T14:23:31Z

Adding New Client Access Servers

Ltalaschus: /* Adding New Instance Hosts */

2021-01-15T14:21:15Z

Adding New Instance Hosts

Dweuthen: /* Client Access Servers */

2017-03-23T16:44:19Z

Client Access Servers

Dweuthen: /* Removing Instance Hosts */

2017-03-23T16:44:03Z

Removing Instance Hosts

Dweuthen: /* Configuring Instance Hosts */

2017-03-23T16:43:58Z

Configuring Instance Hosts

Dweuthen: /* Instance Hosts */

2017-03-23T16:43:02Z

Instance Hosts

Dweuthen at 10:40, 1 July 2014

2014-07-01T10:40:32Z

Admin: /* Adding New Client Access Servers */

2014-01-22T17:02:16Z

Adding New Client Access Servers

New page

__NOTOC__

Additionally to the Management Server a MailStore Service Provider Edition infrastructure consist of one or more Instance Hosts and Client Access Servers. Management of Instance Hosts and Client Access Server is done in the ''Infrastructure'' section of the Management Console.

= Instance Hosts =

The ''Instance Hosts'' page shows a list of available Instance Hosts that are registered in the Management Server.

== Adding New Instance Hosts ==

New Instance Hosts can be added to the MailStore Service Provider Edition either by pairing via the MailStore Service Provider Edition Configuration tool as described in [[Multi Server Mode Setup]] or manually as described in the following:

* [[Management Console#Logging On|Log on]] to the Management Console.
* Click on ''Infrastructure'' > ''Instance Hosts''.
* Click ''Add Instance Host''.
* Fill out the ''Instance Host Configuration'' form:
*: [[File:ms_spe_add_ih_01.png|center]]
:* '''Server Name:''' Must match the fully qualified host name of the Instance Host server.
:* '''Port:''' The TCP port on which the Instance Host listens for incoming connection from the Management Server and Client Access Servers (default: 8472)
:* '''Thumbprint:''' The SSL thumbprint of the certificate used by the Instance Host to identify itself. Execute the ''Management API'' command ''GetServiceStatus'' and search for the item which has <tt>"serverType" : "managementServer"</tt> set. The thumbprint value can be found in the ''serverCertificate'' key of the item.
:* '''Base Directory:''' Default directory for all newly created instances on the Instance Host. Can be overwritten individually for each new instance.
* Click ''OK'' to add the new Instance Host or ''Cancel'' to abort.

== Configuring Instance Hosts ==

* [[Management Console#Logging On|Log on]] to the Management Console.
* Click on ''Infrastructure'' > ''Instance Hosts''.
* Select the Instance Host to be modified from the list.
* Click on ''Commands'' > ''Configure..''
* Change one or more of the following setting in the ''Instance Host Configuration'' dialog:
:* '''Port:''' The TCP port on which the Instance Host listens for incoming connection from the Management Server and Client Access Servers (default: 8472)
:* '''Thumbprint:''' The SSL thumbprint of the certificate used by the Instance Host to identify itself. Execute the ''Management API'' command ''GetServiceStatus'' and search for the item which has <tt>"serverType" : "managementServer"</tt> set. The thumbprint value can be found in the ''serverCertificate'' key of the item.
:* '''Base Directory:''' Default directory for all newly created instances on the Instance Host. Can be overwritten individually for each new instance.
* Click ''OK'' to save changes or ''Cancel'' to discard.

== Removing Instance Hosts ==

In case an Instance Host should be removed from the MailStore Service Provider Edition environment, proceed as follows:

* [[Management Console#Logging On|Log on]] to the Management Console.
* Click on ''Infrastructure'' > ''Instance Hosts''.
* Select the Instance Host to be removed from the list.
* Click on ''Commands'' > ''Remove''
* Click ''OK'' to confirm the deletion of Instance Host or ''Cancel'' to abort.

= Client Access Servers =

The ''Client Access Servers'' page shows a list of available Client Access Server that are registered in the Management Server. Additionally the current status of the network services provided by the Client Access Servers are shown.

== Adding New Client Access Servers ==

New Client Access Server can be added to the MailStore Service Provider Edition either by pairing via the MailStore Service Provider Edition Configuration tool as described in [[Multi Server Mode Setup]] or manually as described in the following:

* [[Management Console#Logging On|Log on]] to the Management Console.
* Click on ''Infrastructure'' > ''Client Access Servers''.
* Click ''Add Client Access Server''.
* Fill out the ''Client Access Server Configuration'' form
*: [[File:ms_spe_add_cas_01.png|center]]
:* '''Server Name:''' Must match the fully qualified host name of the Client Access Server's server.
:* '''Port:''' The TCP port on which the Client Access Server listens for incoming connection from the Management Server (default: 8473)
:* '''Thumbprint:''' The SSL thumbprint of the certificate used by the Client Access Server to identify itself. Use the MailStore Service Provider Edition Configuration tool on the Client Access Server to retrieve the thumbprint from the ''TCP Server Certificate'' field.
* Click ''OK'' to add the Client Access Server or ''Cancel'' to abort.

== Configuring Client Access Servers ==

* [[Management Console#Logging On|Log on]] to the Management Console.
* Click on ''Infrastructure'' > ''Client Access Servers''.
* Select the Client Access Server to be modified from the list.
* Click on ''Commands'' > ''Configure..''.
* Change one or more of the following setting in the ''Client Access Server Configuration'' dialog:
:* '''Port:''' The TCP port on which the Client Access Server listens for incoming connection from the Management Server (default: 8473)
:* '''Thumbprint:''' The SSL thumbprint of the certificate used by the Client Access Server to identify itself. Use the MailStore Service Provider Edition Configuration tool on the Client Access Server to retrieve the thumbprint from the ''TCP Server Certificate'' field.
* Click ''OK'' to save changes or ''Cancel'' to discard.

== Removing Client Access Servers ==

In case a Client Access Server should be removed from the MailStore Service Provider Edition environment, proceed as follows:

* [[Management Console#Logging On|Log on]] to the Management Console.
* Click on ''Infrastructure'' > ''Client Access Servers''.
* Select the Client Access Server to be removed.
* Click ''Commands'' > ''Remove''.
* Click ''OK'' to confirm the deletion of the Client Access Server or ''Cancel'' to abort.

@@ Line 53: / Line 53: @@
 :* '''Server Name:''' Must match the fully qualified host name of the Client Access Server's server.
 :* '''Port:''' The TCP port on which the Client Access Server listens for incoming connection from the Management Server (default: 8473)
-:* '''Thumbprint:''' The SSL thumbprint of the certificate used by the Client Access Server to identify itself. Use the MailStore Service Provider Edition Configuration tool on the Client Access Server to retrieve the thumbprint from the ''TCP Server Certificate'' field.
+:* '''Thumbprint:''' The thumbprint of the TLS certificate used by the Client Access Server to identify itself. To get the certificate thumbprint, open the MailStore Service Provider Edition Configuration tool on the computer where the Client Access Servers role is installed, open the configuration of the role and copy the thumbprint from the ''Certificate'' field in the ''Client Access Server'' section.
 * Click ''OK'' to add the Client Access Server or ''Cancel'' to abort.

@@ Line 16: / Line 16: @@
 :* '''Server Name:''' Must match the fully qualified host name of the Instance Host server.
 :* '''Port:''' The TCP port on which the Instance Host listens for incoming connection from the Management Server and Client Access Servers (default: 8472)
-:* '''Thumbprint:''' The SSL thumbprint of the certificate used by the Instance Host to identify itself. Execute the ''Management API'' command ''GetServiceStatus'' and search for the item which has <tt>"serverType" : "managementServer"</tt> set. The thumbprint value can be found in the ''serverCertificate'' key of the item.
+:* '''Thumbprint:''' The thumbprint of the TLS certificate used by the Instance Host to identify itself. To get the certificate, open the MailStore Service Provider Edition Configuration tool on the computer where the Instance Host role is installed, open the configuration of the role and copy the thumbprint from the ''Certificate'' field.
 :* '''Base Directory:''' Default directory for all newly created instances on the  Instance Host. Can be overwritten individually for each new instance.
 * Click ''OK'' to add the new Instance Host or ''Cancel'' to abort.

@@ Line 46: / Line 46: @@
 New Client Access Server can be added to the MailStore Service Provider Edition either by pairing via the MailStore Service Provider Edition Configuration tool as described in [[Multi Server Mode Setup]] or manually as described in the following:
-* [[Management Console#Logging On|Log on]] to the Management Console.
+* [[Management Console - Logging On|Log on]] to the Management Console.
 * Click on ''Infrastructure'' > ''Client Access Servers''.
 * Click ''Add Client Access Server''.
@@ Line 57: / Line 57: @@
 === Configuring Client Access Servers ===
-* [[Management Console#Logging On|Log on]] to the Management Console.
+* [[Management Console - Logging On|Log on]] to the Management Console.
 * Click on ''Infrastructure'' > ''Client Access Servers''.
 * Select the Client Access Server to be modified from the list.
@@ Line 69: / Line 69: @@
 In case a Client Access Server should be removed from the MailStore Service Provider Edition environment, proceed as follows:
-* [[Management Console#Logging On|Log on]] to the Management Console.
+* [[Management Console - Logging On|Log on]] to the Management Console.
 * Click on ''Infrastructure'' > ''Client Access Servers''.
 * Select the Client Access Server to be removed.
 * Click ''Commands'' > ''Remove''.
 * Click ''OK'' to confirm the deletion of the Client Access Server or ''Cancel'' to abort.

@@ Line 34: / Line 34: @@
 In case an Instance Host should be removed from the MailStore Service Provider Edition environment, proceed as follows:
-* [[Management Console#Logging On|Log on]] to the Management Console.
+* [[Management Console - Logging On|Log on]] to the Management Console.
 * Click on ''Infrastructure'' > ''Instance Hosts''.
 * Select the Instance Host to be removed from the list.

@@ Line 3: / Line 3: @@
 Additionally to the Management Server a MailStore Service Provider Edition infrastructure consist of one or more Instance Hosts and Client Access Servers. Management of Instance Hosts and Client Access Server is done in the ''Infrastructure'' section of the Management Console.
-= Instance Hosts =
+== Instance Hosts ==
 The ''Instance Hosts'' page shows a list of available Instance Hosts that are registered in the Management Server.
-== Adding New Instance Hosts ==
+=== Adding New Instance Hosts ===
 New Instance Hosts can be added to the MailStore Service Provider Edition either by pairing via the MailStore Service Provider Edition Configuration tool as described in [[Multi Server Mode Setup]] or manually as described in the following:
@@ Line 22: / Line 20: @@
 * Click ''OK'' to add the new Instance Host or ''Cancel'' to abort.
-== Configuring Instance Hosts ==
+=== Configuring Instance Hosts ===
 * [[Management Console#Logging On|Log on]] to the Management Console.
 * Click on ''Infrastructure'' > ''Instance Hosts''.
@@ Line 34: / Line 31: @@
 * Click ''OK'' to save changes or ''Cancel'' to discard.
-== Removing Instance Hosts ==
+=== Removing Instance Hosts ===
 In case an Instance Host should be removed from the MailStore Service Provider Edition environment, proceed as follows:
@@ Line 44: / Line 40: @@
 * Click ''OK'' to confirm the deletion of Instance Host or ''Cancel'' to abort.
-= Client Access Servers =
+== Client Access Servers ==
 The ''Client Access Servers'' page shows a list of available Client Access Server that are registered in the Management Server. Additionally the current status of the network services provided by the Client Access Servers are shown.
-== Adding New Client Access Servers ==
+=== Adding New Client Access Servers ===
 New Client Access Server can be added to the MailStore Service Provider Edition either by pairing via the MailStore Service Provider Edition Configuration tool as described in [[Multi Server Mode Setup]] or manually as described in the following:
@@ Line 62: / Line 56: @@
 * Click ''OK'' to add the Client Access Server or ''Cancel'' to abort.
-== Configuring Client Access Servers ==
+=== Configuring Client Access Servers ===
 * [[Management Console#Logging On|Log on]] to the Management Console.
 * Click on ''Infrastructure'' > ''Client Access Servers''.
@@ Line 73: / Line 66: @@
 * Click ''OK'' to save changes or ''Cancel'' to discard.
-== Removing Client Access Servers ==
+=== Removing Client Access Servers ===
 In case a Client Access Server should be removed from the MailStore Service Provider Edition environment, proceed as follows: