scvxinstall(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO

NAME

scvxinstall– install VERITAS Volume Manager (VxVM) on a cluster node

SYNOPSIS

scvxinstall [-d cdrom-image] [-L license] …
scvxinstall [-i| -e] [-d cdrom-image] [-L license] …
scvxinstall -s
scvxinstall -H

DESCRIPTION

The scvxinstall utility provides automatic VxVM installation and optional root-disk encapsulation for Sun Cluster nodes.

The first form of the scvxinstall utility in the SYNOPSIS section of this man page runs in interactive mode. All other forms of the utility run in non-interactive mode.

• In interactive mode, scvxinstall prompts the user for the mode of operation (install only or install and encapsulate) and for any needed CD-ROM and licensing information.

• In non-interactive mode, scvxinstall does not prompt the user for information. If any needed information is not supplied on the utility line, scvxinstall terminates with an error return code.

The cluster must meet the following requirements before you run scvxinstall:

• All nodes in the cluster configuration must be current cluster members.

• Each root disk that you will encapsulate must have at least two free (unassigned) partitions.

• All nodes must be added to the node authentication list.

The install only mode of the scvxinstall utility performs the following tasks.

1. Verifies that the node you are installing is booted in cluster mode and is running as root, and verifies that all other cluster nodes are running in cluster mode.

2. Disables Dynamic Multipathing (DMP), which is not supported with Sun Cluster software. DMP is disabled by creating symbolic links for the files /dev/vx/dmp and /dev/vx/rdmp.

3. Adds the VRTSvxvm, VRTSvmdev, and VRTSvmman packages for VxVM. If VxVM 3.2 or later is installed, the VRTSlic package is also installed.

4. Negotiates a cluster-wide value for the vxio major number by modifying the /etc/name_to_major file. This ensures that the vxio number is the same on all cluster nodes.

5. Instructs the user to reboot the node to resume operation with the new vxio major numbers in effect.

The install and encapsulate mode of the scvxinstall utility performs the same tasks as install only mode except Step 5, then continues with the following additional tasks.

1. Installs the VxVM license key by running the vxlicense command.

2. Runs several VxVM commands to prepare for root-disk encapsulation.

3. Modifies the global devices entry in /etc/vfstab specified for the /global/.devices/node@n file system, where n is the node number. The scvxinstall utility replaces the existing device path /dev/did/{r}dsk with /dev/{r}dsk. This change ensures that VxVM recognizes that the global devices file system resides on the root disk.

4. Twice reboots each node that is running scvxinstall, once to allow VxVM to complete the encapsulation process and once more to resume normal operation. The scvxinstall utility includes a synchronization mechanism to ensure that it reboots only one node at a time, to prevent loss of quorum.

5. Unmounts the global devices file system by executing the startup file /etc/rc2.d/S74scvxinstall. The file system is automatically remounted after the encapsulation process is complete.

6. Recreates the special files for the rootdg volumes with a unique minor number on each node.

OPTIONS

The following options are supported:

-d cdrom-image

Specify the path to the VxVM packages.

-e

This option specifies the "install and encapsulate" mode of the scvxinstall utility. It installs VxVM and also encapsulates the root disk. If the scvxinstall utility was previously run on the node in "install only" mode, scvxinstall confirms that "install only" mode tasks are completed before it performs the root-disk-encapsulation tasks.

-H

This option specifies the "help" mode of the scvxinstall utility. It displays a brief help message about the scvxinstall utility.

-i

Specify the install only mode of the scvxinstall utility. It installs VxVM but does not encapsulate the root disk.

-L license

Specify a license key for the VxVM software. You can specify the -L license option multiple times to supply multiple license keys to scvxinstall. If you have no additional license keys to install, you can specify the word none for the license argument to -L.

-s

This option specifies the show status mode of the scvxinstall utility. It displays the status of running or completed scvxinstall processing on the node.

EXAMPLES

---

Example 1 Running scvxinstall Interactively




The following command runs scvxinstall interactively

example# scvxinstall

---

---

Example 2 Installing the VxVM Packages Without Encapsulating the Root Disk




The following command installs the VxVM packages but does not encapsulate the root disk. This example assumes that the VxVM CD-ROM is in the CD-ROM drive.

example# scvxinstall -i

---

---

Example 3 Installing the VxVM Packages Without Encapsulating the Root Disk




The following command installs the VxVM packages but does not encapsulate the root disk. The command supplies the path to the CD-ROM images of the VxVM packages, which are stored on a server.

example# scvxinstall -i -d /net/myserver/VxVM/pkgs

---

---

Example 4 Installing the VxVM Packages and Encapsulating the Root Disk




The following command installs the VxVM packages and encapsulates the root disk. The command supplies the VxVM license key. This example assumes that the VxVM CD-ROM is in the CD-ROM drive.

example# scvxinstall -e \ -L "9999 9999 9999 9999 9999 999"

---

---

Example 5 Installing the VxVM Packages and Encapsulating the Root Disk




The following command installs the VxVM packages and encapsulates the root disk. The command supplies the path to the CD-ROM images and the VxVM license key.

example# scvxinstall -e -d /net/myserver/VxVM/pkgs \ -L "9999 9999 9999 9999 9999 999"

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

non-zero

An error has occurred.

FILES

/etc/rc2.d/S74scvxinstall.sh

An rc script used to complete processing following a root-disk-encapsulation reboot

/var/cluster/scvxinstall/*

Location of temporary files used by scvxinstall

/var/cluster/logs/install/scvxinstall.log.pid

Log file created by scvxinstall

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu, SUNWscr

SEE ALSO

scconf(1M), scinstall(1M), scsetup(1M), attributes(5)

Sun Cluster 3.1  Last Revised 24 Apr 2002

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO