When placing items on Legal Hold, errors are generated in the Legal Hold Details

The 'Number of errors' will display how many errors were generated when placing items on legal hold. (Figure 1)

Figure 1
 

To determine why an error was generated when placing the items on legal hold a query can be ran against the Discovery Accelerator (DA) Customer database to determine the error code.  

SELECT KVSSavesetID, LegalStatus, LegalHoldID, LegalError FROM tblIntDiscoveredItems
WHERE LegalError IS NOT NULL AND CaseID = XX

Note: Replace the XX in CaseID = XX with the correct case id.

In order to find the Case ID, please see Article 100021404.

Look at the LegalError value. It should be in the form:

Note: In the above error message the savesetid is going to be unique for each item.

For DA 8.0:

 

If the Error Code is 768, the item was unavailable, possibly due to an RPC service unavailable.  See Solution below for recommended resolution steps.

If the Error Code is 769, the archive containing the item was full.

If the Error Code is 770, the storage service was busy such that the item could not be accessed.

If the Error Code is 771, a permission was changed such that the Vault Service Account did not have access to the item.

If the Error Code is 772, a bad parameter was passed to the legal hold operation that prevented the item from being placed on legal hold.  See Solution below for recommended resolution steps.

If the Error Code is 773, an ambiguous parameter was passed to the legal hold operation that prevented the item from being placed on legal hold.  See Solution below for recommended resolution steps.

If the Error Code is 774, an internal failure occurred.  See Solution below for recommended resolution steps.

If the Error Code is 775, the item has been deleted before being placed on legal hold.

If the Error Code is 776, the Archive, Vault Store or Retention Category under which the item was archived does not exist.

If the Error Code is 777, the Legal Hold for the item has been barred from removal.

If the Error Code is 778, the license to allow Legal Hold placement does not exist.  Contact your Veritas Sales representative to obtain the license element required to place items on Legal Hold.

If the Error Code is 779, the license to allow Legal Hold placement has expired.  Contact your Veritas Sales representative to obtain a new license element to allow items to be place on Legal Hold.

If the Error Code is 780, an invalid device has been referenced.  Contact Veritas Technical Support for further assistance.

 

For DA 9.0 Base through 9.0 SP3 and 10.0 Base, an issue exists that truncates the last 4 or 5 characters of the error code.  This issue has been fixed in DA 9.0 SP4 and 10.0 SP1.  To obtain the full error code:

 

A SQL Profiler Trace log will have to be recorded while attempting to reapply Legal Holds to the failed items.  See 100019828 in the Related Articles section below for the steps on reapplying Legal Holds to the failed items.

The SQL Profiler Trace logging needs to be configured as follows:

1) Open SQL Server Profiler

2) Click File, then New Trace

3) Click the Connect button to connect to the appropriate Server Name \ Instance

4) On the General tab

- enter a name for the trace in the Trace name: field
- scroll up and select the Blank template in the Use the template: field

- check the Save to file: check box and navigate to the drive and folder in which the log file(s) will reside
- change the  Set maximum file size (MB): field contents to 250 MB from the default value of 5

- ensure the  Enable file rollover check box is checked

5) On the Events Selection tab

 - expand Errors and Warnings
--- select Exception
--- select Execution Warnings
--- select User Error Message
- expand Stored Procedures
--- select SP:Starting
--- select SP:Completed
- click the Column Filters... button

- click on DatabaseName in the left panel
--- expand Like in the right panel
----- enter the name of the DA Customer database in the field that opened below Like

--- check the check box for Exclude rows that do not contain values
--- click the OK button

6) Click the Run button to begin logging.

7) Attempt to reapply the holds using the instructions in  Article 100019828.

8) When the reapplication of holds has completed, click the red square in the toolbar, located just below the Help drop-down menu item, to stop the logging.

9) Search the TextData column for instances of 'exec usp_LegalItem_upd_bulk'.  Any instances found can contain multiple Savesets that failed the hold process.  Each Saveset will have information similar to that in the Error section above, with the complete Error Code shown.

 

If the Error Code is -2147220728, the Archive or Vault Store in which the item resides or the Retention Category under which the item was archived no longer exists in the EnterpriseVaultDirectory database.  This is equivalent to Error Code 776 above.

 

If the Error Code is -2147220729, the item no longer exists in the Vault Store database.  This is equivalent to Error Code 775, where the item has been deleted before it could be placed on hold.

 

If the Error Code is -2147220730, there is communications issue between the Enterprise Vault Server for the associated Vault Store and the Discovery Accelerator Server.

1) If the AcceleratorService Dtrace states 'No such interface supported (0x80004002)', verify the registry entries and EV binaries on both servers are of the correct version.

2) If the AcceleratorService Dtrace states 'Exception: An internal failure occurred. Internal Error: 'The parameter is incorrect.  [0x80070057]'. Info:{C2.EN_US} An COM error occurs [adding] holds, Error Code: -2147220730 Diag:HRESULT: 80040306', follow the instructions in Article 100023438.

 

If the Error Code is -2147220736, the Enterprise Vault Storage Service for the associated Vault Store is not found to be accessible.


Solution for Errors 768, 772, 773, 774 and -2147220736 :

1) Check the Enterprise Vault, Discovery Accelerator and SQL Servers for TCP Chimney and / or TCP Offload Engine.  Disable if found to be enabled.  Refer to Article 100023865 for further information.
2) Click on the Configuration button in the top toolbar, then the Settings button in the second toolbar, and expand the Legal Hold section
3) Change the Placing hold items Batch Size setting to half of the current value
4) Change the Removing hold items Batch Size setting to half of the current value and click the Save button.
5) Restart the Customer Background Task or restart the Enterprise Vault Accelerator Manager Service (EVAMS) to implement the size changes
6) Run iisreset from a Command Line prompt on the DA server to clear the IIS cache
7) Reapply holds on just the failed items per the instructions in Article 100019828.
8) If the error continues after following the above steps, contact Veritas Enterprise Vault Technical Support for further assistance.