Description
When Enterprise Vault (EV) archives items, it also converts the content to HTML. The storage process attempts the HTML conversion on each item. There is a default conversion timeout of 30 minutes for this process. EV makes three attempts to convert an item. These retry attempts can take up to 90 minutes before failing an item and moving onto the next one. If this fails, the converted output is then stored as a stream in storage. The resulting data is retrieved by the StorageCrawler process and passed to the Index Volume Processor (IVP) process for indexing. If there are any errors in the conversion, the StorageCrawler process retrieves the value of the error and passes it to indexing.
If the IVP process receives an error value from the StorageCrawler process, a new attribute is created in the index and the value is added to the relevant attribute. The relevant attribute's item content missing reason (comr) and attachment Item content missing reason (a_comr) report the error reason to the verify report.
COMR – This attribute indicates that the content of a message or file was not fully indexed or the item was not indexed at all.
A_COMR – This attribute indicates that the content of an (at least one) attachment was not fully indexed (or at all).
If multiple attachments have missing content, then the a_comr attribute will have multiple values, but there is no way to identify the specific attachment(s) affected though.
To troubleshoot issues with items having missing content or attachment missing content, a Verify action against the index volume will be required, choosing the complete option from the Manage Index UI.
Part of the Verify process of an index volume is to:
- Report for missing content (numerous reasons for this such as encrypted content that can’t be decrypted). This will be done by searching for documents within the index with the COMR property set in the index. This indicates the reason for the content being missing. When items found:
- For x64, updates the ItemAdditionStatusLog table to include the items and the reason.
- For AV, we already have these listed in the IndexMissing.log file. This will be updated if required to reflect the actual items.
- Reports for Missing in Attachment(s) are achieved by searching for attachments in the index with the a_comr attribute set in the index.
General Troubleshooting Information
The value's for these comr attributes and the corresponding meanings are as follows.
COMR Value
|
EValueMissingReason
|
Error Reason
|
0
|
vmrNOREASON
|
No reason available.
|
1
|
vmrVALUENOTFOUND
|
Content does not exists
|
2
|
vmrVALUENOTOBTAINED
|
Content could not be obtained.
|
3
|
vmrVALUECORRUPT
|
Content is (or appears to be) corrupt.
|
4
|
vmrNOCONVERTER
|
Not possible to convert content to suitable format
|
5
|
vmrCONVERSIONFAILED
|
Conversion of content failed (converter error).
|
6
|
vmrCONVERSIONTIMEDOUT
|
Conversion of content timed out.
|
7
|
vmrFORMATEXCLUDED
|
Content requires conversion but its data format is excluded from conversion.
|
8
|
vmrCONVERSIONBYPASS
|
Content requires conversion but conversion bypass has been set.
|
9
|
vmrVALUEENCRYPTED
|
Content is encrypted.
|
10
|
vmrCONVERTERUNINIT
|
Content requires conversion but converters are not available, or have not been initialized.
|
11
|
vmrADDITEMTOINDEX
|
Unable to add content to index.
|
12
|
vmrFORMATNOTRECOGNISED
|
Converters did not recognize the file type.
|
13
|
vmrLARGEFILE
|
Conversion excluded for large files
|
14
|
vmrUNKNOWNCODEPAGE
|
Conversion excluded for codepages we cannot detect
|
The value’s for the a_comr attributes and the corresponding values are as follows.
A_COMR Value
|
EValueMissingReason
|
Error Reason
|
0
|
vmrNOREASON
|
No reason available.
|
2
|
vmrVALUENOTOBTAINED
|
Content could not be obtained.
|
3
|
vmrVALUECORRUPT
|
Content is (or appears to be) corrupt.
|
4
|
vmrNOCONVERTER
|
Not possible to convert content to suitable format
|
5
|
vmrCONVERSIONFAILED
|
Conversion of content failed (converter error).
|
6
|
vmrCONVERSIONTIMEDOUT
|
Conversion of content timed out.
|
9
|
vmrVALUEENCRYPTED
|
Content is encrypted.
|
10
|
vmrCONVERTERUNINIT
|
Content requires conversion but converters are not available, or have not been initialized.
|
12
|
vmrFORMATNOTRECOGNISED
|
Converters did not recognize the file type.
|
13
|
vmrUNKNOWNCODEPAGE
|
Conversion excluded for large files
|
14
|
vmrUNKNOWNCODEPAGE
|
Conversion excluded for codepages we cannot detect
|