Using vxprivutil to generate a dump of the Veritas configuration database

book

Article ID: 100028551

calendar_today

Updated On:

Description


The vxprivutil utility is a command-line tool provided by Veritas for low-level access to the private region of VxVM disks. One of its key functions is the ability to generate a human-readable dump of the configuration database stored on a specific disk.

Resolution

 

This article is a part of a set on troubleshooting failed, or failing, disks. Click here to start at the beginning:

https://supportinfoscale.cloud.com/support-home/kbsearch/article?articleNumber=100023549&articleTitle=troubleshooting-failing-disks-missing-disks-and-the-failed-was-status&

 

1. Use vxdisk to get a listing of disk groups, along with the disks that they contain (Figure 1).

Figure 1 - An example of using vxdisk to get a listing of disk groups


Syntax:


vxdisk -o alldgs list


Example, with typical output:


# vxdisk -o alldgs list

DEVICE       TYPE            DISK         GROUP        STATUS
ams_wms0_59  auto:cdsdisk    -            -            error
ams_wms0_60  auto:cdsdisk    proddg02     proddg       online
ams_wms0_61  auto:cdsdisk    proddg03     proddg       online
ams_wms0_62  auto:cdsdisk    proddg04     proddg       online
ams_wms0_63  auto:cdsdisk    -            -            online
disk_0       auto:cdsdisk    -            -            online
disk_1       auto:none       -            -            online invalid
-            -         proddg01     proddg       failed was:ams_wms0_59

 





2. Use the "for" script to generate a list of disks that have an "enabled" copy of the configuration (Figure 2).

Figure 2 - An example of using a "for" script to find an enabled copy of the configuration

 
Syntax:

for i in `vxdisk -o alldgs list | awk '{print $1}'`; do echo $i; vxdisk list $i | grep config | grep enabled; done


Example, with typical output:

# for i in `vxdisk -o alldgs list | awk '{print $1}'`; do echo $i; vxdisk list $i | grep config | grep enabled; done

DEVICE
VxVM vxdisk ERROR V-5-1-558 Disk DEVICE: Disk not in the configuration
ams_wms0_59
ams_wms0_60
 config   priv 000048-000239[000192]: copy=01 offset=000000 enabled
 config   priv 000256-048207[047952]: copy=01 offset=000192 enabled
ams_wms0_61
 config   priv 000048-000239[000192]: copy=01 offset=000000 enabled
 config   priv 000256-048207[047952]: copy=01 offset=000192 enabled
ams_wms0_62
 config   priv 000048-000239[000192]: copy=01 offset=000000 enabled
 config   priv 000256-048207[047952]: copy=01 offset=000192 enabled
ams_wms0_63
 config   priv 000048-000239[000192]: copy=01 offset=000000 enabled
 config   priv 000256-048207[047952]: copy=01 offset=000192 enabled
disk_0
disk_1
-

 





3. Use vxprivutil to dump a copy of the configuration from one of the remaining disks in the disk group that have an "enabled" copy of the configuration (Figure 3).

By default, vxprivutil is located in /etc/vx/diag.d.

Figure 3 - Using vxprivutil to dump a copy of the configuration

 
Syntax:

vxprivutil dumpconfig /dev/vx/rdmp/ > /directory/filename


Example, with typical output:

# /etc/vx/diag.d/vxprivutil dumpconfig /dev/vx/rdmp/ams_wms0_60 > /tmp/ams_wms0_60.cfgrec
 

 

 

 

Issue/Introduction

If vxconfigbackup is unavailable, vxprivutil may be used to generate a dump of the private region.