test

Sun Cluster 3.1 Software 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.

  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. Add all nodes in the cluster to the cluster node authentication list.

    1. Start the scsetup(1M) utility.


      # scsetup

      The Main Menu is displayed.

    2. To access the New Nodes Menu, type 6 at the Main Menu.

    3. To add a node to the authorized list, type 3 at the New Nodes Menu.

    4. Specify the name of a machine which may add itself.

      Follow the prompts to add the node's name to the cluster. You will be asked for the name of the node to be added.

    5. Verify that the task has been performed successfully.

      The scsetup utility prints a Command completed successfully message if it completes the task without error.

    6. Repeat Step c through Step e for each node of the cluster until all cluster nodes are added to the node authentication list.

    7. Quit the scsetup utility.

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

  5. Start scvxinstall in interactive mode.

    Press Ctrl-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)

      Note –

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

    • Installs the required VxVM software, licensing, and man page packages, but does not install the GUI packages

    • Selects a cluster-wide vxio driver major number

    • 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 –

    During installation there are two automatic reboots. After all installation tasks are completed, scvxinstall automatically reboots the node the second time unless you press Ctrl-C when prompted. If you press Ctrl-C to abort the second reboot, you must reboot the node later to complete VxVM installation.

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

    See your VxVM documentation for information about how to add a license.

  10. (Optional) Install the VxVM GUI.

    See your VxVM documentation for information about installing the VxVM GUI.

  11. Eject the CD-ROM.

  12. Install any VxVM patches.

    See “Patches and Required Firmware Levels” in Sun Cluster 3.1 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.

  16. Modify the /etc/name_to_major file on each non-VxVM node.

    1. On a node installed with VxVM, determine the vxio major number setting.


      # grep vxio /etc/name_to_major

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

    3. Edit the /etc/name_to_major file and add an entry to set the vxio major number to NNN, the number derived in Step a.


      # vi /etc/name_to_major
vxio NNN

    4. Initialize the vxio entry.


      # drvconfig -b -i vxio -m NNN

    5. Repeat Step b through Step d 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.

  17. Prevent any new machines from being added to the cluster.

    1. Start the scsetup(1M) utility.


      # scsetup

      The Main Menu is displayed.

    2. To access the New Nodes Menu, type 6 at the Main Menu.

    3. Type 1 at the New Nodes Menu.

      Follow the scsetup prompts. This option tells the cluster to ignore all requests coming in over the public network from any new machine that tries to add itself to the cluster.

    4. Quit the scsetup utility.

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