Skip to main content

How can we help you?

Druva Documentation

Configure agent to recognize a VSS provider

By default, Druva uses snapshots created by the native Microsoft Volume Shadow Copy Service (VSS). If you are using a third-party VSS provider, Hybrid Workloads agents might not work as expected because they are configured to recognize snapshots created by the native VSS only. This can result in Hybrid Workloads agent crashes or backup failures. 

To avoid this issue, you must configure Hybrid Workloads agents to recognize the third-party VSS provider that you are using. 

Note: As far as possible, we recommend that you use Microsoft VSS. However, if you must use a third-party VSS provider, ensure that you perform this procedure before configuring your servers.

Before you begin

Before configuring Hybrid Workloads agent to recognize a VSS provider, ensure that you log on to the server as an administrator. 

Configure a VSS provider for all drives

To configure a VSS provider

  1. From the command prompt, run the following command:
vssadmin list providers

Note: Running this command displays a list of VSS providers, and the provider IDs. 

  1. Stop the Hybrid Workloads agent Client service. 
  2. Open the Phoenix.cfg file in a text editor. 
    The Phoenix.cfg file is available at the following location:
    Windows 2012 and 2008: C:\ProgramData\Phoenix
  3. Add the VSS_PROVIDER_ID parameter, and set its value to reflect the provider ID using the following syntax:

VSS_PROVIDER_ID = '{Provider ID}'

For example, if you obtained b5946137-7b9f-4925-af80-51abd60b20d5 as the provider ID, the VSS_Provider_ID parameter looks like this:

VSS_PROVIDER_ID = '{b5946137-7b9f-4925-af80-51abd60b20d5}'

Note: Ensure that there is no whitespace between the curly braces and the single quotation marks.

  1. Save the Phoenix.cfg file.
  2. Start the Hybrid Workloads agent Client service. 

Configure a VSS provider for specific drives

To configure a VSS provider

  1. From the command prompt, run the following command:
vssadmin list providers

Note: Running this command displays a list of VSS providers, and the provider IDs. 

  1. Stop the Hybrid Workloads agent Client service. 
  2. Open the Phoenix.cfg file in a text editor. 
    The Phoenix.cfg file is available at the following location:
    Windows 2012 and 2008: C:\ProgramData\Phoenix
  1. Add the VSS_PROVIDER_ID_VOLUMES parameter, and set its value to reflect the drives for which you want Hybrid Workloads agent to recognize the third-party VSS provider that you configured. 
    Use the following format:
    VSS_PROVIDER_ID_VOLUMES = {"<Drive>": "{<Provider ID>}", "Drive": "{<Provider ID>}"}
    For example, if you obtained b5946137-7b9f-4925-af80-51abd60b20d5 as the provider ID, and you want to set this VSS provider for C drive and D drive respectively, the parameter looks like the following:
    VSS_PROVIDER_ID_VOLUMES = {"C:\\": "{b5946137-7b9f-4925-af80-51abd60b20d5}", "D:\\": "{b5946137-7b9f-4925-af80-51abd60b20d5}"}
  2. Save the Phoenix.cfg file.
  3. Start the Hybrid Workloads agent Client service.