Sun Cluster Software Installation Guide for Solaris OS

ProcedureHow to Unencapsulate the Root Disk

Perform this procedure to unencapsulate the root disk.

Before You Begin

Perform the following tasks:

  1. Become superuser on the node that you intend to unencapsulate.

  2. Evacuate all resource groups and device groups from the node.

    phys-schost# clnode evacuate from-node

    Specifies the name of the node from which to move resource or device groups.

  3. Determine the node-ID number of the node.

    phys-schost# clinfo -n
  4. Unmount the global-devices file system for this node, where N is the node ID number that is returned in Step 3.

    phys-schost# umount /global/.devices/node@N
  5. View the /etc/vfstab file and determine which VxVM volume corresponds to the global-devices file system.

    phys-schost# vi /etc/vfstab
    #device        device        mount    FS     fsck    mount    mount
    #to mount      to fsck       point    type   pass    at boot  options
    #NOTE: volume rootdiskxNvol (/global/.devices/node@N) encapsulated 
    #partition cNtXdYsZ
  6. Remove from the root disk group the VxVM volume that corresponds to the global-devices file system.

    phys-schost# vxedit -g rootdiskgroup -rf rm rootdiskxNvol

    Caution – Caution –

    Do not store data other than device entries for global devices in the global-devices file system. All data in the global-devices file system is destroyed when you remove the VxVM volume. Only data that is related to global devices entries is restored after the root disk is unencapsulated.

  7. Unencapsulate the root disk.

    Note –

    Do not accept the shutdown request from the command.

    phys-schost# /etc/vx/bin/vxunroot

    See your VxVM documentation for details.

  8. Use the format(1M) command to add a 512-Mbyte partition to the root disk to use for the global-devices file system.

    Tip –

    Use the same slice that was allocated to the global-devices file system before the root disk was encapsulated, as specified in the /etc/vfstab file.

  9. Set up a file system on the partition that you created in Step 8.

    phys-schost# newfs /dev/rdsk/cNtXdYsZ
  10. Determine the DID name of the root disk.

    phys-schost# cldevice list cNtXdY
  11. In the /etc/vfstab file, replace the path names in the global-devices file system entry with the DID path that you identified in Step 10.

    The original entry would look similar to the following.

    phys-schost# vi /etc/vfstab
    /dev/vx/dsk/rootdiskxNvol /dev/vx/rdsk/rootdiskxNvol /global/.devices/node@N ufs 2 no global

    The revised entry that uses the DID path would look similar to the following.

    /dev/did/dsk/dNsX /dev/did/rdsk/dNsX /global/.devices/node@N ufs 2 no global
  12. Mount the global-devices file system.

    phys-schost# mount /global/.devices/node@N
  13. From one node of the cluster, repopulate the global-devices file system with device nodes for any raw-disk devices and Solaris Volume Manager devices.

    phys-schost# cldevice populate

    VxVM devices are recreated during the next reboot.

  14. On each node, verify that the cldevice populate command has completed processing before you proceed to the next step.

    The cldevice populate command executes remotely on all nodes, even through the command is issued from just one node. To determine whether the cldevice populate command has completed processing, run the following command on each node of the cluster.

    phys-schost# ps -ef | grep scgdevs
  15. Reboot the node.

    phys-schost# shutdown -g0 -y -i6
  16. Repeat this procedure on each node of the cluster to unencapsulate the root disk on those nodes.