How to rename a Windows file server that is archived by Enterprise Vault File System Archiving (EV FSA)

Article:TECH144810  |  Created: 2010-11-23  |  Updated: 2014-10-07  |  Article URL http://www.symantec.com/docs/TECH144810
Article Type
Technical Solution

Product(s)

Issue



When a Windows file server, which is being archived by EV, needs to be renamed or needs to be moved to a different Active Directory Domain, what changes are needed in EV so that there is no impact on archives and placeholders for the file server?

A Windows File Server is configured as an archiving target in EV. If the file server needs to be renamed or if it needs to be moved to another domain, changes will be required within EV to allow archiving and placeholder access to continue.
 
Examples:
 
1.      Windows file server FSA1.test.com is renamed to FSA2.test.com.
2.      Windows file server FSA.test.com is moved from one domain test.com to another newtest.com to become FSA.newtest.com.

Environment



Microsoft -> Windows File Server (supported versions)

 


Solution



All references to the old file server name need to be modified to that of the new file server. Once the file server has been renamed or moved to the new domain, those changes need to be reflected in the EnterpriseVaultDirectory database.   
 
1. Stop all EV Services on all EV servers.
2. Perform a backup of the EnterpriseVaultDirectory database (in case of issues a backup is required to restore to a previous good state).
3. Change the values in the following columns in the Directory Database:

Database
Table
Column
Old Value (example)
New Value (example)
Directory DB
ArchiveFolder
FolderPath
Directory DB
FileServerEntry
DnsName
Directory DB
FileServerEntry
UncName

In this example the correct SQL commands would be:-
 
USE EnterpriseVaultDirectory
UPDATE FileServerEntry
SET DnsName = 'FSA2.test.com'
WHERE DnsName = 'FSA1.test.com'
 
USE EnterpriseVaultDirectory
UPDATE FileServerEntry
SET UncName = '\\FSA2'
WHERE UncName = '\\FSA1'
 
USE EnterpriseVaultDirectory
UPDATE ArchiveFolder
SET FolderPath = replace(cast (FolderPath as nvarchar (1000)),
'\\FSA1.test.com\', '\\FSA2.test.com\')
WHERE FolderPath like '\\FSA1%'
 
It is possible that there could be entries in the ArchiveFolder table that are in a NETBIOS or a FQDN format. The command above will change all entries to the FQDN format.
 
4. If the EV version running is 10.0.4 or above then the following command also needs to be run to update the CHECKSUM value in the FSAArchivePointFolderPathChecksum table. If the EV version is a version lower than 10.0.4 then proceed straight to the next step and do not run this command as it will fail.
 
USE EnterpriseVaultDirectory
UPDATE FSAArchivePointFolderPathChecksum
SET FolderPathChecksum = CHECKSUM(CAST(ArchiveFolder.FolderPath AS NVARCHAR(MAX)))
FROM FSAArchivePointFolderPathChecksum
INNER JOIN ArchiveFolder ON ArchiveFolder.RootIdentity = FSAArchivePointFolderPathChecksum.RootIdentity
 
5. Start all EV Services on all EV servers.
6. Open EV Administration Console (VAC)
7. Run the File System Archiving synchronization task:
                Site > Enterprise Vault Servers > Tasks > File System Archiving Task > Properties > Synchronization > Synchronize
8. If Reporting is enabled, follow the following steps
  8.1 In the VAC, right-click on the file server target and select properties. Then click on Reporting Data Collection tab.
  8.2 Check Enable data collection for FSA Reporting
  8.3 Select database for reporting
  8.4 Run the reporting scan
 
Note: Any old trending data for Trending Reports will still be recorded against the old file server name. 
 
Note: If the file server domain name is changed (example: FSA.test.com to FSA.newtest.com) and FSAUtility commands need to be run, please specify the FQDN of the file server (FSA.newtest.com).



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


Terms of use for this information are found in Legal Notices