vxdisk reclaim command fails with non-descriptive error message

Description

Error Message

# vxdisk reclaim 3pardata0_55

Disk 3pardata0_55 : Failed.

Cause

If the 'thin' or 'reclaim' disk attributes are manually turned off, while the disk still contains subdisks pending reclamation, vxdisk reclaim command will fail with above error message.

Also the disk cannot be removed from the disk group, because of pending reclamation and will be requested to run vxdisk reclaim command.

The reclamation failure itself is an expected behavior, since the thin attribute is turned off manually, but it can be misleading due to the non-descriptive nature of the error message displayed by Storage Foundation version 6.0.1 or later.

( EXAMPLE )

# vxdisk list |grep testdg

3pardata0_54 auto:cdsdisk testdg01 testdg online thinrclm

3pardata0_55 auto:cdsdisk testdg02 testdg online thinrclm

# vxprint -z -g testdg

---SNIP---

dm testdg02 3pardata0_55 - 2031232 - - - -

sd testdg02-01 - ENABLED 409600 - RECLAIM - -

sd testdg02-02 - ENABLED 67840 - RECLAIM - -

---SNIP---

# vxdisk set 3pardata0_55 thin=off

# vxdisk list |grep testdg

3pardata0_54 auto:cdsdisk testdg01 testdg online thinrclm

3pardata0_55 auto:cdsdisk testdg02 testdg online

# vxdg -g testdg rmdisk testdg02

VxVM vxdg ERROR V-5-1-16414 Disk testdg02 is used by one or more subdisks which

are pending to be reclaimed.

Use "vxdisk reclaim 3pardata0_55" to reclaim space used by these subdisks,

and retry "vxdg rmdisk" command.

Note: reclamation is irreversible.

# vxdisk reclaim 3pardata0_55

Disk 3pardata0_55 : Failed.

Reclaim log file, /var/adm/vx/reclaim_log will also contain entries with "failed:errno:48" as STATUS.

START_TIME           DURATION(s)  DISKGROUP    VOLUME          DISK         
SUBDISK              OFFSET          LEN             PA_BEFORE       PA_AFTER  

TYPE      STATUS         
2013_06_24 20:31:24  0            testdg     -               testdg02   
testdg02-01        0           67840       4095737856      4095737856
     sd        failed:errno:48

NOTE: In earlier versions of Storage Foundation (up to 6.0), below error message is reported.

# vxdisk reclaim 3pardata0_55

Disk 3pardata0_55 : Skipped. Not a thin reclaimable disk.

Resolution

Clear the manual setting of 'thin' attribute of the disk, to enable ASL discovery of the reclamation attributes.

Then run 'vxdisk reclaim' command to complete the reclamation process.

# vxdisk set thin=clear

This will restore the "thinrclm" attribute flag for the specified disk in 'vxdisk list' output.

( EXAMPLE )

# vxdisk set 3pardata0_55 thin=clear

In case, if the ASL does not discover the reclamation attributes correctly, they can also be set manually using below commands.

# vxdisk set 3pardata0_55 thin=on

# vxdisk set 3pardata0_55 reclaim=on

# vxdisk list |grep testdg

3pardata0_54 auto:cdsdisk testdg01 testdg online thinrclm

3pardata0_55 auto:cdsdisk testdg02 testdg online thinrclm

# vxdisk reclaim 3pardata0_55

Disk 3pardata0_55 : Done.

Note: 'thin=clear' option is not available for Storage Foundation version 6.0 or earlier.

Instead, either rescan the disks with 'vxdctl enable' for ASL discovery or manually set the attribute using below command

before retrying reclaim operation.

# vxdisk set 3pardata0_55 thin=reclaim

# vxdisk reclaim 3pardata0_55

An enhancement request is been made to not allow turning thin flag to off when subdisks are pending for reclaim operation.

Applies To

Systems running Storage Foundation 6.0.1 or later

Issue/Introduction

When trying to relcaim a thin provisioned LUN, the command fails with non-descriptive error as below.

Additional Information

ETrack: 3265566

Welcome to "KB Articles"