Article:HOWTO72806  |  Created: 2012-02-13  |  Updated: 2012-11-30  |  Article URL http://www.symantec.com/docs/HOWTO72806
Article Type
How To





nbdecommission — decommission an old server


nbdecommission -list_ref -oldserver hostname [-reason "string"]

nbdecommission -oldserver hostname [-newserver hostname] [-file decom_ops.txt] [-reason "string"]


On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd

On Windows systems, the directory path to this command is <install_path>NetBackup\bin\admincmd


The nbdecommission utility helps the user view all the references of an old server and provides help through the decommissioning process. The -list_ref -oldserver hostname option displays all that is associated with the old server, which allows users to break the associations on their own. This option does not decommission the server.

The -oldserver hostname [-newserver hostname] option provides detailed guidance to decommission the old server. You can run the command on the master server or any server that is not decommissioned. The decommissioning process is clean and removes old media server entries in the EMM DB and the bp.conf file which can slow down backup operations. The command does not assume that the old server is up and responsive. The optional -newserver lets you specify a replacement server for the old server.


Be careful when you use the nbdecommission command. Because the command may expire images, data loss may occur. Therefore, you should understand completely what the command does before you use it. Symantec recommends that you first preview all of the references to a media server before you decommission it.

For more information about decommissioning a media server, please see the NetBackup Administrator's Guide, Volume I, available from the following location:



-file decom_ops.txt

Writes the command operations to the specified file. Replace decom_ops.txt with a name that denotes its purpose or contents. You can use the -file option to maintain a record of the command operations.

-list_ref -oldserver hostname

Displays the items that are associated with the old server. Use this option to break the associations yourself.

-newserver hostname

Specifies a new server to replace the old server that is to be decommissioned. If you specify a new server, it becomes the default media server for the replacement operations.

-oldserver hostname

Initiates detailed guidance in decommissioning the old server. The command can be run on the master server or any server that is not decommissioned. It does not assume that the old server is up and responsive.

-reason "string"

Indicates the reason for performing this command action. The reason text string that you enter is captured and appears in the audit report. Enclose the string with double quotes ("...") and the string cannot exceed 512 characters. It cannot begin with a dash character (-) nor contain a single quotation mark (').

Legacy ID


Article URL http://www.symantec.com/docs/HOWTO72806

Terms of use for this information are found in Legal Notices