Microsoft Outlook Add-in Install Guide

The Microsoft Outlook Add-in allows you to access your Mailsphere profile from within your local copy of Microsoft Outlook.  This offers support for both Outlook 2010, 2013, 2016 & 2019.

The latest version can be downloaded using the following link:

https://s3-eu-west-1.amazonaws.com/mailsphere-outlook-addin/Mailsphere.OutlookAddinSetup.msi

What are the benefits?

The Mailsphere Outlook Addin provides direct access from your local instance of Microsoft Outlook into the powerful search facility of your Mailsphere personal archive.

For too long email archives have been treated as a necessity of regulation or a precaution in case of a disaster with the email system.  At Mailsphere we see the email archive as a valuable storage of your companies most well used communication tool.  The Mailsphere Outlook Addin allows you to quickly search the archive to find the content that will help you answer the latest customer query or colleague request.

Installation Guide

Installation Guide

The Mailsphere Outlook Addin comes in a MSI windows installer package. This can be easily installed locally, simply by double clicking the package, or by your Windows administrator.

If your Windows environment is maintained by a Windows administrator we recommend seeking their advice before proceeding.

Pre-requisites

Pre-requisites

Please ensure that you have Microsoft .NET Framework 4.5.1 or above installed.  Below is a link to this free distributable from Microsoft:

http://www.microsoft.com/en-gb/download/details.aspx?id=42643

When you run the installation package please close Microsoft Outlook so the Addin can be applied.

Successful Installation

Successful Installation

The installation package will take you through a simple step by step process. Unless you have specific reasons we recommend proceeding with the default options.  On completion you will see the screen above.

Note: we recommend ensuring all critical Windows updates are applied to keep your system secure.

Installing an MSI via the command line

To run thin installation of the Outlook Addin MSI manually:

msiexec /i filename.msi

and without restarting Windows:

msiexec /i filename.msi /norestart

To run all silently:

msiexec /i filename.msi /quiet /qn /norestart

Group Policy deployment

The first step in deploying a MSI through GPO is to create a distribution point on the publishing server. This can be done by following these steps:

  • log on to the server as an Administrator user
  • create a shared network folder (this folder will contain the MSI package)
  • set permissions on this folder in order to allow access to the distribution package
  • copy the MSI in the shared folder

Create a Group Policy Object

A MSI package is deployed (distributed) through GPO as a Group Policy Object. In order to create an object for your package, you can follow these steps:

  • click on the Start button, go to Programs, select Administrative Tools and then select Active Directory Users and Computers
  • right-click your domain name in the console tree and select the Properties context menu
  • select the Group Policy tab and click New
  • set the name of the policy (for example MailsphereAddin)
  • click Properties and select the Security tab
  • check the Apply Group Policy checkbox only for the groups to which the policy will be applied
  • click on the OK button

Assign a MSI package

A package can be assigned per-user or per-machine. Also, if the package is assigned, it will automatically be installed silently. In order to assign a package you can follow these steps:

  • click on the Start button, go to Programs, select Administrative Tools and then select Active Directory Users and Computers
  • right-click your domain name in the console tree and select the Properties context menu
  • go to the Group Policy tab, select the object you want and click Edit
  • expand Software Settings under Computer Configuration
  • right-click Software Installation, select the New context menu and then click on Package
  • in the Open dialog type the full UNC path of the shared package you want to assign
  • click on the Open button
  • click on Assigned and then click OK (the package will be added to the right pane of the "Group Policy" window)
  • close the Group Policy snap-in, click OK and exit the Active Directory Users and Computers snap-in
  • when the client computers start, the assigned package will be installed automatically

Note: Do not use the Browse button in the Open dialog to access the UNC location. Make sure that you use the UNC path to the shared package.

Uninstall an MSI via the command prompt

To run thin installation of the Outlook Addin MSI manually:

msiexec /x filename.msi

and without restarting Windows:

msiexec /x filename.msi /norestart

To run all silently:

msiexec /x filename.msi /quiet /qn /norestart