Defects in nbdecommission will result in removal of more credentials than intended when the command is used to remove a media server with MSDP credentials. Storage units may also be removed. EEBs are available.

Severity

Data Loss

Description

Document history

DateDescription
18 December 2015Initial publication
2 February 2016Updated to include fix availability in a released version
24 March 2017Updated to clarify that the fix is included in 8.0 and patches are available for earlier versions

 

Affected versions

These defects (Etracks 3843887, 3862454, 3878426, 3882313) potentially affect the following versions of NetBackup and NetBackup Appliance:

NetBackupNetBackup Appliance
7.6.1.22.6.1.2
7.7N/A
7.7.12.7.1
7.7.22.7.2
7.7.32.7.3


When using nbdecommission to remove a media server with credentials for a Media Server Deduplication Pool (MSDP), ALL credentials for ALL storage servers are removed.

Depending on configuration, storage units for other OST (OpenStorage Technology) vendors will also be removed when the media server being decommissioned had credentials to that storage server as well.

 

Example of this issue

Suppose an enterprise has two media servers in use:
  • knothead is a media server which is not being decommissioned
  • heisenberg is a media server which is being decommissioned
  • both servers have Media Server Deduplication
  • each server is the fingerprint server to the other
  • each has credentials to a DataDomain storage server
 
# nbdecommission –oldserver heisenberg

Storage Server: knothead
Server Type: PureDisk (9)
Disk Pool: dp_k_msdp
Media Server: knothead
Media Server: heisenberg
Disk pool dp_k_msdp (PureDisk) is referenced by the following storage units:
    dp_k_msdp-stu



Storage Server: heisenberg
Server Type: PureDisk (9)
Disk Pool: dp_h_msdp
Media Server: knothead
Media Server: heisenberg

Processing OST host credentials
<- first defect
Deleting OST specific creds for STS host knothead, Media Server knothead
Deleting OST specific creds for STS host heisenberg, Media Server knothead
Deleting OST specific creds for STS host datadomain670a.example.com, Media Server knothead


The resulting action should not have removed knothead from knothead (MSDP storage server) and also should not have removed knothead from datadomain670a (DD storage servr).

Disk pool dp_h_msdp (PureDisk) is referenced by the following storage units:
    dp_h_msdp-stu


Storage unit dp_h_msdp-stu: host heisenberg
De-activating policies using storage unit dp_h_msdp-stu
Deleting storage unit dp_h_msdp-stu on host _STU_NO_DEV_HOST_
Deleted storage unit dp_h_msdp-stu
Deleted PureDisk disk pool dp_h_msdp
Deleted PureDisk storage server heisenberg

Storage Server: datadomain670a.example.com
Server Type: DataDomain (9)
Disk Pool: dp_dd670a
Media Server: knothead
Media Server: heisenberg
Disk pool dp_dd670a (DataDomain) is referenced by the following storage units:  
    dp_datad670a-stu


Storage unit dp_datad670a-stu: host heisenberg
<- second defect
De-activating policies using storage unit dp_datad670a-stu                      
Deleting storage unit dp_datad670a-stu on host _STU_NO_DEV_HOST_ <==            
Deleted storage unit dp_datad670a-stu

Action Required

A fix for this issue is included in NetBackup 8.0. Patches are available for earlier versions.

Workaround

If updating to a resolved version is unfeasible, before using nbdecommission, please contact Veritas technical support, referencing this document and Etrack 3862454 (7.6.1.2), 3843887 (7.7.1), 3878426 (7.7.2) or 3882313 (7.7.3) to obtain an Emergency Engineering Binary (EEB) containing a fix for this issue.

If nbdecommission has already been run and credentials were unintentionally removed, please contact Veritas technical support, referencing this document ID, for further instructions on restoring lost credentials.


Best Practices

Veritas recommends the following best practices:
1. Always perform a full DR backup prior to making any changes to your environment.
2. Always make sure that your environment is running the latest version and patch level.
3. Perform periodic "test" restores.
4. Subscribe to technical articles.
 

How to Subscribe to Email Notification

  • Directly to this Article: Subscribe to this article by clicking on the Subscribe to this Article link on this page to receive notification when this article is updated with Release Information.
  • Software Alerts: Click on the Related Articles link to find a link to the Article Notification of new NetBackup Technical Alerts.  Subscribe to that Article to receive notifications of new NetBackup Technical Alerts.

Terms of use for this information are found in Legal Notices.

Search

Survey

Did this article answer your question or resolve your issue?

No
Yes

Did this article save you the trouble of contacting technical support?

No
Yes

How can we make this article more helpful?

Email Address (Optional)