Decommissioning NetBackup host fails with status code 8705

Problem

The user is unable to decommission the NetBackup host using the Web UI, CLI, or API, as the operation consistently fails with status code 8705.

Error Message

The specified host is not a NetBackup client and cannot be decommissioned with the given option.

Cause

The host undergoing decommissioning is not solely a client host; it also has additional roles and responsibilities, such as media server, appliance, remote primary, remote media, WORM storage roles etc. The user must first remove these additional roles and responsibilities from the host. Once these roles have been removed, the host will revert to a client-only role, allowing it to be decommissioned and removed from the NetBackup domain.

Solution

Please run the appropriate command to remove the additional roles from the host before decommissioning:

First, run the ‘nbemmcmd -listhosts’ command on the primary server to identify the roles assigned to the host.

Note that a single host may have multiple roles, all of which must be removed before decommissioning.

• If the assigned role is media, foreign_media, ndmp, and/or replication_host, execute the ‘nbdecommission’ command on the primary server for each role to remove it.
• Example,
  • For media server, 'nbdecommission -oldserver <media_server_name> -machinetype media'
  • For replication host, 'nbdecommission -oldserver <replication_host_name> -machinetype replication_host'
  • For foreign media server, 'nbdecommission -oldserver <foreign_media_server_name> -machinetype foreign_media'
  • For ndmp, 'nbdecommission -oldserver <ndmp_host_name> -machinetype ndmp'
• If the assigned role is remote_master_server, run the ‘nbseccmd -setuptrustedmaster -remove -remotemasterserver’ command on the primary server to remove the role.
• For any other roles, use the ‘nbemmcmd -deletehost’ command on the primary server for each role to be removed.
• Example 
  • For app_cluster, run the command `nbemmcmd -deletehost -machinename <app_cluster_server_name> -machinetype app_cluster' 
  • For appliances, run the command `nbemmcmd -deletehost -machinename <appliance_host_name> -machinetype appliance'