Veritas Enterprise Vault™ Setting up the Enterprise Vault Office Mail App

Last Published:
Product(s): Enterprise Vault (12.1, 12.0, 11.0.1, 11.0, 10.0.4, 10.0.3)
  1. Setting up the Enterprise Vault Office Mail App
    1.  
      About Microsoft Office Mail App
    2. About the Enterprise Vault Office Mail App
      1.  
        Enterprise Vault Office Mail App features
    3.  
      Enterprise Vault Office Mail App policy settings and options
    4.  
      Initial configuration of HTTPS for use of the Enterprise Vault Office Mail App
    5. Deploying the Enterprise Vault Office Mail App
      1.  
        About the PowerShell cmdlets for Office Mail Apps
      2.  
        About deploying the Office Mail App with the New-App cmdlet
      3.  
        About New-App command parameters for the Enterprise Vault Office Mail App
      4.  
        Deploying the Enterprise Vault Office Mail App for an individual user
      5.  
        Deploying the Enterprise Vault Office Mail App for multiple users
      6.  
        About the Enterprise Vault Office Mail App after deployment for an individual user
      7.  
        Deploying the Enterprise Vault Office Mail App for an organization
      8.  
        About the Enterprise Vault Office Mail App after deployment for an organization
      9.  
        Mailbox synchronization after upgrade to enable use of the Office Mail App
    6.  
      Additional requirements on Enterprise Vault Office Mail App users' computers
    7.  
      Disabling and re-enabling the Enterprise Vault Office Mail App for a device type
    8.  
      Removing, disabling, and re-enabling the Enterprise Vault Office Mail App for a user or an organization
    9. Troubleshooting the Enterprise Vault Office Mail App
      1.  
        Enterprise Vault Office Mail App: client tracing
      2.  
        Enterprise Vault Office Mail App: server tracing
      3.  
        Checking deployment of the Enterprise Vault Office Mail App
      4.  
        The Enterprise Vault Office Mail App manifest file is not created
      5.  
        Unable to deploy the Enterprise Vault Office Mail App at organization level
      6.  
        The Enterprise Vault Office Mail App window is blank or contains an error message
      7.  
        An Enterprise Vault Office Mail App action fails with an error message

Deploying the Enterprise Vault Office Mail App for an organization

In an Exchange environment where archiving is to a single Enterprise Vault installation, you may decide to deploy the Office Mail App at organization level. The advantage of deployment at organization level is that it is simpler and quicker than deployment to individual mailboxes.

However, if you consider deploying the Enterprise Vault Office Mail App at organization level, note the following:

  • All users will see the Office Mail App in Outlook 2013 and later, and OWA 2013 and later, including users who are not enabled for Enterprise Vault. If a user is not enabled for Enterprise Vault, a message in the Office Mail App says that it is not available.

  • The same Enterprise Vault server is used for Office Mail App requests from all users, which could affect the overall performance of that server.

    If this Enterprise Vault server becomes unavailable, all requests to load the Office Mail App will fail. You could mitigate this impact and other performance impacts by using a round robin DNS load-balancing solution.

To deploy the Enterprise Vault Office Mail App at organization level, use the PowerShell cmdlet New-App in the Exchange Management Shell.

See About deploying the Office Mail App with the New-App cmdlet.

Note:

You must log in to the Exchange server using an account that is assigned the management roles Org Custom Apps and User Options. By default, members of the "Organization Management" role group are assigned these roles. The mailbox associated with this account must reside on Exchange Server 2013 or later.

The following example shows how to use the New-App cmdlet to enable an organization for the Office Mail App.

The backtick character (') is the PowerShell line-continuation character.

Add-Type -AssemblyName System.Web
$Mbx = get-mailbox "mailbox"

New-App -OrganizationApp -DefaultStateForUser:enabled -Url '
    ("http://EV_server/EnterpriseVault/OfficeMailAppManifest.aspx?LegacyMbxDn=" +
    [System.Web.HttpUtility]::UrlEncode($Mbx.LegacyExchangeDN))

Where:

  • mailbox is the name of a mailbox that is enabled for archiving. This mailbox must be one whose archive is stored on the Enterprise Vault server to which you want all organization level requests to be sent.

  • EV_server is the name of any Enterprise Vault server in your site. This Enterprise Vault server is not necessarily the one that is used to load the Office Mail App. The Enterprise Vault server that is used to load the Office Mail App for all users is the server where the archive for the specified mailbox is located. The name of the correct Enterprise Vault server for the specified mailbox is returned within the manifest file.

Users in the organization may access the Enterprise Vault server externally, with no direct access. In this case, the manifest file must point to the URL of the server that provides external access. The same server would also be used for internal access. For example, the server may be a Microsoft Forefront Threat Management Gateway (TMG) server.

The following example shows how to use the BaseURL parameter with the OfficeMailAppManifest.aspx page to configure the manifest file to point to a server that provides external access.

The backtick character (') is the PowerShell line-continuation character.

Add-Type -AssemblyName System.Web
$Mbx = get-mailbox "mailbox"

New-App -OrganizationApp -DefaultStateForUser:enabled -Url '
    ("http://EV_server/EnterpriseVault/OfficeMailAppManifest.aspx?LegacyMbxDn=" +
    [System.Web.HttpUtility]::UrlEncode($Mbx.LegacyExchangeDN) + 
    "&BaseURL=https://external_access_server/EnterpriseVault")

Where:

  • mailbox is the name of any mailbox that is enabled for archiving.

  • EV_server is the name of any Enterprise Vault server in your site. This Enterprise Vault server is not necessarily the one that is used to load the Office Mail App. The Enterprise Vault server that is used to load the Office Mail App for all users is the server that is specified in the BaseURL parameter.

  • external_access_server is the name of the server that provides external access.