rmbdsp command
Purpose
Removes a backing device or VIOS objects and returns the storage back to the shared storage pool.
Syntax
To remove backing device:
rmbdsp {[-sp StoragePool] -bd BackingDevice | -vtd VirtualTargetDevice} [-savebd][-f]
To remove logical units of the shared storage pool:
rmbdsp -clustername ClusterName -sp StoragePool {-bd LogicalUnit | -luudid LUUDID | -all }
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.
This command also removes logical units within a specified shared storage pool. In this case, the cluster name and the storage pool must be specified. If -bd option is specified, then it will remove the specified logical unit. If the -all option is specified, it will remove all the logical units within the specified shared storage pool.
- If the specified logical unit (LU) is not unique, then the system lists all the LUs with the same name and the user has to pass the LU UDID, which needs to be removed.
- A storage pool must be specified if the backup device name is a file backing device or a VIOS object. The default storage pool is not assumed.
- The logical volume specified for the -bd option cannot be assigned to a shared memory pool because the shared memory pool must 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 is removed.
Flags
Flag name | Description |
---|---|
-all | Specifies to remove all the logical units belonging to a storage pool. |
-bd | Specifies the backing device to be removed. |
-clustername | Specifies the cluster name. |
-f | Forces the file-backed disk meta data file to
be removed. If -savebd is also specified then the backing
device will not be removed. CAUTION: Use this flag only
when the metadata file associated with the file-backed disk is corrupted.
|
-luudid | Specifies the LU UDID in case the specified logical unit name is not unique. |
-savebd | Indicates the backing device should not be deleted. |
-sp | Specifies the storage pool rather than utilizing the default storage pool. |
-vtd | Specifies the virtual target device that maps a backing device to a server virtual SCSI adapter. |
Exit Status
Return code | Description |
---|---|
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 the following command:
rmbdsp -vtd vtscsi4 -savebd
- To remove a logical object within a shared storage
pool, type the following command:
rmbdsp -clustername newcluster -sp viossp -bd lu1
The system displays the following output:
Specified LU is not unique. Please select the LU UDID from the below list.
LU Name Size(MB) LU UDID lu1 10 5fc34cf4172d7cb4143fdea2a9477811 lu1 20 012eccb825ead6dd88377a7f46d4624d lu1 30 8a2db5dd43b6de0480bff8143d37b61d
Type the following command:
The system displays the following output:rmbdsp -clustername newcluster -sp viossp –luudid 5fc34cf4172d7cb4143fdea2a9477811
Logical unit with udid "5fc34cf4172d7cb4143fdea2a9477811" is removed.
- To remove all the logical units within a shared
storage pool, type the following command:
rmbdsp -clustername newcluster -sp viossp -all
Related Information
The lu command.