How to clean up the device tree on Solaris

book

Article ID: 100022486

calendar_today

Updated On:

Description

To clean up the Solaris device tree

# devfsadm -Cv # vxddladm stop eventsource

To clean up the PowerPath device tree:

Note: This is only required if EMC PowerPath is installed and configured.
# powercf -q # powermt config # powermt check

Commandsvxdisk scandisksandvxddladm assign namesshould cater for most Dynamic LUN reconfiguration operations.It is essential the Solaris kernel device nodes and OS device handles do not contain any stale/failing device entries, and are deleted as required.Please take great care when deciding to recycle the vxconfigd daemon, as this can impact normal business operations for  other products, such as Veritas Cluster Server (VCS)

# mv /etc/vx/disk.info /etc/vx/disk.info.old.backup # mv /etc/vx/array.info /etc/vx/array.info.old.backup # rm /dev/vx/dmp/* # rm /dev/vx/rdmp/* # vxconfigd -k -x cleartempdir # vxddladm start eventsource

 

 

Resolution

Warning:  Using this procedure incorrectly may prevent the operating system, or installed software applications, from functioning properly, including data loss. This procedure should only be done under the supervision of Veritas Technical Support, or by an experienced administrator. We recommend performing a backup of your data before continuing.

Issue/Introduction

This article discusses an old legacy process to clean up the device tree on Solaris. There are many situations when cleaning up the device tree is a useful troubleshooting step.

It is often done for the following scenarios:

  • Adding new disks
  • Removing existing disks
  • Troubleshooting missing disks


Please DO NOT follow this process going forward, as the Dynamic LUN reconfiguration steps have evolved since this article was written.
The following articles should be references and followed as required.
Articles: SOLARIS: LUN Removal Reconfiguration Guidelines

SOLARIS: LUN Addition Reconfiguration Guidelines

SOLARIS: Path Removal Reconfiguration Guidelines

SOLARIS: Path Addition Reconfiguration Guidelines

SOLARIS: How to convert the cfgadm failing state to the intended unusable state

LDOM: How to remove a Virtual disk presented to a Solaris GUEST domain

LDOM: How to remove a disk from a Solaris service I/O domain

LDOM: How to provision a disk to a Solaris service I/O domain

SOLARIS SPARC: Dynamic LUN addition and removal made easy with 'dmpdr -o refresh'



Solution

Warning: Using this procedure incorrectly may prevent the operating system, or installed software applications, from functioning properly, including data loss. This procedure should only be done under the supervision of Veritas Technical Support, or by an experienced administrator. We recommend performing a backup of your data before continuing.

To clean up the Solaris device tree

# devfsadm -Cv # vxddladm stop eventsource

To clean up the PowerPath device tree:

Note: This is only required if EMC PowerPath is installed and configured.
# powercf -q # powermt config # powermt check



To clean up VxVM device tree:


Please DO NOT follow the below steps.

Commands vxdisk scandisks and vxddladm assign names should cater for most Dynamic LUN reconfiguration operations.

It is essential the Solaris kernel device nodes and OS device handles do not contain any stale/failing device entries, and are deleted as required.

Please take great care when deciding to recycle the vxconfigd daemon, as this can impact normal business operations for other products, such as Veritas Cluster Server (VCS)

# mv /etc/vx/disk.info /etc/vx/disk.info.old.backup # mv /etc/vx/array.info /etc/vx/array.info.old.backup # rm /dev/vx/dmp/* # rm /dev/vx/rdmp/* # vxconfigd -k -x cleartempdir # vxddladm start eventsource