Moved shortcuts are not updated correctly during archive task

Article:TECH71905  |  Created: 2009-01-26  |  Updated: 2012-01-19  |  Article URL http://www.symantec.com/docs/TECH71905
Article Type
Technical Solution


Problem



Moved shortcuts are not updated correctly during archive task


Cause



When running the Shortcut Processing action of the archive task, it was noted that some shortcuts were not updated properly with the new location. This was noticed by opening Archive Explorer and the message was still in its original folder. Under normal circumstances, the new feature in Enterprise Vault version 8 and above is to update Archive Explorer to reflect the new location.
 
DTracing the ArchiveTask process during the Shortcut Processing run, shows the following:
 
2436 10:55:25.040 [9112] (ArchiveTask) <8180> EV:M CArchivingAgent::ProcessShortcutItem - '<Message Subject>' this is a moved item that has been poison pilled so do not try and update its metadata again 
 
There are 3 reasons why a message will be poison pilled during the process:  Poison Pilled simply means that if the item fails to be updated 3 times, it will not be tried again.
 
A. The shortcut moved is considered an "Orphan". This would indicate there is no associated item in the archive.
 
B. If an item that has been moved is now in a folder that corresponds to a different archive; Ie. the item is moved into a folder that is set up to archive items into a shared folder via EVPM
 
C. If an attempt is made to change an item's Retention Category, where the new Retention Category is marked as “Prevent deletion of archived items in this category” but the original Retention Category is not configured as such.

Solution



There are other circumstances outside of the 3 reasons mentioned above that cause the move update failure. When a scenario is found as such, the registry key below can be used to reset the poison pill count and allow the move updated to process again. 

 

Warning: Incorrect use of the Windows registry editor may prevent the operating system from functioning properly. Great care should be taken when making changes to a Windows registry. Registry modifications should only be carried-out by persons experienced in the use of the registry editor application. It is recommended that a complete backup of the registry and workstation be made prior to making any registry changes.

 

For 32-bit - HKLM\Software\KVS\Enterprise Vault\Agents\
DWORD: ClearFailedMoveUpdate
Value: 1

 

For 64-bit - HKLM\Software\Wow6432Node\KVS\Enterprise Vault\Agents\
DWORD: ClearFailedMoveUpdate
Value: 1

 



Legacy ID



327176


Article URL http://www.symantec.com/docs/TECH71905


Terms of use for this information are found in Legal Notices