EV Office Mail App fails to initialize when a backslash is contained with the description of a Retention Category

book

Article ID: 100014989

calendar_today

Updated On:

Description

Error Message

Initialization failed.

Cause

During the Initialization of the EV OMA several HTTP(s) requests are made to the EV server to retrieve policy information. The policy information is returned to the client application in the form of a JavaScript resource string. When the client application interprets this string, the backslash ("\") is interpreted as an escape sequence, this in turn causes the EV OMA initialization to fail.

Steps to confirm the issue is present:

Using the Vault Admin Console:
1. Navigate to the Retention Categories section: Directory > Site > Policies > Retention Categories
2. Open the Properties of each Retention Category and examine the Description field for backslash ("\") characters

Using SQL:
Run the following query against the EnterpriseVaultDirectory database:
SELECT RetentionCategoryName, RetentionDescription
FROM RetentionCategoryEntry
WHERE RetentionDescription LIKE '%\%'

Resolution

This issue has been addressed in the following releases:
 
Enterprise Vault 12 available from Downloads

 
Note: For information on how to obtain Enterprise Vault 12 see: How to obtain the license key and installation download for Veritas products
 

Workaround:

1. Remove any backslashes "\" from the Retention Category Description fields

2. Synchronize Users

3. Test EV OMA functionality 

 

 

Issue/Introduction

When an Enterprise Vault (EV) Retention Category description contains a backslash ("\") character, the EV Office Mail App (OMA) may fail to initialize.

Additional Information

ETrack: 3704060