1. Support
  2. Knowledge base
  3. 100003894

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

Article: 100003894
Last Published: 2021-06-21
Ratings: 6 0
Product(s): Enterprise Vault

Problem

When a 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 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.

Note: This process would be valid for non-Windows file servers as well as long as the file server type is the same. For instance, NetApp C-Mode to C-Mode.  The new server must be configured properly according to the configuration procedures.   

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
\\FSA1.test.com\Volume\Folder
\\FSA2.test.com\Volume\Folder
Directory DB
FileServerEntry
DnsName
FSA1.test.com
FSA2.test.com
Directory DB
FileServerEntry
UncName
\\FSA1
\\FSA2 


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, FQDN or IP Address format.  For IP Address format replace the syntax to show the previous entry as IP Address. The UPDATE script will change all entries to the FQDN format.
 
  1. 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
     
  2. Start all EV Services on all EV servers.
     
  3. Open EV Administration Console (VAC)
     
  4. Run the File System Archiving synchronization task:

    Site > Enterprise Vault Servers > Tasks > File System Archiving Task > Properties > Synchronization > Synchronize
     
  5. If Reporting is enabled, follow the following steps.
    1. In the VAC, right-click on the file server target and select properties. Then click on Reporting Data Collection tab.
    2. Check Enable data collection for FSA Reporting
    3. Select database for reporting
    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).
 

 

Was this content helpful?

Article Languages