Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

clsetup(1cl) [opensolaris man page]

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

NAME
clsetup - configure Sun Cluster interactively SYNOPSIS
/usr/cluster/bin/clsetup -V /usr/cluster/bin/clsetup -? /usr/cluster/bin/clsetup [-f logfile] DESCRIPTION
The clsetup command provides the following configuration capabilities, depending on what state the cluster is in when you issue the com- mand. The user must be superuser to run this command. This command has no short form. o When you run the clsetup command at post-installation time, the command performs initial setup tasks, such as configuring quorum devices and resetting the installmode property. If you deselected automatic Quroum Configuration when you created the cluster using either scinstall or the cluster create command, then you must run the clsetup command immediately after the cluster has been installed. Ensure that all nodes have joined the cluster before you run the clsetup command and reset the installmode prop- erty. If you used automatic quorum configuration when you created the cluster, you do not need to run the clsetup command after clus- ter installation. The automatic quorum configuration feature also resets the installmode property of the cluster. You can issue this form of the clsetup command from any node in the cluster. o When you run the clsetup command during normal cluster operation, the scsetup command provides an interactive, menu-driven util- ity to perform cluster configuration tasks. The following are some of the cluster components which this utility administers: o Quorum o Resource groups o Data services o Cluster interconnect o Device groups and volumes o Private hostnames o New nodes o Other cluster properties You can issue this form of the clsetup command from any node in the cluster. o When you run the clsetup command from a node that is in noncluster mode, the clsetup command provides a menu-driven utility for changing and displaying the private IP address range. You must reboot all nodes into noncluster mode before you start this form of the clsetup utility. OPTIONS
The following options are supported: -? --help Prints help information for the command. -f logfile --file logfile Specifies the name of a log file to which commands can be logged. If this option is specified, most command sets generated by clsetup can br run and logged, or just logged, depending on user responses. -V --version Prints the version of the command set. No command line processing will be performed and the command will not enter into its interactive menu. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWsczu | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
Intro(1CL), cldevicegroup(1CL), clnode(1CL), clquorum(1CL), clreslogicalhostname(1CL), clresourcegroup(1CL), clresourcetype(1CL), clressharedaddress(1CL), cluster(1CL), cltelemetryattribute(1CL) Sun Cluster 3.2 5 May 2006 clsetup(1CL)

Check Out this Related Man Page

scvxinstall(1M) 					  System Administration Commands					   scvxinstall(1M)

NAME
scvxinstall - install VERITAS Volume Manager (VxVM) on a cluster node SYNOPSIS
scvxinstall [-d media-image] [-L license...] scvxinstall -H scvxinstall {-i | -e} [-d media-image] [-L license...] scvxinstall -s DESCRIPTION
Note - Beginning with the Sun Cluster 3.2 release, Sun Cluster software includes an object-oriented command set. Although Sun Cluster software still supports the original command set, Sun Cluster procedural documentation uses only the object-oriented command set. For more infor- mation about the object-oriented command set, see the Intro(1CL) man page. 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. o 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. o 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 the scvxinstall utility: o All nodes in the cluster configuration must be current cluster members. o Each root disk that you will encapsulate must have at least two free (unassigned) partitions. o All nodes must be added to the node authentication list. o As of VxVM 4.1, you must install VxVM software and licenses before you run the scvxinstall utility. 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 verify that all other cluster nodes are running in cluster mode. 2. For VxVM 4.0 or earlier, adds the VxVM software, licensing, and man-page packages, but not the GUI packages. 3. 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. 4. For VxVM 4.0 or earlier, installs the VxVM license key. 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 the "install-only" mode except Step 5, then per- forms the following additional tasks: 1. Runs several VxVM commands to prepare for root-disk encapsulation. 2. Modifies the global-devices entry in the /etc/vfstab file specified for the /global/.devices/node@n file system, where n is the node ID 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. 3. 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. 4. Unmounts the global-devices file system. The file system is automatically remounted after the encapsulation process is complete. 5. Recreates the special files for the root-disk volumes with a unique minor number on each node. You can use this command only in the global zone. OPTIONS
The following options are supported: -d media-image Valid only for VxVM 4.0 or earlier. Specifies the path to the VxVM packages. You can use this option only in the global zone. -e Specifies the "install and encapsulate" mode of the scvxinstall utility. You can use this option only in the global zone. This option installs VxVM, if installing VxVM 4.0 or earlier, encapsulates the root disk, and performs postinstallation tasks. If the scvxinstall utility was previously run on the node in "install only" mode, scvxinstall confirms that "install only" mode tasks are com- pleted before it performs the root-disk encapsulation tasks. -H Specifies the "help" mode of the scvxinstall utility. This option displays a brief help message about the scvxinstall utility. You can use this option only in the global zone. -i Specifies the "install only" mode of the scvxinstall utility. You can use this option only in the global zone. This option installs VxVM, if installing VxVM 4.0 or earlier, and performs postinstallation tasks, but does not encapsulate the root disk. -L license Valid only for VxVM 4.0 or earlier. Specifies a license key for the VxVM software. You can specify the -L license option multiple times to supply multiple license keys to the scvxinstall utility. If you have no additional license keys to install, you can specify the word none for the license argument to the -L option. -s Specifies the "show status" mode of the scvxinstall utility. This option displays the status of running or completed scvxinstall pro- cessing on the node. You can use this option only in the global zone. 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 4.0 packages but does not encapsulate the root disk. This command also supplies the VxVM license key. This example assumes that the VxVM CD-ROM is in the CD-ROM drive. example# scvxinstall -i -L "9999 9999 9999 9999 9999 999" Example 3 Installing the VxVM Packages Without Encapsulating the Root Disk The following command installs the VxVM 4.0 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 4.0 packages and encapsulates the root disk. The command supplies the VxVM license key. This exam- ple 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 4.0 packages and encapsulates the root disk. The command supplies the path to the CD-ROM images and supplies the VxVM license key. example# scvxinstall -e -d /net/myserver/VxVM/pkgs -L "9999 9999 9999 9999 9999 999" Example 6 Encapsulating the Root Disk After Installing VxVM 4.1 Software The following command verifies that VxVM 4.1 software and licenses are installed and configured, encapsulates the root disk, and negotiates a cluster-wide value for the vxio major number. example# scvxinstall -e Example 7 Performing Postinstallation Tasks After Installing VxVM 4.1 Software The following command verifies that VxVM 4.1 software and licenses are installed and configured, then negotiates a cluster-wide value for the vxio major number. example# scvxinstall -i EXIT STATUS
The following exit values are returned: 0 Successful completion. non-zero An error has occurred. FILES
/etc/rc2.d/S74scvxinstall.sh (Solaris 9) An rc script used to complete processing following a root-disk-encapsulation reboot /usr/cluster/lib/svc/method/scvxinstall (Solaris 10) An rc script used to complete processing following a root-disk-encapsulation reboot /var/cluster/logs/install/scvxinstall.log.pid Log file created by scvxinstall /var/cluster/scvxinstall/* Location of temporary files used by scvxinstall ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWsczu, SUNWscr | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
Intro(1CL), cldevice(1CL), cldevicegroup(1CL), clsetup(1CL), cluster(1CL), clvxvm(1CL), scinstall(1M) Sun Cluster Software Installation Guide for Solaris OS Sun Cluster 3.2 10 Apr 2006 scvxinstall(1M)
Man Page