disk remove
Removes a disk from file system. Permissions required:
fc
or a
.
The disk remove
command does not remove a disk containing unreplicated
data, unless forced. To force disk removal, specify -force
with the
value 1
or true
.
NOTE
- Use the
-force 1
, or the equivalent-force true
option only if you are sure that you do not need the data on the disk. This option removes the disk without regard to the replication factor or other data protection mechanisms, and may result in permanent data loss. - Removing a disk in the storage pool that contains Container ID 1 stops the
cluster. Container ID 1 contains CLDB data for the master CLDB. Run
disk remove
without the-force 1
, or the equivalent-force true
option first, and examine the warning messages to make sure that you are not removing the disk with Container ID 1. If you try to remove a disk associated with the storage pool that contains Container ID 1, you receive an error message similar to the following:ERROR (151) - Failed operation for disk /dev/sdb, Operation may bring down cluster due to loss of cluster meta-data.
To safely remove such a disk, first perform a CLDB Failover to make one of the other CLDB nodes the primary CLDB, and then remove the disk as normal.TIPIf necessary, run the following command for information on the disk associated with the storage pool that contains Container ID 1:
The command output may look similar to the following:/opt/mapr/server/mrconfig info dumpcontainers | grep cid:1
cid:1 volid:1 sp:SP1:/dev/sdb spid:82380c287085486f0058112ecf016b76 prev:0 next:0 issnap:0 isclone:0 deleteinprog:0 fixedbyfsck:0 stale:0 querycldb:0 resyncinprog:0 shared:0 owned:206 logical:206 snapusage:0 snapusageupdated:1 ismirror:0 isrwmirrorcapable:0 role:1 maxUniq:2100150 isResyncSnapshot:0 snapId:0 port:5660
Syntax
- CLI
-
maprcli disk remove -host name/ip -disks comma-separated list of disks [ -force <true|false OR 1|0>. Required to remove the disk when errors have been reported; otherwise, the command behaves like a test remove when errors are reported. If -force is set to false and there are no errors, the disk is removed. Default: false ] [ -cluster cluster_name ]
- REST
Request Type POST Request URL http[s]://<host>:<port>/rest/disk/remove?<parameters>
Parameters
Parameter | Description |
---|---|
host |
(Required) The hostname or IP address of the node from which to remove the disk. |
disks |
(Required) A list of disks in the
form:
|
force |
(Optional) Whether to force disk removal.
|
cluster |
(Optional) The cluster on which to run the command. By default, this is the cluster on which this command is run. |
Output
Output Fields
Field |
Description |
---|---|
|
The name of a disk or partition. Example: |
|
The string |
|
A comma-separated list of disks which have non-replicated volumes. For example, "sca" or "sca/sca1,scb" |
Examples
Remove a disk:
/opt/mapr/bin/maprcli disk remove -disks /dev/sda
NOTE
When using a self-signed certificate, pass the -k
option to
curl
to avoid the certificate check.curl -k -u <username> -X POST https://abc.sj.us:8443/rest/disk/remove?disks=["/dev/sda"]