Hotfix for Symantec Enterprise Vault (EV) 10.0 Service Pack 1 build 10.0.1.1171, FSAUtility improvements for -pm operation and tool to correct archive folder hierarchy.

Article:TECH192086  |  Created: 2012-06-29  |  Updated: 2014-06-24  |  Article URL http://www.symantec.com/docs/TECH192086
Article Type
Technical Solution


Issue



Which version of Symantec Enterprise Vault (tm) can this hotfix be applied?
This hotfix can only be applied to the following versions of Enterprise Vault for:
10.0.1

 
 


Solution



What issue(s) does this hotfix resolve?

 

Etrack 2803380:
If the FSAUtility -pm operation failed to move one or more file placeholders to the destination, administrators were forced to fix each such placeholder issue first, before they could continue the migration operation. There was no option to ignore such placeholders and continue with the placeholder migration (-pm) operation.

 

Etrack 2801770:
On occasion, if migration using FSAUtility.exe failed to delete an Archive Point from the source target, the FSA archive task could potentially archive data from both source and target locations and associate the archive to both source and target volumes.

 

Etrack 2789107:
The level of logging in FSAUtility.exe has proved insufficient in certain exceptional cases to determine the root cause of the problem.

 

Etrack 2789111:
Some changes were identified that could improve database record consistency with regards to updates made as part of running FSAUtility.exe.

 

Etrack 2751136 and 2700813:
Under some very specific conditions, the FSA check pointing feature did not work as expected. As a result, a target folder could be skipped from archiving. However, in subsequent runs, data from such folders would be archived.

 

Etrack 2418000:
In Enterprise Vault 9.0, 9.0.1 and 9.0.2, subfolders with the same name as the root folder in an archive would be mapped to the root folder instead of creating the correct hierarchy. That issue has already been fixed; this hotfix comprises the changes and process to correct the archive folder hierarchy and refile items correctly.
 

 

Which files does this hotfix replace? 

 

File Name File Version New File Version
DirectoryConnectionU.dll 10.0.1.1171 10.0.1.1205
DirectoryService.exe 10.0.1.1171 10.0.1.1205
EvFsaArchivingTask.exe  10.0.1.1171 10.0.1.1205
EVStoreAccessor.dll 10.0.1.1171 10.0.1.1205
FSAUtility.exe 10.0.1.1171 10.0.1.1205
KVS.EnterpriseVault.DirectoryAccess.dll 10.0.1.1171 10.0.1.1205
KVS.EnterpriseVault.FileServerArchiveCommon.dll 10.0.1.1171 10.0.1.1205
KVS.EnterpriseVault.Runtime.dll  10.0.1.1171 10.0.1.1205
VaultMessages.dll 10.0.1.1171 10.0.1.1205

 

 

How to Install this hotfix:
 

Before applying this hotfix, check the File Version of FSAUtility.exe from the file's properties.  The FSAUtility.exe is located in the Enterprise Vault installation folder, which by default is C:\Program Files (x86)\Enterprise Vault.

 

If FSAUtility.exe is version 10.0.1.1171, the installation of this hotfix should be performed as follows:

 

INSTALLATION A


1.  Stop all Enterprise Vault services.


2.  Once all services have stopped, take a backup copy of the files listed in the Which files does this hotfix replace section above. These files are located in the Enterprise Vault installation folder.


3.  Copy the files listed in the Which files does this hotfix replace section, packaged in this hotfix, to the Enterprise Vault installation folder, replacing the originals where applicable.
 

4.  Take a backup of each Enterprise Vault SQL database, in accordance with standard backup procedures.
 

5.  Run Etrack_2685041_Install.sql against the Enterprise Vault Directory database.
 

6.  Run Etrack_2418000_Directory_Install.sql against the Enterprise Vault Directory database.
 

7.  Run Etrack_2418000_VaultStore_Install.sql against each Enterprise Vault VaultStore database.
 

8.  Start all Enterprise Vault services.

 

Please contact Technical Support for procedures to correct the archive folder hierarchy.  

 

 

If FSAUtility.exe is version 10.0.1.1205, the following should be performed to install this hotfix:

 

INSTALLATION B

 

1. Stop all Enterprise Vault services.
 

2. Once all services have stopped, take a backup copy of EVStoreAccessor.dll located in the Enterprise Vault installation folder.
 

3. Copy EVStoreAccessor.dll, packaged in this hotfix, to the Enterprise Vault installation folder, replacing the original.
 

4. Take a backup of each Enterprise Vault SQL database, in accordance with standard backup procedures.
 

5. Run Etrack_2418000_Directory_Install.sql against the Enterprise Vault Directory database.
 

6. Run Etrack_2418000_VaultStore_Install.sql against each Enterprise Vault Vault Store database.
 

7. Start all Enterprise Vault services.

 

Please contact Technical Support for procedures to correct the archive folder hierarchy.  

 

 

How to Uninstall this hotfix:

 

If INSTALLATION A was used:


1. Stop all Enterprise Vault services.
 

2. Once all services have stopped, replace the hotfixed versions of the files listed in the Which files does this hotfix replace section with the backup copies taken during the installation of this hotfix.
 

3. Run Etrack_2685041_Uninstall.sql against the Enterprise Vault Directory database.
 

4. Run Etrack_2418000_Directory_Uninstall.sql against the Enterprise Vault Directory database.
 

5. Run Etrack_2418000_VaultStore_Uninstall.sql against each Enterprise Vault VaultStore database.
 

6. Start all Enterprise Vault services.

 

 

Otherwise, if INSTALLATION B was used:
 

1. Stop all Enterprise Vault services.
 

2. Once all services have stopped, replace the hotfixed version of EVStoreAccessor.dll with the backup copy taken during the installation of this hotfix.
 

3. Run Etrack_2418000_Directory_Uninstall.sql against the Enterprise Vault Directory database.
 

4. Run Etrack_2418000_VaultStore_Uninstall.sql against each Enterprise Vault VaultStore database.
 

5. Start all Enterprise Vault services.
 


Attachments

Hotfix files and stored procedures.
Etrack_FSAUtility_ArchiveFolder_hotfix.zip (2.1 MBytes)

Supplemental Materials

SourceETrack
Value2803380
Description

FSAUtility -pm moved EVArchivePoint.xml where ArchiveFolder entries, VolumeEntryId and ArchiveVEID entries are still linked to source FolderPath and source FileServerEntryId.


SourceETrack
Value2801770
Description

Modify UpdateArchive stored procedure to avoid multiple association in FileServerVolumeArchiveEntry


SourceETrack
Value2789107
Description

FSAUtility -pm - Unexpected behavior as no PH are created at destination while -pm execution reports successful completion


SourceETrack
Value2789111
Description

FSAUtility -pm cannot correctly migrate Archives and preserve consistent records in database among other unexpected results.


SourceETrack
Value2418000
Description

Fixup tool for CreateArchiveFolder stored procedure problem


SourceETrack
Value2751136
Description

FSA Root folders are skipped as a result of a last run folder in a different root folder not having been reached.




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


Terms of use for this information are found in Legal Notices