Decommission actions

The nbdecommission command deletes the configuration for the old server from the EMM database, the NetBackup image catalog, and configuration files on servers.

Table: nbdecommission command actions shows the actions it performs for the components that reference the media server. The table is organized in the order in which the command processes the component.

Table: nbdecommission command actions

Component

Action

Storage unit - Tape

Deletes the following tape storage units:

  • Those in which the Storage device attribute specifies a robot for which the old server is the robot control host.

  • Those in which the Media server attribute specifies the old server.

  • Those in which the Media server attribute specifies Any Available and the old server is the only server that can access the storage unit.

Tape drive

For each tape drive that is attached to the old server, deletes the tape drive path. If the path on the old server is the only path, also deletes the tape drive.

If a path to a drive exists on more than one media server, the tape drive may become unusable. You may have to connect the tape drive to a different media server and then reconfigure it in NetBackup. For example, if the old server is a scan host for a shared drive, NetBackup cannot use the drive if no other host can scan.

Robotic library

Deletes all of the robotic libraries that are attached to the old server.

If the old server is the robot control host for a shared library, the drives and media become stand-alone and unusable. You must reconfigure and re-inventory the library.

Tape media

You can choose to expire the following tape media or move them to another media server:

  • Those assigned to the old server.

  • Those owned by a media sharing group in which the old server is the only member of the group.

  • Those that have no specific Media owner and the last write host is same as the old server.

Storage unit - BasicDisk

If no images exist on the storage unit, deletes it. If images exist, the wizard lets you choose to do one of the following:

  • Expire the images and delete the storage unit.

  • Move the images to the new server. The wizard also updates the Media server field in the storage unit.

    The BasicDisk storage must be shared, and the same disk path must be available on the new server.

Storage unit - Nearstore

If no images exist on the storage unit, deletes it. If images exist, the wizard lets you choose to do one of the following:

  • Expire the images and delete the storage unit.

  • Move the images to a new server. The wizard also transfers the credentials to the new server and updates the Media server field in the storage unit.

Storage unit - SnapVault

If no images exist on the storage unit, deletes it. If images exist, the wizard lets you choose to do one of the following:

  • Expire the images and delete the storage unit.

  • Move the images to a new server. The wizard also transfers the credentials to the new server and updates the Media server field in the storage unit.

Storage unit - AdvancedDisk and SharedDisk

If more than one media server can access the disk pool that is the destination of the storage unit, does the following:

  • Removes the old server from the Media Servers list of the storage unit.

  • Deletes the old server as a storage server.

If the old server is the only server that can access the disk pool, the wizard lets you choose to do one of the following:

  • Move the storage and images to the new server and delete the old server as a storage server.

    The disk volumes must be available on the new server at the same path as the old server.

  • Expire the images (if any), delete any storage units that reference the disk pool, delete the disk pool, and delete the storage server. (A reference is when the disk pool appears in the Disk pool setting of a storage unit.)

Storage unit - OpenStorage

If more than one media server can access the disk pool that is the destination of the storage unit, does the following:

  • Removes the old server from the Media Servers list of the storage unit.

  • Deletes the media server as an OpenStorage storage server.

If the old server is the only server that can access the disk pool, the wizard lets you choose to do one of the following:

  • Transfer the credentials to the new server and update the Media server field in the storage unit if required.

  • Expire the images (if any), delete any storage units that reference the disk pool, and delete the disk pool. (A reference is when the disk pool appears in the Disk pool setting of a storage unit.)

Storage unit group

If the nbdecommission command deletes all of the storage units in a storage unit group, it also deletes the storage unit group. Deleting the storage unit group also may affect backup policies and storage lifecycle policies.

See "Backup policy and schedule" and "Storage lifecycle policy" in this table.

Backup policy and schedule

Deactivates any backup policy in which the storage destination (directly or indirectly) is a storage unit that the command deletes. Specifically, deactivates any backup policy that meets any of the following conditions:

  • The destination is a storage unit that the nbdecommission command deleted.

  • The destination is a storage unit group that contains only one storage unit and the nbdecommission command deleted that storage unit.

  • The destination is a storage lifecycle policy and the nbdecommission command deleted the storage unit that is a Backup destination of the storage lifecycle policy.

Storage lifecycle policy

For each storage lifecycle policy in which one or more destinations is a storage unit the command deleted, does the following:

  • If images under the SLP control are in-process or yet to be processed, displays the commands to cancel the SLP jobs and then exits. After you cancel the jobs (or wait until the jobs complete), rerun the nbdecommission command to continue with the decommissioning.

  • If all of the images under SLP control are processed, deactivates the storage lifecycle policy.

  • If a deleted storage unit is a Backup or Snapshot destination, deactivates all backup policies with the storage lifecycle policy as the destination.

Fibre Transport media server

Displays the commands necessary to delete the old server as an FT media server and then exits.

After you delete the old server as an FT media server, rerun the nbdecommission command to continue with the decommissioning.

bp.conf file

On UNIX NetBackup servers, removes the old server from the following bp.conf file entries:

  • SERVER

  • MEDIA_SERVER

  • CLIENT_NAME

  • BROWSER

On UNIX master servers, also removes the old server from the FORCE_RESTORE_MEDIA_SERVER and FAILOVER_RESTORE_MEDIA_SERVERS entries.

Windows registry

On Windows NetBackup servers, removes the old server from the following registry keys:

  • SERVER

  • MEDIA_SERVER

  • CLIENT_NAME

  • BROWSER

On Windows master servers, also removes the old server from the FORCE_RESTORE_MEDIA_SERVER and FAILOVER_RESTORE_MEDIA_SERVERS keys.

Clients

Lists the clients on which the old server appears in their server lists. You must remove the references to the old server manually.