Sun Cluster 3.0 U1 Installation Guide

How to Install VERITAS Volume Manager Software and Encapsulate the Root Disk

This procedure uses the scvxinstall(1M) command to install VxVM software and encapsulate the root disk in one operation.


Note -

If you intend to create the rootdg disk group on local, non-root disks, go instead to "How to Install VERITAS Volume Manager Software Only".


Perform this procedure on each node that you intend to install with VxVM. You can install VERITAS Volume Manager (VxVM) on all nodes of the cluster, or on only those nodes that are physically connected to the storage device(s) VxVM will manage.


Note -

Although the scvxinstall utility disables Dynamic Multipathing (DMP) at the start of installation processing, DMP is automatically re-enabled by VxVM 3.1.1 when the VRTSvxvm package is installed. Earlier versions of VxVM must still run with DMP disabled.


  1. Ensure that the cluster meets the following prerequisites.

    • All nodes in the cluster are running in cluster mode.

    • The root disk of the node you install has two free (unassigned) partitions.

  2. Become superuser on a node you intend to install with VxVM.

  3. Ensure that the node's /etc/name_to_major file does not already contain a vxio entry.

    If a vxio entry exists, remove it from the file. This entry might exist if VxVM was previously installed on other nodes of the cluster. The correct vxio entry is added automatically during installation of the VxVM software packages.

  4. Insert the VxVM CD-ROM into the CD-ROM drive on the node.

  5. Start scvxinstall in interactive mode.

    Press Control-C at any time to abort the scvxinstall command.


    # scvxinstall
    

    See the scvxinstall(1M) man page for more information.

  6. When prompted whether to encapsulate root, type yes.


    Do you want Volume Manager to encapsulate root [no]? y
    

  7. When prompted, provide the location of the VxVM CD-ROM.

    • If the appropriate VxVM CD-ROM is found, the location is displayed as part of the prompt within brackets. Press Enter to accept this default location.


      Where is the volume manager cdrom [default]?

    • If the VxVM CD-ROM is not found, the prompt is displayed without a default location. Type the location of the CD-ROM or CD-ROM image.


      Where is the volume manager cdrom?

  8. When prompted, type your VxVM license key.


    Please enter license key:  license
    

    The scvxinstall command automatically performs the following tasks.

    • Disables Dynamic Multipathing (DMP)

    • Installs the VRTSvxvm, VRTSvmdev, and VRTSvmman packages

    • Sets the vxio driver major number to 210

    • Creates a rootdg disk group by encapsulating the root disk

    • Updates the /global/.devices entry in the /etc/vfstab file

    See the scvxinstall(1M) man page for further details.


    Note -

    After the installation tasks are completed, the scvxinstall command automatically reboots the node unless you press Control-C when prompted. If you press Control-C, you must reboot the node later to complete VxVM installation.


  9. If you intend to enable the VxVM cluster feature, run the vxlicense command to supply the cluster feature license key.

    See your VxVM documentation for information about the vxlicense command.

  10. (Optional) Install the VxVM GUI.


    # pkgadd VRTSvmsa
    

    See your VxVM documentation for information about the VxVM GUI.

  11. Eject the CD-ROM.

  12. Install any VxVM patches.

    See the Sun Cluster 3.0 U1 Release Notes for the location of patches and installation instructions.

  13. (Optional) If you prefer not to have VxVM man pages reside on the cluster node, remove the man page package.


    # pkgrm VRTSvmman
    

  14. Do you intend to install VxVM on another node?

  15. Are there one or more nodes that you do not intend to install with VxVM?


    Note -

    If you intend to enable the VxVM cluster feature, you must install VxVM on all nodes of the cluster. Proceed to Step 20.


  16. Become superuser on a node that you do not intend to install with VxVM.

  17. Edit the /etc/name_to_major file and add an entry to set the vxio major number to 210.


    # vi /etc/name_to_major
    vxio 210


    Note -

    If you later install this node with VxVM, you must remove the vxio entry before you install VxVM.


  18. Initialize the vxio entry.


    # drvconfig -b -i vxio -m 210
    


    Note -

    The next time you reboot this node, you might see messages similar to the following. These messages are harmless and can be ignored.


    /sbin/rcS: /usr/sbin/vxrecover: not found
    /etc/rc2.d/S75MOUNTGFSYS: /usr/sbin/vxdctl: not found


  19. Repeat Step 16 through Step 18 on all other nodes that you do not intend to install with VxVM.

    When you finish, each node of the cluster should have the same vxio entry in its /etc/name_to_major file.

  20. Do you intend to mirror the encapsulated root disk?


Note -

If you later need to unencapsulate the root disk, follow the procedures in "How to Unencapsulate the Root Disk".