About how to quiesce and unquiesce Enterprise Vault services

In Enterprise Vault 8.0, quiescing and unquiescing is done at the component level.

In Enterprise Vault 7.5, the mechanism to quiesce and unquiesce is performed at the Enterprise Vault server level through the following Enterprise Vault registry keys:

EnableArchive
EnableCrawler
EnableExpiry
EnableFileWatch
EnablePSTMigrations
EnableReplayIndex
EnableRestore

The locations of the Enterprise Vault registry keys are as follows:

HKEY_LOCAL_MACHINE\SOFTWARE\KVS\Enterprise Vault\Storage
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KVS\Enterprise Vault\Storage

The following lists provide a high-level overview of how to quiesce or unquiesce the Enterprise Vault services.

To quiesce the Enterprise Vault services, stop the Enterprise Vault services, create the special Enterprise Vault registry keys, and restart the services. Make sure that you create the Enterprise Vault registry keys with a value of zero.
To unquiesce the Enterprise Vault services, stop the Enterprise Vault services, delete the special Enterprise Vault registry keys, and restart the services.

Multiple quiescent and unquiescent jobs can run on the same Enterprise Vault server. Therefore, NetBackup uses a registry counter (NBU_EV_QSE_LEVEL) to track the number of times the Enterprise Vault services are put into read-only mode. If the value of this counter is zero, the Enterprise Vault services are running in a read-write mode. If value of this counter is non-zero, then the Enterprise Vault services are running in a read-only mode.

Note:

Incorrect use of the Windows registry editor may prevent the operating system from functioning properly. You should be very careful when making changes to a Windows registry. Only those who have experience with the registry editor application should attempt to modify the registry. Symantec recommends that you make a complete backup of the registry and workstation before you make any registry changes.

The location of this registry counter is one of the following addresses:

HKEY_LOCAL_MACHINE\SOFTWARE\KVS\Enterprise Vault\NetBackup
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KVS\Enterprise Vault\NetBackup

The following lists explain how quiesced and unquiesced jobs affect the state of the NetBackup reference counter, special Enterprise Vault registry keys, and Enterprise Vault services. (The NetBackup reference counter is a registry key at the location, NBU_EV_QSE_LEVEL.)

When a quiesced job begins with the Enterprise Vault services in down state, one of the following occurs:

If the special Enterprise Vault registry keys are not present, they are created to ensure that Enterprise Vault services start in a read-only mode. In addition, the NetBackup reference counter is set to one in the registry key.
If the special Enterprise Vault registry keys are present, the job increments the NetBackup reference counter by one in the registry key.

The following occurs with the quiesced jobs that have Enterprise Vault services in an up state and the special registry keys are not present: (Enterprise Vault is in a read-write mode.)

The job brings the Enterprise Vault services down.
The special Enterprise Vault registry keys are created to ensure that Enterprise Vault services start in a read-only mode.
The Enterprise Vault services are brought back up, only now they are in a read-only mode
The NetBackup reference counter is set to one in the registry key.

The following occurs with the quiesced jobs that have Enterprise Vault services in an up state and the special registry keys are present: (Enterprise Vault is in a read-only mode.)

The job increments the NetBackup reference counter by one in the registry key
The services remain in the same state.

The following occurs when an unquiesced job begins with the Enterprise Vault services in a down state and the NetBackup reference counter is 1:

Set the reference counter to zero in the registry key.
The special Enterprise Vault registry keys are deleted to ensure that Enterprise Vault services start in a read-write mode.

If the NetBackup reference counter is greater than 1, the job decrements the reference counter in the registry key.

The following occurs when an unquiesced job begins with the Enterprise Vault services in an up state and the NetBackup reference counter is 1:

The reference counter is set to zero in the registry key.
The job brings the Enterprise Vault services down.
The special Enterprise Vault registry keys are deleted to ensure that the Enterprise Vault services start in a read-write mode.
The job brings up the Enterprise Vault services in a read-write mode.

The following occurs when an unquiesced job begins with the Enterprise Vault services up and the NetBackup reference counter is greater than 1:

The job decrements the NetBackup reference counter by one in the registry key.
The services remain in the same state.

If jobs fail during a policy execution, or the Enterprise Vault archive jobs do not work after the policy execution, perform the following steps sequentially:

Verify that the value of NetBackup reference counter is set to zero. If it is left as a non-zero value, then the subsequent quiesce jobs may not work as expected. You may have to manually set this value to zero.
Verify that there are no special Enterprise Vault registry keys present. If any special Enterprise Vault registry keys are present, the Enterprise Vault services are in a read-only mode. You must manually restart the Enterprise Vault services in a read-write mode.
To manually restart the Enterprise Vault services in read-write mode:
- Set the value of the NetBackup registry counter (NBU_EV_QSE_LEVEL) to 1.
- Go to NetBackup Installation folder\NetBackup\bin folder.
- Run the following command:
  
  bpresolver.exe unquiescence -v -c <EV Server> -pt 39 -S <NetBackup Master Server> EV_SERVER
  
  The EV Server variable is the host name of the Enterprise Vault server where you must restart the Enterprise Vault services in a read-write mode.
  
  If the NetBackup unquiescence job is not able to start Enterprise Vault in read-write mode, then you must unquiesce the Enterprise Vault services. To unquiesce the Enterprise Vault services, stop the Enterprise Vault services, delete the special Enterprise Vault registry keys, and restart the services.
Verify that no special Enterprise Vault registry key is present. If none are present and some Enterprise Vault services are in a down state, you must manually start those services.