Veritas NetBackup™ Commands Reference Guide
- Appendix A. NetBackup Commands
nbdecommission — decommission an old media server, NDMP host, or replication host
[-list_ref | -newserver hostname [-bulk_media_move] [-file op_dump_file]]
[-machinetype [media | foreign_media | ndmp | replication_host]
[-M master_server] [-reason "reason"] [-v]
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 is an interactive tool that assists in disabling, removing, or identifying policies, storage units, backup images, storage lifecycle policies, and storage devices so that a media server, NDMP host, or a replication host can be retired or replaced. 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 or replication host entries in the EMM database 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. The -newserver option is not valid for the replication_host machine type.
Replication hosts are unique in that they are not a host in the local NetBackup domain. Rather, a replication host is a storage server in the target or the source domain of a replication relationship. The nbdecommission utility guides the removal of the replication relationship(s) with the storage server in the local domain, not the actual storage server in the remote domain.
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. Veritas recommends that you first preview all of the references to a media server, NDMP host, or replication host before you decommission it.
- -file decom_ops.txt
Writes the command operations to the specified file. Replace decom_ops.txt with a name that signifies 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 or to view existing associations.
The type of the server that you want to decommission. List one of the following types: media, foreign_media, ndmp, or replication_host.
If not provided, nbdecommission automatically determines the type of server.
- -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 or NDMP host for the replacement operations.
This option is not valid for the replication host machine type.
- -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. This option 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 (').