The Exclaimer Mail Archiver Outlook Add-In allows users to easily search, view and restore messages from your email archive using Microsoft Outlook.

System Requirements

Software

ComponentRequirement
Operating Systems
  • Windows Vista x86 and x64 (SP2 and above)
  • Windows 7 x86 and x64 (SP1 and above)
  • Windows 8 x86 and x64
  • Windows 8.1 x86 and x64
  • Windows 10 x86 and x64
Microsoft .NET FrameworkMicrosoft .Net Framework 4.5.2 and above
Microsoft Outlook

Installation Files

The Exclaimer Mail Archiver Outlook Add-In has two installers:
  • MailArchiverOutlookAddIn64.msi (for 64-bit computers).
  • MailArchiverOutlookAddIn32.msi (for 32-bit computers).
These files are included as part of the main Exclaimer Mail Archiver installation and can be found in the Exclaimer Mail Archiver folder (the default folder is c:\program files\exclaimer ltd\mailarchiver).


Copy these files to a network share that can be accessed by all required computers within your organization.


Note: If you are installing the software on a 64-bit operating system that has a 32-bit version of Microsoft Outlook, you should use the MailArchiverOutlookAddIn64.msi package.


Deployment Preparation

To deploy the Exclaimer Mail Archiver Outlook Add-In, you must have first installed and configured Exclaimer Mail Archiver.


To use features such as viewing and restoring messages, you must have completed the following tasks within Exclaimer Mail Archiver (i.e. on the Exclaimer Mail Archiver server):

  • Run the Exchange Mailbox Access Account Wizard. Please refer to the Mail Archiver Settings section of the User Guide for Exclaimer Mail Archiver.
  • Set the Enable Restore To Mailbox option to ‘enabled’ in Mail Archiver Settings. Please refer to the Mail Archiver Settings section of the User Guide for Exclaimer Mail Archiver
Once these tasks have been completed, you can install the Add-In manually or by using a Group Policy.


Installing the Add-In manually

To install the Exclaimer Mail Archiver Outlook Add-In manually, perform the following steps on each required computer (you will require local administrator rights to complete the installation):

  1. Click Start and then Run.
  2. Type cmd and then click OK.
  3. Change into the directory where MSI files were copied (see the Installation Files section above).
  4. For 64-bit systems, run the MSI package by entering the following command:
  5. msiexec /i MailArchiverOutlookAddIn64.msi MAWEBSITEURL=http://servername:port
    
    -or-

    For 32-bit systems: Run the MSI package by entering the following command:


    msiexec /i MailArchiverOutlookAddIn32.msi MAWEBSITEURL=http://servername:port
    
    Note: The parameter “MAWEBSITEURL” is case-sensitive. Replace servername:port with the server name and port of the website used for Exclaimer Mail Archiver. The default port used is 53444.

Installing the Add-In using Group Policy

In a typical Active Directory environment, deployment through Group Policy is the fastest way to install the Exclaimer Mail Archiver Outlook Add-In without needing to manually install the software on each computer within your organization. To do this, complete steps detailed in the following sections:



  1. Generate an MST File for your environment
  2. Build a WMI Filter for x86 Computers
  3. Build a WMI Filter for x64 Computers
  4. Create a Group Policy for x86 Computers
  5. Create a Group Policy for x64 Computers

Having completed these steps, the Group Policy is built and deployed to all computers within your organization. The Exclaimer Mail Archiver Outlook Add-In will be installed automatically when the Group Policy is applied (by default every 90 minutes) and the computer is next rebooted. However, if required you can force the update to take effect immediately on a computer.

Note: To perform these steps you will need access to the Group Policy Editor and Orca. Orca is freely available from Microsoft as part of the Windows SDK.


Generate an MST File for your environment

In order to install the Add-in you must provide a parameter which specifies the Archiver webserver URL and its associated port number. When installing the MSI manually this is done as a parameter on the command line. When deploying via Group Policy this parameter can only be specified inside an associated MST file.



The process below creates this MST file. By using it with the MSI file, Group Policy will automatically and silently install and configure the Outlook Add-In ready for use on computers in your organization.

  1. Ensure that MailArchiverOutlookAddIn32.MSI and MailArchiverOutlookAddIn64.MSI files have been copied to a shared network location that is accessible by all computers with in your organization.
  2. Click Start > All Programs > Orca.
  3. Click File > Open.
  4. Open MailArchiverOutlookAddIn32.MSI.
  5. Click Transform > New Transform.
  6. From the list of Tables on the left, click Property. A list of properties is displayed in the left-hand pane:

  7. Right-click under the list of properties and choose Add Row. The Add Row dialog is displayed - from here:

    1. Enter the Property as MAWEBSITEURL (this is case sensitive).
    2. Enter the Value as http://servername:port. Replace servername:port with the server name and port of the website that is used for Exclaimer Mail Archiver. The default port used is 53444:

    3. Click OK to close the Add Row dialog.
    4. Click Transform > Generate Transform... to display the Save Transform As dialog. Save the MST file to the same location as the MSI files that you copied in step 1.
    5. Click File > Exit to close Orca.

    Note: The same MST file is used for both 32 and 64 bit installers.

Build a WMI Filter for x86 Computers

This section only applies if you are deploying the Add-In to a mixture of 32-bit and 64-bit computers and is required for the group policy to identify the correct version of the Add-In for each computer. The steps below are required to identify the 32-bit computers in your organization and ensures the correct 32-bit Add-In is installed on them.

  1. Click Start > Administrative Tools > Group Policy Management.
  2. Expand the tree and select WMI Filters:

  3. In the Contents pane on the right-hand side, right-click and select New... to display the New WMI Filter dialog. From here:
    1. Enter the Name as x86 Computers.
    2. If required, enter a description for this filter.
    3. Click Add to display the WMI Query dialog.
    4. Ensure that the Namespace is root\CIMv2.
    5. Enter the Query as: Select * from Win32_Processor where AddressWidth = '32'. This is shown below:

    6. Click OK to close the WMI Query dialog.
    7. Click Save to close the New WMI Filter dialog:

Build a WMI Filter for x64 Computers

This section only applies if you are deploying the Add-In to a mixture of 32-bit and 64-bit computers and is required for the group policy to identify the correct version of the Add-In for each computer. The steps below are required to identify the 64-bit computers in your organization and ensures the correct 64-bit Add-In is installed on them.

  1. Access the WMI Filters branch of the Group Policy Management tree (click Start > Administrative Tools > Group Policy Management if you are not already working within this tree).
  2. In the Contents pane on the right-hand side, right-click and select New... to display the New WMI Filter dialog. From here:
    1. Enter the Name as x64 Computers.
    2. If required, enter a description for this filter.
    3. Click Add to display the WMI Query dialog.
    4. Ensure that the Namespace is root\CIMv2.
    5. Enter the Query as: Select * from Win32_Processor where AddressWidth = '64'. This is shown below:


    6. Click OK to close the WMI Query dialog.
    7. Click Save to close the New WMI Filter dialog:

Create a Group Policy for x86 Computers

These steps are required if you have 32-bit computers in your organization. This step links the filter for 32-bit computers you created earlier with the 32-bit MSI file.

  1. From the left-hand side of the Group Policy Management tree, right-click your domain branch (click Start > Administrative Tools > Group Policy Management if you are not already working within this tree).
  2. Select Create a GPO in this domain, and Link it here... as shown below:


  3. The New GPO dialog is displayed. From here:

    1. Enter the name as Mail Archiver Add-In x86.
    2. Click OK.
  4. A new Group Policy Object named Mail Archiver Add-In x86 is now shown in the tree on the left-hand side. Right-click this object and select Edit... as shown below:


  5. From here:


    1. The Group Policy Management Editor window is displayed.
    2. From the tree on the left-hand side, expand the Mail Archiver Add-in x86 branch and then drill down to Computer Configuration > Policies > Software Settings and select Software installation:


    3. In the pane on the right-hand side, right-click and select New > Package... to display the Open dialog.
    4. Navigate to the network share where you placed the MSI files (see the Installation Files section) and double-click MailArchiverOutlookAddIn32.msi. The Deploy Software dialog is displayed.
    5. Choose Advanced and click OK. After a few seconds the Exclaimer Mail Archiver Outlook Add-In Properties dialog is displayed. From here:
      • Select the Modifications tab.
      • Click Add.
      • Navigate to the directory where the MSI files are located and double-click the MST file you created in earlier.
      • Click OK to close the Exclaimer Mail Archiver Outlook Add-In Properties dialog.
    6. Close the Group Policy Management Editor.

Create a Group Policy for x64 Computers

These steps are required if you have 64-bit computers in your organization. This step links the filter for 64-bit computers you created earlier with the 64-bit MSI file.

  1. From the left-hand side of the Group Policy Management tree, right-click your domain branch (click Start > Administrative Tools > Group Policy Management if you are not already working within this tree).
  2. Select Create a GPO in this domain, and Link it here... as shown below:


  3. The New GPO dialog is displayed. From here:

    1. Enter the name as Mail Archiver Add-In x64.
    2. Click OK.
  4. A new Group Policy Object named Mail Archiver Add-In x64 is now shown in the tree on the left-hand side. Right-click this object and select Edit... as shown below:


  5. From here:

    1. The Group Policy Management Editor window is displayed.
    2. From the tree on the left-hand side, expand the Mail Archiver Add-in x64 branch and then drill down to Computer Configuration > Policies > Software Settings and select Software installation:


    3. In the pane on the right-hand side, right-click and select New > Package... to display the Open dialog.
    4. Navigate to the network share where you placed the MSI files (see the Installation Files section) and double-click MailArchiverOutlookAddIn64.msi. The Deploy Software dialog is displayed.
    5. Choose Advanced and click OK. After a few seconds the Exclaimer Mail Archiver Outlook Add-In Properties dialog is displayed. From here:

      • Select the Modifications tab.
      • Click Add.
      • Navigate to the directory where the MSI files are located and double-click the MST file you created in earlier.
      • Click OK to close the Exclaimer Mail Archiver Outlook Add-In Properties dialog.
    6. Close the Group Policy Management Editor.

Applying the Group Policy

The Group Policy is now built and deployed to all computers within your organization. The software will be installed automatically when the Group Policy is applied (by default every 90 minutes) and the computer is next rebooted. If you wish to force the update to take effect immediately on a particular computer, follow the steps below.

  1. Click Start and then Run.
  2. Enter gpupdate /force and then click OK.
  3. You will be prompted to restart the computer. Enter Y (Yes) and the computer restarts. The Exclaimer Mail Archiver Outlook Add-In is installed when the computer restarts.

Additional Information

Allowing Users to Change the Mail Archiver Add-in Username

When a user logs in to the Mail Archiver add-in using Outlook, their username is set to the primary email address of the default mail account in their Outlook profile. By default, they are unable to change the username. However, if users have multiple email accounts, or need to use a different username, you can add a registry setting to allow the users to change the username manually. To achieve this, follow the steps below on each client computer.

Note: These instructions involve making a change to the Windows Registry. We strongly advise that you complete a backup of the Windows Registry before to following these steps.

  1. Click Start and then Run.
  2. Enter regedit and click OK to open the Registry Editor.
  3. Expand the tree in the left-hand pane and navigate to the appropriate path below:

    For 64-bit Windows with 32-bit Outlook:

    HKEY_LOCAL_MACHINE\Software\Wow6432Node\Exclaimer Ltd\Mail Archiver 1.0\OutlookAddIn
    For example:



    For 32-bit Windows, or 64-bit Outlook:
    HKEY_LOCAL_MACHINE\Software\Exclaimer Ltd\Mail Archiver 1.0\OutlookAddIn
    For example:



    Note: If the required path does not exist, you should create it.
  4. In the right-hand pane, right-click and select New > DWORD (32-bit) Value:

  5. Enter the name as EnableUsernameEditing.
  6. Double-click the property to change its value and set the value to 1:

  7. Click OK to close the Edit DWORD (32-bit) Value dialog.
  8. Click File and then Exit to close the Registry Editor.
  9. Restart Microsoft Outlook.
  10. Go to the Mail Archiver add-in in Outlook, and click Sign Out.
  11. Click Search and the login prompt is displayed. The user can now enter a different username:

Allowing users to change the Mail Archiver URL

By default, when a user selects the Settings button from the Exclaimer Mail Archiver Outlook Add-In, they are unable to enter a custom URL - it is fixed to the URL used when the Add-In was installed. However, if you have multiple Mail Archiver servers, you may wish to allow users to change the URL manually. To achieve this, follow the steps below on each client computer (these steps apply to the logged on user only).

Note: These instructions involve making a change to the Windows Registry. We strongly advise that you complete a backup of the Windows Registry before to following these steps.

  1. Click Start and then Run.
  2. Enter regedit and click OK to open the Registry Editor.
  3. Expand the tree in the left-hand pane to the path:

    HKEY_CURRENT_USER\Software\Exclaimer Ltd\Mail Archiver 1.0\OutlookAddIn

  4. In the right-hand pane, right-click and select New > DWORD (32-bit) Value:

  5. Enter the name as EnableChangeURL.
  6. Double-click the property to change its value and set the value to 1:


  7. Click OK to close the Edit DWORD (32-bit) Value dialog.
  8. Click File and then Exit to close the Registry Editor.
  9. Restart Microsoft Outlook.
  10. Click the Settings button from the Mail Archiver area. The user can now change the URL:

Upgrading

Upgrading can be achieved by deploying a newer version of the MSI.


You do not need to uninstall the current version of the Exclaimer Mail Archiver Outlook Add-In to install a newer version - the newer version will automatically uninstall the older version during the installation process.


If the Mail Archiver name changes

If the name of your Mail Archiver server changes (for example, if you replace the physical server) then you simply need to re-deploy the same MSI with the new address. This will update the address on the client computers in your organization.

How To Mail Archiver