subscribe iconSubscribe to this information

rmbdsp command

Purpose

Remove a backing device and return the storage back to the storage pool.

Syntax

rmbdsp {-sp StoragePool-bd LogicalVolume | -vtd VirtualTargetDevice} [-savebd][-f]

Description

The rmbdsp command removes a backing device from a virtual SCSI server adapter by removing its associated virtual target device. By default the backing device is also removed and its storage returned to the storage pool. If the -savebd flag is included then the backing device is not removed. The backing device can be identified by either specifying the name, -bd, or the virtual target device, -vtd. If the backing device is identified by the name, -bd, then the storage pool the device is contained within must also be specified, -sp. If the storage pool is not given the default storage pool is assumed.
Note:
  • A storage pool must be specified if the given backup device name is a file backing device. The default storage pool is not assumed.
  • The logical volume specified for the -bd option cannot be assigned to a shared memory pool (to be used as a paging space device by a shared memory partition).

If -vtd flag is given only the specified virtual target device is removed. If -bd flag is given all virtual target devices associated with the backing device will be removed.

Flags

-bd BackingDevice Specifies the backing device that is the backing device.
-savebd Instructs the command not to remove the backing device.
-sp Specifies the storage pool the backing device is within.
-vtd VirtualTargetDevice Specifies the virtual target devices that associate the backing device with the virtual SCSI adapter.
-f Forces the metadata file associated to the file-backed disk to be removed. If you also specify the -savebd flag, the backing device will not be removed.
CAUTION:
Only use this flag if the metadata file associated to the file-backed disk is corrupt.

Exit Status

25 Specified logical volume is not a backing device.

Examples

To remove the virtual target device vtscsi4 and not remove the backing device associated with it, type:
rmbdsp -vtd vtscsi4 -savebd

Send feedback | Rate this page

Last updated: Fri, Oct 30, 2009