Difference between revisions of "MailStore Outlook Add-in Deployment"

[unchecked revision]

[checked revision]

Latest revision as of 14:59, 15 July 2020

A MailStore Server installation includes the MailStore Outlook Add-in as a Windows Installer package (MSI) that can be installed on client machines using software distribution. You can either find the MSI package via the link on your desktop Install MailStore Client on other Computers or in the Setup-<version> folder of your MailStore Server installation folder.

This article describes the distribution and configuration of MailStore Outlook Add-in through Active Directory group policies.

Installation

To distribute the MailStore Outlook Add-in via Active Directory you have to copy its MSI package to a share on your server that is accessible to all domain users. After the distribution has been set up the MailStore Outlook Add-in will be installed automatically upon the next user login. This process is transparent to users and needs no interaction on their behalf.

Set up the software distribution as follows:

Open the Group Policy Management Console on your domain controller.
Right-click on the administrative folder Group Policy Objects
Select New and create a new group policy object called MailStore Outlook Add-in Deployment.
Right-click on the new GPO and select Edit....
Expand User Configuration > Policies > Software Settings.
Right-click on Software installation.
Select New and Package....
Select the above mentioned MSI package. Please note that the path for the file must be entered in UNC notation (e.g. \\Server\Setup\MailStoreSetup...) and that domain users need to have read-access to this share.
In the following dialog window, select Advanced and click OK.
On the next screen, please set the options on the Deployment tab as shown below:
Click on OK to confirm all settings.
The group policy should look similar to the one shown below:
Close the group policy editor.

The group policy is now configured and can be linked to the corresponding user objects. Linking is done using organizational units (OU).

Highlight the organizational unit (OU) which contains the desired user objects, right-click on the OU (Seattle in the example below) and select the option Link an Existing GPO....
In the dialog window Select GPO, highlight MailStore Outlook Add-in Deployment and click on OK.
Through the organizational unit the group policy is now linked to the user objects contained therein. It will become active the next time users log on to the Windows clients.

Please note: To avoid problems when installing software using group policies, the following settings should be applied via group policy for computer objects which represent the Windows Outlook Add-ins of MailStore users:

Computer Configuration > Policies > Administrative Templates > System > Scripts > Run logon scripts synchronously
Computer Configuration > Policies > Administrative Templates > System > Logon > Always wait for the network at computer startup and logon

Updating

The MailStore Outlook Add-in can be updated automatically on the MailStore user computers through group policies. To edit an existing MailStore Outlook Add-in Deployment group policy so that an automatic update of the Outlook Add-ins can be performed, please proceed as follows:

Open the Group Policy Management Console on your domain controller.
Navigate to the administrative folder Group Policy Objects.
Right-click on the existing MailStore Outlook Add-in Deployment GPO and select Edit....
Expand User Configuration > Policies > Software Settings.
Right-click on Software installation.
Select New and Package....
Select the updated MailStore Outlook Add-in MSI package. Please note that the path for the file must be entered in UNC notation (e.g. \\Server\Setup\MailStoreSetup...) and that domain users need to have read-access to this share.
In the following dialog window, select Advanced and click OK.
On the next screen, please set the options on the Deployment tab as shown below:
On the Upgrades tab, a list of upgradeable packages is shown. Select the option Required upgrade for existing packages.
Click on OK to confirm all settings.
The group policy should look similar to the one shown below:

The MailStore Outlook Add-in will be updated upon the next login of the users on their Windows workstations.

Configuration

If Mailstore Server is used within an Active Directory infrastructure, the MailStore Client and the MailStore Outlook Add-in can be configured using group policies. Settings that are configured through group policies supersede local settings and cannot be changed by users.

For this purpose, group policy templates are available as ADMX files (for Windows 7 SP1 and Windows Server 2008 R2 or higher).

Installing the ADMX Template

Group policy templates can either be managed locally on an administrative workstation or centrally in the domain. Please refer to Microsoft Technet for further details.

Installation of the ADMX Templates in the Local Store

Download the ADMX templates to your administrative workstation.
Unzip the package to %systemroot%, retaining its folder structure.

Installation of the ADMX Templates in the Central Store

Please note: Use this method only, if you are already using a central store for group policies, else group policies stored in the local store are not accessible anymore.

Download the ADMX templates to your domain controller.
In the SYSVOL folder, unzip the package to domain\policies, retaining its folder structure (default: %systemroot%\sysvol\domain\policies).

To verify the installation and for further configuration, please proceed as follows:

Open the Group Policy Management Console.
Right-click on the administrative folder Group Policy Objects.
Select New and create a new group policy object called MailStore Outlook Add-in Settings.
Right-click on the new GPO and select Edit....
Expand User Configuration > Policies > Administrative Templates.
If the templates have been installed correctly, an entry MailStore and sub-entries MailStore Client and MailStore Outlook-Add-in exist.

Configuring Policy Settings

Open the Group Policy Management Console.
Right-click on the administrative folder Group Policy Objects.
Right-click on the existing group policy object called MailStore Outlook Add-in Settings and select Edit....
Expand User Configuration > Policies > Administrative Templates > MailStore > MailStore Outlook Add-in.

These settings supported by the current Outlook Add-in are available:
- Authentication
  Sets the authentication method to either Standard Authentication or Windows Authentication. When the authentication method is set to Windows Authentication then the Server Name also must be set.
- Language
  Sets the display language of the MailStore Outlook Add-in. Select System language to have the MailStore Outlook Add-in use the language of a client's operating system.
- Server Name
  If this parameter is provided, the MailStore Outlook Add-in always connects to this server. If the authentication method has also been set to Windows Authentication, the login to MailStore Server occurs directly without any user interaction (Single Sign On). If the MailStore Web Access has been configured to a port different from the default 8462 (HTTPS), this parameter has to be provided as Server Name:Port.
- Show MailStore Outlook Add-in Toolbar by default
  If this option is disabled explicitly, the MailStore Outlook Add-in toolbar is hidden in Outlook. This can be useful for certain user groups in terminal server environments.
- Date, Time or Number Format
  Sets the date, time or number format of the MailStore Outlook Add-in. If set to (System), the MailStore Outlook Add-in will use the client operating system's date, time or number format.

Applying Policy Settings

To apply these settings to users, the group policy has to be linked to the corresponding user objects. Linking is done using organizational units (OU).

Highlight the organizational unit (OU) which contains the desired user objects, right-click on the OU (Seattle in the example below) and select the option Link an Existing GPO....
In the dialog window Select GPO, highlight MailStore Outlook Add-in Settings and click on OK.
Through the organizational unit the group policy is now linked to the user objects contained therein. The settings will become active the next time users log on to the Windows clients.

Uninstalling

Just like the distribution, the uninstalling of software packages can be done using group policies. Please proceed as follows:

Open the Group Policy Management Console on your domain controller.
Navigate to the administrative folder Group Policy Objects.
Right-click on the existing MailStore Outlook Add-in Deployment GPO and select Edit....
Expand User Configuration > Policies > Software Settings > Software installation.
Right-click on the package to be uninstalled and select All Tasks > Remove...
In the following dialog window, select Immediately uninstall the software from users and computers and click OK.
Close all open windows and exit the group policy editor.

The MailStore Outlook Add-in will be uninstalled upon the next login of the users on their Windows workstations.

@@ Line 1: / Line 1: @@
-Using a software distribution system, MailStore Outlook Add-in can be distributed among the users' computers automatically. To be able to do so, the distribution system must be able to execute MailStore Outlook Add-in's setup program without requiring any input or confirmations.
+{{GPO Preamble|Outlook Add-in}}
-== Using Group Policies ==
+== Installation ==
-=== Installation ===
+{{GPO Installation|Outlook Add-in}}
-In addition to being installed manually, MailStore Outlook Add-in can also be distributed to all user computers using Active Directory. Once the distribution process is set up successfully, MailStore Outlook Add-in will be installed automatically when the user logs on. This process runs in the background and requires no action on part of the user. Immediately after the distribution, the user can use the MailStore Outlook Add-in as usual.
-Example: Setting up distribution in Windows Server 2003
+{{GPO Distribution|2019|Outlook Add-in}}
-* The MailStore Outlook Add-in MSI setup file is bundled with the MailStore Server installation. You can either find it via the link on your desktop ''Install MailStore Client on other Computers'' or in the Setup-<version> subfolder of your MailStore Server program folder.
+<div class="msnote">'''Please note:''' To avoid problems when installing software using group policies, the following settings should be applied via group policy for computer objects which represent the Windows Outlook Add-ins of MailStore users:
-* Save the download in a directory on the server that is shared and accessible to all users of the domain.
+* ''Computer Configuration > Policies > Administrative Templates > System > Scripts > Run logon scripts synchronously''
-* Open the Group Policy Management Console. If this is not available, download the installation routine under http://www.mailstore.com/?gpmc.
+* ''Computer Configuration > Policies > Administrative Templates > System > Logon > Always wait for the network at computer startup and logon''
-* Install the console.
+</div>
-* Open the group policy management console of the Windows server
-* Right-click on the administrative folder ''Group Policy Objects'', select ''New'' and create a new group policy object called ''MailStore Outlook Add-in Deployment''.
-*: [[File:Tech_client_01.png|center]]
-* Highlight the new object and click on ''Edit''. Expand User Configuration and Software Settings and right-click on ''Software installation''. Select ''New'' and ''Package...''
-*: [[File:tech_client_02.png|center]]
-* Select an MSI package. Please keep in mind that the path for the file must be entered in UNC notation (e.g. \\Server\Setup\MailStoreOutlookAddinSetup...) and that the users of the domain need to have read-access to this directory share.
-* In the following dialog window, select ''Advanced'' and click ''OK''.
-*: [[File:Tech_client_03.png|center]]
-* On the next screen, please select the settings as shown below:
-*: [[File:Tech_client_04_en.png|center]]
-* Click on ''OK'' to confirm all settings. The group policy should look similar to the one shown below:
-*: [[File:Tech_client_05_en.png|center|520px]]
-* Close the group policy editor. The group policy is now configured and can be linked to the corresponding user objects. Linking is done using organizational units (OU).
-* Highlight the organizational unit (OU) which contains the desired user objects, right-click on the OU (DE_Viersen in the example below) and select the option ''Link an existing GPO''. In the dialog window Select GPO, highlight ''MailStore Outlook Add-in Deployment'' and click on ''OK''.
-*: [[File:Tech_client_06.png|center|520px]]
-* The group policy is now available and becomes active the next time users log on to the Windows client.
-=== Updating ===
+== Updating ==
-With group policies, the MailStore Outlook Add-in software on the user machines can be updated automatically. To edit an existing MailStore Outlook Add-in deployment group policy so that an automatic update of the clients can be performed, please proceed as follows:
-* Open the existing group policy ''MailStore Outlook Add-in Deployment''. Create a new package and select the updated MailStore Outlook Add-in MSI file. In the following dialog window, select ''Advanced'' and click on ''OK''. Please select the settings as shown below:
+The MailStore Outlook Add-in can be updated automatically on the MailStore user computers through group policies. To edit an existing ''MailStore Outlook Add-in Deployment'' group policy so that an automatic update of the Outlook Add-ins can be performed, please proceed as follows:
-*: [[File:Tech_client_07_en.png|center]]
-* In the ''Updates''-tab, click on ''Add'' and select the software to be updated. Choose the settings as shown below and click on ''OK'' and confirm by clicking on ''OK'' again.
-*: [[File:Tech_client_08_en.png|center|520px]]
-* The group policy should look similar to the one in the following graphic:
-*: [[File:Tech_client_09_en.png|center|520px]]
-MailStore Outlook Add-in will be updated the next time users log on to their Windows workstations.
+{{GPO Update|2019|Outlook Add-in}}
-To avoid complications when installing software using group policies, the following settings for the MailStore Outlook Add-in Deployment group policy should be adjusted as well:
+The MailStore Outlook Add-in will be updated upon the next login of the users on their Windows workstations.
-* Activate ''Computer Configuration/Administrative Templates/System/Scripts\Run logon scripts synchronously''
+== Configuration ==
-* Activate ''Configuration/Administrative Templates/System/Logon\Always wait for the network at computer startup and logon''
-=== Configuration ===
+{{GPO Templates|2019|Outlook Add-in}}
-{{:Installation of Group Policy Template}}
+{{GPO Configuration|2019|Outlook Add-in}}
-'''Configuring MailStore Outlook Add-In'''
+== Uninstalling ==
-With the new MailStore Outlook Add-in, you can configure the way the add-in contacts the MailStore Server.
+{{GPO Uninstalling|Outlook Add-in}}
-[[File:ms_Outlook_Add-In_settings_01_en.png|center|350px]]
-* Show MailStore Toolbar in Outlook
-*: Here you define, whether the MailStore Outlook Add-in is shown or hidden by default. Possible values are ''activate'' or ''deactivate''.
-* Choose authentication method
-*:Here you define, which authentication method should be used for logins.
-*:Possible values are ''users choice'', ''Default Authentication'' or ''Windows Authentication''. ''Windows Authentication'' is only available in Active Directory environments.
-* Address of MailStore Server
-*:Here you set up the hostname or IP-address of your MailStore Server to which the clients should connect. Should MailStore Web Access configured to listen on other than the default ports (8461/8462), you need to add the port information to the hostname or IP-Address in the format '':port''.
-* Use SSL secured connection
-*:If you activate this option, the communication between the MailStore Outlook Add-in and your MailStore Server is SSL encrypted. Possible values are ''activated'' or ''deactivated''.<br /><br />'''Note:''' If you activate this option, no unencrypted communication is possible with you MailStore Server. You need to make sure, that encrypted communication to you MailStore Server is configured properly.
-=== Uninstalling ===
-==== For Each Installation Distributed Using Group Policies ====
-Like the distribution, the uninstalling of the software packages can be done using group policies. Please proceed as follows:
-* Open the group policy management console of your Windows server.
-* Expand the folder ''Group Policy Objects''.
-* Right-click on the group policy object which was created for the software distribution of MailStore and select ''Edit''.
-* Expand ''User Configuration | Software Settings | Software Installation''.
-* Right-click on the packet to be uninstalled and select ''All Tasks -> Delete...''
-: [[File:Ms_uninst_gp.png|center|550px]]
-* In the following dialog window, select ''Software sofort von Benutzern und Computern deinstallieren'' and click ''OK''.
-: [[File:Ms_uninst_gp_2.png|center|350px]]
-* Close all open windows and exit the group policy
-* The software will be uninstalled the next time the user logs on to the server.
-== Without using Group Policies ==
-Please refer to [http://technet.microsoft.com/library/cc759262(WS.10).aspx this Microsoft's TechNet article] to find more information about the Windows installer and msiexec's command line parameters.
 [[de:MailStore Outlook Add-In Deployment]]
 [[en:MailStore Outlook Add-in Deployment]]