NetWorker: How to Decommission A VBA appliance after all save sets expire

Summary: This KB details the process required to completely decommission and remove the VMware Backup Appliance (VBA). The VBA appliance is no longer supported. It was replaced by the NetWorker VMware Protection (NVP) vProxy appliance. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Assumptions before proceeding:

  • The primary backup and clone save sets have expired for the VBA.
  • The remaining primary and clone save sets have been removed from the NetWorker Data Zone using the nsrmm command-line utility.
NOTE: Starting in NetWorker 19.7.x, it is no longer possible to recover VBA save sets using the vProxy appliance. NetWorker 19.7 is End of Support Life (EOSL) as of 2025-06-30.


Prerequisites:

Before proceeding with this KB, ensure that a copy or backup is completed of the NetWorker resource configurations:

  1. Ensure the NetWorker server has a recent bootstrap backup by performing a Server Protection backup. Bootstrap save set details can be collected from a root or Administrator prompt on the NetWorker server using: mminfo -B
  2. Manually copy the NetWorker resource database directory.
    • Windows: [INSTALL_DIR]\Program Files\EMC NetWorker\nsr\res\nsrdb
    • Linux: /nsr/res/nsrdb
  3. Manually copy the backup media directory:
  • Windows: [INSTALL_DIR]\Program Files\EMC NetWorker\nsr\mm
  • Linux: /nsr/mm
NOTE: If the media database is large, it can be exported to an .xdr file; however, support engagement is required to re-import the mm.xdr if needed: How To Export the NetWorker Media Database Using nsrmmdbasm

Process:

NOTE: As this process involves potential data deletion, it is not appropriate for NetWorker support to perform these steps. These steps must be completed by the NetWorker backup administrator only. If you would like assistance beyond this KB, engage your Dell Sales Account rep for Professional Services engagement.

1. Validate all remaining save sets for the VBA. This can be done using one of the following options:

NetWorker Management Console (NMC)

a. Log in to NetWorker Management Console (NMC)
b. Go to the Media tab and select Save Sets, then select VMware Backup Appliance Online as shown below:

NMC VBA save sets
WARNING: Do NOT select any VBA that you do NOT want to delete.

c. Then for the Query Save Set tab, select only the required entries in the VBA Name that you want to find the information for. Keep in mind that the goal is to query the information for this particular VBA node so it can be deleted. The below example shows that vbalabnode2x.vba.lab was selected to be queried: 
Query VBA save sets 
d. Now change the Save Time From to select an approximate time frame when VBA was initially deployed. The example below shows the 'From' value being changed to 2012-06-01:
Save set date range
e. After selecting the appropriate query parameters, click the Save Set List tab. View the output to ensure that all data save sets in this output belong to the VBA you intend to delete. The example below shows the VBA vbalabnode2x.vba.lab  data being displayed:
save sets list

mminfo command

a. Open a root session or Administrator command prompt on the NetWorker server and run the following mminfo command.
Syntax: mminfo -c vba-name -kot
For Example: To find all backups for VBA named 'vbalabnode2x.vba.lab', run query:

mminfo -c vbalabnode2x.vba.lab  -kot
..
 volume        type   vm_name         date     time         size ssid      fl backup_size
dd2x15.001  Data Domain VM2      6/22/2015 7:49:57 AM   41 GB xxxxx cr  41 GB
dd2x15.001  Data Domain VM1      6/22/2015 7:53:52 AM   41 GB xxxxxx cr  41 GB
dd2x15.001  Data Domain VM2      6/22/2015 7:54:02 AM   41 GB xxxxxx cr  41 GB


2. Remove the VBA save sets identified in step 1.

  • Option 1: If the VBA is online and if there is a unique volume where all the SSIDs are stored, that is there is no other data on this volume- you can delete this volume
  • Option 2: If the VBA is online and if there is no unique volume that contains all the SSID, then you can use nsrmm command to delete the individual Save sets. Syntax:  nsrmm -d -S SSID
For Example: The nsrmm execution shows:
nsrmm -d -S 4253582084
Delete file and media index entries for save set `4253582084'? y
98999:nsrmm: Save set 4253582084 has been successfully deleted from VBA server 'vbalabnode2x.vba.lab'
CAUTION: The above command deletes one save set at a time. Take extreme caution to ensure that you delete only the save sets that belong to the VBA that is intended to be deleted.
  • Option 3: If the VBA is NOT online, then use the -X option to delete the Save set:
nsrmm -X -d -S <SSID>
 
For Example: nsrmm -X -d -S 4237053710
Delete file and media index entries for save set `4237053710'? y

Extra details on save set deletion can be found in: How to delete Multiple or Individual SSIDs?

3. Remove all workflows associated with the VBA:

a. Log in to NMC
b. Go to the Configuration tab and click VMware Protection Policies. 
c. Sort the policies by VBA List. 
d. Open the first policy that has this VBA listed, go to VMware Backup Appliance Selection tab and clear the VBA name.
TIP: You may get a prompt:
Remove the VBA
e. Wait for the State column to change to Success. 
f. [Optional] If you no longer need to back up a particular vCenter server. Log in to nsradmin and delete nsr hypervisor as per the below instructions:
On the NetWorker server, open a shell and enter  nsradmin  to get to the prompt.
nsradmin> p type: nsr hypervisor; name: vcenter-name
For Example: Below is the example of delete a reference to vCenter named VC4.vba.lab 
nsradmin> p type: nsr hypervisor; name: VC4.vba.lab 
type: NSR hypervisor
name: VC4.vba.lab;
comment: ;
service: VMware VirtualCenter;
endpoint: "https://VC4.vba.lab/sdk";
username: administrator@vba.lab;
password: *******;
command: nsrvim;
proxy: nw4;
nsradmin> d
Delete ? yes
NOTE: This step may need to be done using offline nsradmin if VBA is NOT responding. In order to access nsradmin "offline" run, nsradmin -d absolute path to nsrdb folder. A service restart is required in order for changes to apply.


4Delete VBA MTree:

a. On the NetWorker server, run the below nsradmin commands to find the VBA DPN ID:

nsradmin> show name
nsradmin> show DPN ID
nsradmin> p type: nsr vba server; name: <VBA-FQDN>

Example output:

nsradmin
NetWorker administration program.
Use the "help" command for help, "visual" for full-screen mode.
nsradmin> show name
nsradmin> show DPN ID
nsradmin> p type: nsr vba server; name: vbalabnode2x.vba.lab
                        name: vbalabnode2x.vba.lab;
                      DPN ID: xxxxxxxxxxx;

Make note of the DPN ID. This helps us determine the storage unit, for example, for the above DPNID, the storage unit is 'avamar-1435099427'.

b. Log in to a Data domain system using PuTTY(or similar SSH utility) as a user with an 'admin' role. Then run below command to delete:

ddboost storage-unit delete <storage-unit>
Example: ddboost storage-unit delete avamar-1435099427

c. [Optional] Start a file system clean on data domain to reclaim space:

filesys clean start

4. Remove VBA server resources using nsradmin:

Note: This step is to be performed ONLY for the VBA you want to delete. Take caution and make a copy of the nsrdb, if this has not been done already.

Syntax: nsradmin> d type: NSR VBA Server;  name: vbalabnode2x.vba.lab
For Example: The below example shows a command to delete a VBA called vbalabnode2x.vba.lab 

nsradmin> d type: NSR VBA Server;  name: vbalabnode2x.vba.lab
type: NSR VBA Server;
name: vbalabnode2x.vba.lab;
comment: ;
vCenter Host: vbalabnode2x.vba.lab;
 vCenter Web Client Host: ;
 Total Capacity: ;
 Total Capacity in bytes: ;
 Used Capacity: ;
Last Validated Checkpoint: ;
 Last Validated Checkpoint Tag: ;
Online: ;
VBA Version: ;
Policy List: ;
Policy Client Mapping: ;
External Proxy Hosts: ;
VBA recover checkpoint tag: ;
configuration error: ;
VBA Internal Proxies: Enabled;
VBA Adhoc Backups: Enabled;
VBA Restrict Transport Mode to Hotadd Only: Disabled;
Staging DDR pool for Disaster recovery from non-DDR devices: ;
Delete? Y
deleted resource id 156.x.xxx.x.x.x.x.x.xxx.xxx.xxx.xx.xx.xxx.x.x(7)
NOTE: This step may need to be done using offline nsradmin if VBA is NOT responding. In order to access nsradmin "offline" run, nsradmin -d absolute path to nsrdb folder. A service restart is required in order for changes to apply.

5. Remove client resource for that VBA from NMC.

Syntax:  nsradmin> d type: nsr client; name : vbalabnode2x.vba.lab
For Example: The below example shows how to delete client for vbalabnode2x.vba.lab 

nsradmin> d type: nsr client; name : vbalabnode2x.vba.lab
type: NSR client;
name: vbalabnode2x.vba.lab;
server: nw4.vba.lab;
client id: xxxx-xxxxx-xxxxx-xxxx-0xxxxx-xxxxx;
Delete? Y
deleted resource id 153.x.xxx.x.x.x.x.x.xxx.xx.xxx.xx.xx.xxx.x.x3)

6. Delete the VBA Appliance VM:

You can now delete the relevant VBA VM and external proxies from the vCenter server.

Affected Products

NetWorker Family, NetWorker
Article Properties
Article Number: 000165219
Article Type: How To
Last Modified: 25 Jun 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.