"VCS error v-16-10031-1009" reported when attempting to import diskgroup for VxVM

book

Article ID: 100020690

calendar_today

Updated On:

Description

Error Message

The following error is reported in the engine_A.log while attempting online of the resource

VCS error v-16-10031-1009 : :online:could not find diskgroup imported.

Cause

In a GCO environment where HDS TrueCopy technology is used to replicate between clusters, the HTC agent can be used to control this replication.

In a CVM environment the importing of replicated diskgroups can fail if the HTC resource is incorrectly configured.

The importing of CVM disk groups is done by the CVM Cluster resource. CVM uses the following criteria when importing disk groups:
- Shared flag is set
- Hostid flag is populated with the clusterID as set in the main.cf
As the hostid flag (referred to as the clusterID flag when the disk group is marked as shared) is held in the private region of a disk group, it will be replicated to the destination cluster. Therefore, by default CVM on the destination cluster will not import this disk group.
 
In order to allow the import of CVM groups, HTC takes control of import/deport of cvm groups. In order to do this the following needs to be configured:
- The Supported Actions must be set on the CVMVolDg agent (as documented on the HTCAgent Guide)
- The HTC resource must be the immediate child of the CVMVolDG resource
 
When the above is set, it is the HTC resource and not the cvm_clus resource that will import and deport the shared disk group. The disk group that the HTC resource will control is the one defined in it's parent CVMVolDg resource.
 
A side-effect of the HTC resource taking control in this way is that when the diskgroup is deported on all nodes, it will not show with the 'shared' flag.

Resolution

In order to set the Supported Actions the following command may be used:
 
hatype-modify CVMVolDg SupportedActions import deport vxdctlenable
 
Ensure the resource dependency for the CVMVolDg and HTC resources resembles the following:
CVMVolDgcvcvoldg1 (
CVMDiskGroup= sharedg
CVMVolume ={ vol1 }
CVMActivation@host1 = sw
CVMActivation@host2 = sw
)
HTC htc1(
GroupName =share
Instance =10
)
cvmvoldg1requires htc1
And the overall resource dependency should look as mentioned bellow:
CVMVolDg-> HTC-> CFSfsckd -> CVMCluster -> CVMVxconfigd
 
 

 

Issue/Introduction

When attempting to import a diskgroup, that was previously deported, the following import fails and need manual intervention to import the diskgroup

Error Message

The following error is reported in the engine_A.log while attempting online of the resource VCS error v-16-10031-1009 <node_name> <resource_type>: <resource_name>:online:could not find diskgroup <diskgroup_name> imported.