Sun Cluster Software Installation Guide for Solaris OS

SPARC: How to Unencapsulate the Root Disk

Perform this procedure to unencapsulate the root disk.

  1. Ensure that only Solaris root file systems are present on the root disk.

    The Solaris root file systems are root (/), swap, the global devices namespace, /usr, /var, /opt, and /home. If any other file systems reside on the root disk, back them up and remove them from the root disk.

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

  3. Move all resource groups and device groups from the node.


    # scswitch -S -h from-node
    
    -S

    Moves all resource groups and device groups

    -h from-node

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

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


    # clinfo -nN
    

  5. Unmount the global-devices file system for this node, where N is the node ID number that is returned in Step 4.


    # umount /global/.devices/node@N
    

  6. View the /etc/vfstab file and determine which VxVM volume corresponds to the global-devices file system.


    # 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
    

  7. Remove the VxVM volume that corresponds to the global-devices file system from the root disk group.

    • For VxVM 3.5 and earlier, use the following command:


      # vxedit -rf rm rootdiskxNvol
      

    • For VxVM 4.0, use the following command:


      # vxedit -g rootdiskgroup
      


    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.


  8. Unencapsulate the root disk.


    Note –

    Do not accept the shutdown request from the command.



    # /etc/vx/bin/vxunroot
    

    See your VxVM documentation for details.

  9. 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.


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


    # newfs /dev/rdsk/cNtXdYsZ
    

  11. Determine the DID name of the root disk.


    # scdidadm -l cNtXdY
    1        phys-schost-1:/dev/rdsk/cNtXdY   /dev/did/rdsk/dN 
    

  12. 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 11.

    The original entry would look similar to the following.


    # 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

  13. Mount the global-devices file system.


    # mount /global/.devices/node@N
    

  14. From one node of the cluster, repopulate the global-devices file system with device nodes for any raw-disk devices and Solstice DiskSuite or Solaris Volume Manager devices.


    # scgdevs
    

    VxVM devices are recreated during the next reboot.

  15. Reboot the node.


    # reboot
    

  16. Repeat this procedure on each node of the cluster to unencapsulate the root disk on those nodes.