When using Enterprise Vault for File System Archiving, archived files cannot be restored from their placeholder shortcuts if the corresponding database entries for the placeholder are missing.

Article:TECH48562

Created: 2006-01-24

Updated: 2006-01-23

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

Article Type
Technical Solution

Product(s)

Show all

Environment

Show all

Languages

Show all

Problem

When using Enterprise Vault for File System Archiving, archived files cannot be restored from their placeholder shortcuts if the corresponding database entries for the placeholder are missing.

Error

An unspecified error occurred. Access is denied [0xc0045030].

Solution

Summary

Symantec Engineering has discovered a potential issue regarding the recall of items archived with Enterprise Vault File System Archiving (FSA) if the corresponding database entries for the placeholder are missing.

Whilst this situation, nor the exact steps to trigger the deletion of ArchiveFolder entries in the EnterpriseVaultDirectory database, cannot be reproduced, new functionality has been added which enables all stores to be searched for the saveset containing the archived item. This search is transparent to the end user and occurs only if the information is not found as a direct result of invoking the placeholder. This functionality also provides greater resilience against entries being removed during normal operations.

How to Determine if Affected by this Issue

Whilst running DTrace against the EVPlaceholderService component and attempting to retrieve an archived item, an error similar to the following will be generated:

EV~E Error downloading file: \\?\D:\FSAd\jah\jjjjsdf.txt, Url: http://EV.acme.local/EnterpriseVault/download.asp?VaultID=1A078A2B18531774C84CC56682C89A3761110000EV.acme.local&SavesetId=842000000000000~200606021527440000~0~5EA7C71FA33C4B7F86CAE18379A28DA&Request=NativeItem&EVHeaders=1 |Error An unspecified error occurred. Access is denied [0xc0045030] |

1. Open SQL Query Manager (MS SQL 2000) or create a new query (MS SQL 2005) for the EnterpriseVaultDirectory database.

2. Enter and run the following query statement, inserting the Vault ID from the above error (indicated in bold):

SELECT ssvce.ServiceEntryId,ssvce.ComputerEntryId,ssvce.SiteEntryId,ssvce.Tracing,

ssvce.Description,ssvce.AdminNote,ssvce.StorageArchive,ssvce.StorageRestore,

ssvce.StorageReplayIndex,ssvce.StorageSpool,ssvce.StorageCanChangeLocation,

ssvce.StorageCanDelete,ssvce.ArchiveProcesses,ssvce.ArchiveThreads,ssvce.RestoreProcesses,

ssvce.RestoreThreads,ssvce.ReplayIndexProcesses,ssvce.ReplayIndexThreads,

ssvce.FileWatchScanFrequency, ssvce.StorageAdministrate,ssvce.ArchiveOperations,

ssvce.BypassConversions,ssvce.ConversionTimeout,ssvce.ExcludedFileTypes,

ssvce.ThrottlingDisabled,ssvce.ThrottleInterval,ssvce.ThrottleLowerThreshold,

ssvce.ThrottleUpperThreshold,ssvce.MSMQMaxMessageSize,ssvce.MSMQTimeout,

ssvce.MSMQNackClearInterval,ssvce.ExpirySchedule,ssvce.ExpiryReportMode,

ssvce.MaxConcurrentMigrations,ssvce.TextConversionFileTypes

FROM VaultEntryView ve,VaultStoreEntry vse,StorageServiceEntry ssvce

WHERE ve.VaultEntryId = '%INSERT_VAULT_ID_FROM_ERROR%'

AND ve.VaultStoreEntryId = vse.VaultStoreEntryId AND vse.StorageServiceEntryId = ssvce.ServiceEntryId

SET FMTONLY OFF

3. Repeat for each Archive containing items archived using FSA.

If this statement returns no values, apply the attached hotfix in order to restore access to these items.

Hotfix Pre-requisites

This hotfix requires Enterprise Vault 6.0 SP2 (Build 7791): http://support.veritas.com/docs/282033 . To determine which version of Enterprise Vault is running, refer to TechNote 277401, found below, in the Related Documents section.

Note: This issue is also formally resolved in 6.0 SP3, found below, in the Related Documents section.

Files Updated in this Hotfix

KVS.EnterpriseVault.FileServerArchiveCommon.dll

KVS.EnterpriseVault.DirectoryAccess.dll

AutoStorageOnlineOpns.dll

StorageCommon.dll

Installation Instructions

1. On each affected file server, stop all Enterprise Vault Services. On each Enterprise Vault server, stop all EV Services and the IIS Admin Service.

2. Using the list of files above, take a copy of each of the named files that currently exist on the Enterprise Vault server and copy to a safe place. DO NOT rename them, but copy them.

3. Overwrite the files on the server with the updated files in this hotfix.

4. Restart all Enterprise Vault Services and World Wide Web Publishing Service.

5. On the Enterprise Vault servers, add a new string value to the registry named "MissingFolderVaultStoreList" under the "HKLM\SOFTWARE\KVS\Enterprise Vault\Storage" key. In the entry, list the IDs for the Vault Stores from which files cannot be retrieved. Multiple Vault Store IDs can be separated by spaces or semi-colons.

To obtain the Vault Store IDs, open the Enterprise Vault Administration Console by and opening the Properties page for the Vault Store. The Vault ID is listed on the General tab and can be selected and copied to the clipboard and then pasted into the registry entry. Multiple Vault IDs should be listed in the order that it is most likely for the file to be found since they are searched in that order.

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.