After upgrading Enterprise Vault nodes in a Microsoft Cluster Server, registry values revert to pre-upgrade values

book

Article ID: 100020887

calendar_today

Updated On:

Description

Notes

The technote requires accurate command to get/check the checkpoint,removing the checkpoint and to add the checkpoint. Get-clustercheckpoint | fl    

In my example I see that the Resource is AEC-008-EV-MAIL-EnterpriseVaultServerInstance and the checkpoint name is Software\KVS\Enterprise Vault. This will be different in every environment.  Make a note of these values.  

Use the following command to remove the EV cluster checkpoint:  Get-ClusterResource AEC-008-EV-MAIL-EnterpriseVaultServerInstance |Remove-ClusterCheckpoint -RegistryCheckpoint "Software\KVS\Enterprise Vault" 

Confirm the checkpoints with the command Get-clustercheckpoint | fl  

To create the new checkpoint manually, use the following command  Get-ClusterResource AEC-008-EV-MAIL-EnterpriseVaultServerInstance | Add-ClusterCheckPoint -RegistryCheckpoint"Software\KVS\Enterprise Vault" 

Confirm the checkpoints with the command Get-clustercheckpoint | fl

Resolution

After the upgrade, but prior to bringing the EV resources online, perform the following steps to export upgraded registry values to a file.
 
Note: If all nodes of the cluster have already been upgraded and brought online, then you will need to bring the resources back offline and reinstall the EV application files on one of the nodes to recreate the upgraded registry values before proceeding.
  1. Go to Start | Run, type regedit, and click OK.
  2. Expand HKEY_LOCAL_MACHINE\Software\Wow6432Node\KVS 
  3. Highlight Enterprise Vault, go to File > Export, and save the key to a .reg file.
  4. Bring the EV cluster resources online on the updated node using Cluster Administrator.
  5. Run the following command.
  • Open Command Prompt as Administrator
  • Type Cluster resource EVServername-EnterpriseVaultAdminService /check
  • The checkpointing path will be seen in the output.
  • Use the following command to remove the check
  • Cluster resource EVServername-EnterpriseVaultAdminService /removecheck : "Software\KVS\Enterprise Vault"

 

6. While the services are online on the node, import the .reg file saved in step 3 by double-clicking it to overwrite the pre-upgrade values with the proper values.

7. Once the AdminService is online run the following command to add the check.

8. Cluster resource EVServername-EnterpriseVaultAdminService /addcheck:"Software\KVS\Enterprise Vault"

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.

 

 

Issue/Introduction

When Enterprise Vault (EV) resources in a Microsoft Cluster Server (MSCS) are brought back online after an upgrade, MSCS replication causes values in the EV registry key "HKEY_LOCAL_MACHINE\Software\KVS\Enterprise Vault" to revert back to pre-upgrade values.

Additional Information

ETrack: 1634246
Powered by Wolken Software