Veritas Volume Manager 5.0 MP3 RP4 HF1 (Solaris) enables LUN suppression and inclusion using "vxdmpadm [ include | exclude ] vxvm dmpnodename=<da-name>"

book

Article ID: 100002261

calendar_today

Updated On:

Cause


Reproduction steps:


1.] Ensure Veritas Volume Manager 5.0 MP3 RP4 is installed.


# modinfo | grep vx
28  12f47f8  3fdc0 270   1  vxdmp (VxVM 5.0MP3RP4: DMP Driver)
30 7be00000 211590 271   1  vxio (VxVM 5.0MP3RP4 I/O driver)
32 7bff0428    c78 272   1  vxspec (VxVM 5.0MP3RP4 control/status d)
208 7b796f60    cb0 268   1  vxportal (VxFS 5.0_REV-5.0MP3RP4g_sol por)
209 7aa00000 1dd7d0  20   1  vxfs (VxFS 5.0_REV-5.0MP3RP4g_sol Sun)


2.] Install the VxVM 5.0 MP3 RP4 HF1 hot-fix (Solaris sparc).


# patchadd 144169-01
Validating patches...

Loading patches installed on the system...

Done!

Loading patches requested to install.

Done!

Checking patches that you specified for installation.

Done!


Approved patches will be installed in this order:

144169-01


Checking installed patches...
Verifying sufficient filesystem capacity (dry run method)...
Installing patch packages...

Patch 144169-01 has been successfully installed.
See /var/sadm/patch/144169-01/log for details

Patch packages installed:
 VRTSvxvm


3.] Reboot the server.


4.] Confirm the VxVM module content has been updated following the reboot.


# modinfo | grep vx
31  1300860  3fdc0 270   1  vxdmp (VxVM 5.0MP3RP4HF1: DMP Driver)
33 7be00000 211650 271   1  vxio (VxVM 5.0MP3RP4HF1 I/O driver)
35 7bff04e8    c78 272   1  vxspec (VxVM 5.0MP3RP4HF1 control/statu)
209 7b3674a8    cb0 268   1  vxportal (VxFS 5.0_REV-5.0MP3RP4g_sol por)
210 7aa00000 1dd7d0  20   1  vxfs (VxFS 5.0_REV-5.0MP3RP4g_sol Sun)



5.] Suppress a VxVM device using "vxdmpadm include|exclude vxvm dmpnodename=".


a.] In this instance, Veritas disk access name (da) "emc_clariion0_31" will be suppressed.


# vxlist disk
TY   DEVICE             DISK        DISKGROUP          SIZE       FREE STATUS
disk disk_0             c2t0d0      rootdg           68.32g    854.62m imported
disk emc_clariion0_3    -           -                     -          - notsetup
disk emc_clariion0_31   -           -                 2.13t          - free                              <<<< LUN to be suppressed
disk emc_clariion0_78   -           -                69.96g          - free
disk emc_clariion0_79   -           -                     -          - notsetup
disk emc0_00ea          -           (bcvdg)           2.07g          - foreign
disk emc0_00eb          -           -                     -          - notsetup



b.] Disk suppression vxdmpadm CLI syntax:


# vxdmpadm exclude vxvm dmpnodename=emc_clariion0_31


c.] Following the execution of the above command, the /etc/vx/vxvm.exclude file is updated with all the corresponding paths for the specified Veritas disk access (da) name.


# more /etc/vx/vxvm.exclude
exclude_all 0
paths
c1t500601603021C60Ed1 /dev/rdsk/c1t500601603021C60Ed1 emc_clariion0_31
c1t500601693021C60Ed1 /dev/rdsk/c1t500601693021C60Ed1 emc_clariion0_31
c1t500601683021C60Ed1 /dev/rdsk/c1t500601683021C60Ed1 emc_clariion0_31
c1t500601613021C60Ed1 /dev/rdsk/c1t500601613021C60Ed1 emc_clariion0_31
c5t500601613021C60Ed1 /dev/rdsk/c5t500601613021C60Ed1 emc_clariion0_31
c5t500601693021C60Ed1 /dev/rdsk/c5t500601693021C60Ed1 emc_clariion0_31
c5t500601683021C60Ed1 /dev/rdsk/c5t500601683021C60Ed1 emc_clariion0_31
c5t500601603021C60Ed1 /dev/rdsk/c5t500601603021C60Ed1 emc_clariion0_31
#
controllers
#
product
#
pathgroups
#


d.] Confirm that the Veritas disk access (da) name has been suppressed.


In this instance, Veritas disk acess (da) name "emc_clariion0_31" has been suppressed.



# vxdisk list emc_clariion0_31
VxVM vxdisk ERROR V-5-1-558 Disk emc_clariion0_31: Disk not in the configuration


# vxdisk list
DEVICE       TYPE            DISK         GROUP        STATUS
disk_0       auto:sliced     c2t0d0       rootdg       online
emc_clariion0_3 auto            -            -            error
emc_clariion0_78 auto:sliced     -            -            online
emc_clariion0_79 auto            -            -            nolabel
emc0_00ea    auto:sliced     -            -            online
emc0_00eb    auto            -            -            error


6.] Reverse the disk suppression.


a.] The previously suppressed Veritas disk access (da) name "emc_clariion0_31" will be unsuppressed using the vxdmpadm CLI syntax.


# vxdmpadm include vxvm dmpnodename=emc_clariion0_31


b.] The /etc/vx/vxvm.exclude file contents are refelected following the execution of the above command.


# more /etc/vx/vxvm.exclude
exclude_all 0
paths
#
controllers
#
product
#
pathgroups
#


c.] Confirm that the Veritas disk access name has been unsuppressed.


#  vxdisk list emc_clariion0_31
Device:    emc_clariion0_31
devicetag: emc_clariion0_31
type:      auto
hostid:
disk:      name= id=1277725433.70.rhino
group:     name= id=
info:      format=sliced,privoffset=1,pubslice=4,privslice=3
flags:     online ready private autoconfig autoimport
pubpaths:  block=/dev/vx/dmp/emc_clariion0_31s4 char=/dev/vx/rdmp/emc_clariion0_31s4
privpaths: block=/dev/vx/dmp/emc_clariion0_31s3 char=/dev/vx/rdmp/emc_clariion0_31s3
guid:      -
udid:      DGC%5FRAID%205%5FCK200053300424%5F60060160E8341600424F05AE575FDF11
site:      -
version:   2.1
iosize:    min=512 (bytes) max=2048 (blocks)
public:    slice=4 offset=0 len=4582195132 disk_offset=65570
private:   slice=3 offset=1 len=65535 disk_offset=34
update:    time=1277725437 seqno=0.2
ssb:       actual_seqno=0.0
headers:   0 248
configs:   count=1 len=48345
logs:      count=1 len=7325
Defined regions:
config   priv 000017-000247[000231]: copy=01 offset=000000 disabled
config   priv 000249-048362[048114]: copy=01 offset=000231 disabled
log      priv 048363-055687[007325]: copy=01 offset=000000 disabled
Multipathing information:
numpaths:   8
c1t500601693021C60Ed1   state=enabled   type=primary
c5t500601603021C60Ed1   state=enabled   type=secondary
c5t500601693021C60Ed1   state=enabled   type=primary
c5t500601613021C60Ed1   state=enabled   type=secondary
c5t500601683021C60Ed1   state=enabled   type=primary
c1t500601613021C60Ed1   state=enabled   type=secondary
c1t500601603021C60Ed1   state=enabled   type=secondary
c1t500601683021C60Ed1   state=enabled   type=primary
 

Test complete.


NOTE: It is no longer necessary to reboot the host in order to remove the excluded/suppressed veritas disk access names (da) from the "vxdisk list" output.


If the Solaris based hot-fix for 5.0 MP3 RP4 is required, please contact Symantec Support.

 

Resolution


The device suppression and inclusion defect has been addressed with the deployment of VxVM 5.0 MP3 RP4 HF1 for Solaris.


Workaround:

Without the hot-fix, it will be necessary  to manually suppress each of the corresponding paths associated with the Veritas disk access (da) name to be excluded.
 
Note: Veritas Volume Manager 5.1 release functions as designed, and does not suffer from this product defect. The product functionality initially designed in Veritas Volume Manager 5.0 MP3 does not function in the same way as the 5.1 release, until 5.0 MP3 RP4 HF1 has been applied.
 

Applies To

Solaris.

Issue/Introduction

This documents attempts to explain the benefits that Veritas Volume Manager (VxVM) 5.0 MP3 RP4 HF1 (Solaris) delivers in relation to the LUN suppression and inclusion activity when using "vxdmpadm [ include | exclude ] vxvm dmpnodename=<da-name>".


The VxVM instantaneous device suppression feature was introduced in Veritas Volume Manager (VxVM) 5.0 MP3.
Upon device exclusion, the specified Veritas disk access (da) name is dynamically removed from the VxVM CLI "vxdisk list" device listing, without the previous requirement to reboot the server.

  Prior to the installation of 5.0 MP3 RP4 HF1, due to a product design oversight. it was required to disable each path related to the Veritas disk access (da) name.

In this instance, the vxdmpadm CLI operation fails to populate the /etc/vx/vxvm.exclude file will all the corresponding (8) paths for Veritas disk access (da) name "emc_clariion0_31".


#  vxdisk list emc_clariion0_31
Device:    emc_clariion0_31
devicetag: emc_clariion0_31
type:      auto
hostid:
disk:      name= id=1277725433.70.rhino
group:     name= id=
info:      format=sliced,privoffset=1,pubslice=4,privslice=3
flags:     online ready private autoconfig autoimport
pubpaths:  block=/dev/vx/dmp/emc_clariion0_31s4 char=/dev/vx/rdmp/emc_clariion0_31s4
privpaths: block=/dev/vx/dmp/emc_clariion0_31s3 char=/dev/vx/rdmp/emc_clariion0_31s3
guid:      -
udid:      DGC%5FRAID%205%5FCK200053300424%5F60060160E8341600424F05AE575FDF11
site:      -
version:   2.1
iosize:    min=512 (bytes) max=2048 (blocks)
public:    slice=4 offset=0 len=4582195132 disk_offset=65570
private:   slice=3 offset=1 len=65535 disk_offset=34
update:    time=1277725437 seqno=0.2
ssb:       actual_seqno=0.0
headers:   0 248
configs:   count=1 len=48345
logs:      count=1 len=7325
Defined regions:
config   priv 000017-000247[000231]: copy=01 offset=000000 disabled
config   priv 000249-048362[048114]: copy=01 offset=000231 disabled
log      priv 048363-055687[007325]: copy=01 offset=000000 disabled
Multipathing information:
numpaths:   8
c1t500601693021C60Ed1   state=enabled   type=primary
c5t500601603021C60Ed1   state=enabled   type=secondary
c5t500601693021C60Ed1   state=enabled   type=primary
c5t500601613021C60Ed1   state=enabled   type=secondary
c5t500601683021C60Ed1   state=enabled   type=primary
c1t500601613021C60Ed1   state=enabled   type=secondary
c1t500601603021C60Ed1   state=enabled   type=secondary
c1t500601683021C60Ed1   state=enabled   type=primary
 


# vxdmpadm exclude vxvm dmpnodename=emc_clariion0_31


Note: Only a single path is excluded.


# more /etc/vx/vxvm.exclude
exclude_all 0
paths
c5t500601603021C60Ed1 /dev/rdsk/c5t500601603021C60Ed1
#
controllers
#
product
#
pathgroups
#



Due to the product defect, it is not possible to suppress the Veritas disk access (da) name using the vxdmpadm CLI syntax.


Note: EFI lun handling improvement, with the VxVM 5.0 MP3 RP4 release, the product omits the "s2" slice details for an EFI configured lun (lun size greater than 1TB), compared to 5.0 MP3 RP3 and before.


 

Additional Information

ETrack: 1586095 ETrack: 2068862
Powered by Wolken Software