Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for clvxvm (opensolaris section 1cl)

clvxvm(1CL)						 Sun Cluster Maintenance Commands					       clvxvm(1CL)

NAME
clvxvm - configure VERITAS Volume Manager for Sun Cluster
SYNOPSIS
/usr/cluster/bin/clvxvm -V /usr/cluster/bin/clvxvm [subcommand] -? /usr/cluster/bin/clvxvm subcommand -v /usr/cluster/bin/clvxvm encapsulate /usr/cluster/bin/clvxvm initialize
DESCRIPTION
The clvxvm utility initializes VERITAS Volume Manager (VxVM) on a Sun Cluster node and optionally performs root-disk encapsulation. There is no short form of this command name. You can only use this utility with VxVM versions 4.1 or later. For older versions of VxVM, instead use the scvxinstall(1M) utility. The general form of this command is as follows: clvxvm [subcommand] [options] You can omit subcommand only if options specifies the -? option or the -V option. Each option of this command has a long form and a short form. Both forms of each option are given with the description of the option in the OPTIONS section of this man page. You can only use this command from a node that is booted in cluster mode. All nodes in the cluster configuration must be current cluster members. All nodes must be added to the node authentication list. You can use this command only in the global zone.
SUBCOMMANDS
The following subcommands are supported: encapsulate Encapsulates the root disk and performs other Sun Cluster-specific tasks. The encapsulate subcommand performs the following tasks: o Verifies that the current node is booted in cluster mode and that all other cluster nodes are running in cluster mode. o Verifies that the user is superuser. o Enforces a cluster-wide value for the vxio major number by modifying the node's /etc/name_to_major file, if necessary. This task ensures that the vxio number is the same on all cluster nodes. o Runs several VxVM commands to prepare for root-disk encapsulation. o Modifies the global-devices entry in the /etc/vfstab file that is specified for the /global/.devices/node@n file system, where n is the node ID number. The clvxvm 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. o Twice reboots each node that is running clvxvm. The first reboot allows VxVM to complete the encapsulation process. The sec- ond reboot resumes normal operation. The clvxvm utility includes a synchronization mechanism to ensure that the utility reboots only one node at a time, to prevent loss of quorum. o Unmounts the global-devices file system. The file system is automatically remounted after the encapsulation process is com- plete. o Recreates the special files for the root-disk volumes with a unique minor number on each node. This subcommand expects that VxVM packages and licenses are already installed and that the VxVM configuration daemon is successfully enabled on this node. Each root disk that you encapsulate must have at least two free (unassigned) partitions. Users other than superuser require solaris.cluster.modify RBAC authorization to use this subcommand. initialize Initializes VxVM and performs other Sun Cluster-specific tasks. The initialize subcommand performs the following tasks: o Verifies that the current node is booted in cluster mode and that all other cluster nodes are running in cluster mode. o Verifies that the user is superuser. o Enforces a cluster-wide value for the vxio major number by modifying the node's /etc/name_to_major file, if necessary. This task ensures that the vxio number is the same on all cluster nodes. o Instructs the user to reboot the node to resume operation with the new vxio major number in effect, in case the number had to be changed. This subcommand expects that VxVM packages and licenses are already installed and that the VxVM configuration daemon is successfully enabled on this node. Users other than superuser require solaris.cluster.modify RBAC authorization to use this subcommand.
OPTIONS
The following options are supported: -? ---help Displays help information. You can use this option either alone or with a subcommand. o If you use this option alone, the list of available subcommands is printed. o If you use this option with a subcommand, the usage options for that subcommand are printed. When you use this option, no other processing is performed. -V ---version Displays the version of the command. Do not specify this option with subcommands, operands, or other options. The subcommands, operands, or other options are ignored. The -V option only displays the version of the command. No other operations are performed. -v ---verbose Displays verbose information to standard output. You can use this option with any form of the command.
OPERANDS
No form of this command accepts an operand.
EXIT STATUS
The complete set of exit status codes for all commands in this command set are listed on the Intro(1CL) man page. This command returns the following exit status codes: 0 CL_NOERR No error 1 CL_ENOMEM Not enough swap space 3 CL_EINVAL Invalid argument 6 CL_EACCESS Permission denied 35 CL_EIO I/O error
EXAMPLES
Example 1 Initializing VxVM on a Cluster Node The following example shows how to initialize VxVM the cluster node from which the command is issued. # clvxvm initialize Example 2 Initializing VxVM on a Cluster Node and Encapsulating the Root Disk The following example shows how to initialize VxVM and encapsulate the root disk on the cluster node from which the command is issued. # clvxvm encapsulate
ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWsczu | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+
FILES
/var/cluster/cmvxvm/* Location of temporary files that are used by the clvxvm utility. /var/cluster/logs/install/clvxvm.log.pid Log file that is created by the scvxinstall utility.
SEE ALSO
Intro(1CL), cldevice(1CL), cldevicegroup(1CL), clsetup(1CL), cluster(1CL), scinstall(1M), scvxinstall(1M), rbac(5) Sun Cluster Software Installation Guide for Solaris OS
NOTES
The superuser can run any forms of this command. Any user can also run this command with the following options: o -? (help) option o -V (version) option To run this command with other subcommands, users other than superuser require RBAC authorizations. See the following table. +------------+---------------------------------------------------------+ |Subcommand | RBAC Authorization | +------------+---------------------------------------------------------+ |encapsulate | solaris.cluster.modify | +------------+---------------------------------------------------------+ |initialize | solaris.cluster.modify | +------------+---------------------------------------------------------+ Sun Cluster 3.2 19 Jul 2006 clvxvm(1CL)