Unable to recall placeholders after upgrading Enterprise Vault

Article:TECH61366  |  Created: 2008-01-24  |  Updated: 2008-01-24  |  Article URL http://www.symantec.com/docs/TECH61366
Article Type
Technical Solution

Product(s)

Environment

Problem



Unable to recall placeholders after upgrading Enterprise Vault

Error




Type: Error
Date: 20/05/2008
Time: 11:48:38
Event: 1002
Source: Application Hang
Category:
User: N/A
Computer: SERVER
Description:
Hanging application APP.EXE, version 11.0.5604.0, hang module hungapp, version 0.0.0.0, hang address 0x00000000.

Solution



After upgrading Enterprise Vault (EV) to EV2007SP2 or EV2007SP3, placeholders cannot be recalled. When a placeholder is opened, the associated application opens and hangs, generating an error in the Application Event Log (as shown above). The item can be retrieved using Archive Explorer or Search Vaults.

By running a DTRACE against the EvPlaceholderService on the File Server the following processing can be observed:

10 11:43:11.153 [1008] (EvPlaceholderService) <2044> EV:L RequestArchivedFile::Process (Entry) |
11 11:43:11.153 [1008] (EvPlaceholderService) <2044> EV:M Processing a placeholder restore request for file: \\?\E:\All3Media\Adding users through the command line.txt Url: http://evserver/enterprisevault/download.asp?VaultID=1C622F2E28A5DC04DB37DB5A7BA7468031110000evsite&SavesetId=556000000000000~200510280948560000~3~6D68C88E7B4B405BB38F4D55267FD1A&Request=NativeItem&EVHeaders=1, placeholder version: 1
12 11:43:11.153 [1008] (EvPlaceholderService) <2044> EV:L RequestArchivedFile::DownLoadFile (Entry) |
13 11:43:11.164 [1008] (EvPlaceholderService) <2044> EV:L Attempting to download file: \\?\E:\All3Media\Adding users through the command line.txt at Url: http://evserver/enterprisevault/download.asp?VaultID=1C622F2E28A5DC04DB37DB5A7BA7468031110000evsite&SavesetId=556000000000000~200510280948560000~3~6D68C88E7B4B405BB38F4D55267FD1A&Request=NativeItem&EVHeaders=1
14 11:43:11.164 [1008] (EvPlaceholderService) <1572> EV:L CQueue::EnQueue (Exit) |Success  [0] |

From the relevant area of the DTRACE, the web request returns 'http://evserver/enterprisevault/download.asp?', which is the call being made to the Virtual Directory hosted on the Enterprise Vault server. This virtual directory is created as part of the initial installation and is named EnterpriseVault.
Prior to 2007SP2 and 2007SP3 the code was not case-sensitive. With SP2 and SP3, the web request processing mechanism was changed and now uses WinHTTP. The code that now receives the download request is currently checking for the string EnterpriseVault. As such, if the Web Access application URL is not set using upper-case characters, the request fails.

Workaround:

Warning: Incorrect use of the Windows Registry Editor can have disastrous results on a server Operating System. 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

1. From within the Vault Admin Console, expand "Enterprise Vault", then "Directory". Right click on the "Site" level and select Properties. Set the Web Access application URL to use capital E and V i.e. EnterpriseVault as shown in (Figure 1) below

Figure 1
 

2. Open the Registry Editor regedt32.exe and locate the following registry key on the File Server:
HKEY_LOCAL_MACHINE\Software\KVS\Enterprise Vault\FSA\PlaceholderServer.
Add new DWORD EnableDynamicUrl and set the value = 1

3. Restart the Placeholder Service on the File Server

Solution:
This issue has been resolved by the following release:
Symantec Enterprise Vault 2007 Service Pack 4 (SP4)

Supplemental Materials

SourceETrack
Value1362147
DescriptionFSA_Windows - PH recall fails if Webapp is entered in Site Properties using lower case


Legacy ID



305493


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


Terms of use for this information are found in Legal Notices