Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

clsetup(1cl) [opensolaris man page]

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

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

scconf_quorum_dev_quorum_server(1M)			  System Administration Commands		       scconf_quorum_dev_quorum_server(1M)

scconf_quorum_dev_quorum_server - add, remove, and configure a quorum server type of quorum device. SYNOPSIS
scconf [-q quorum-options] 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. Sun Cluster provides the option of configuring a quorum server as a quorum device. This configuration information consists of a device name that must be unique across quorum devices, the address of the host machine on which the quorum server is running, and the port number on which the quorum server is listening for requests. If your cluster requires multiple quorum devices, configure multiple quorum servers or use storage devices for the additional quorum devices. A quorum server can act as only one quorum device for a cluster. To configure the cluster to use a quorum server, the quorum server software must be installed, configured, and running on a machine that is accessible to all cluster nodes. The quorum server itself must be configured and running when this command is run on a cluster node. See clquorumserver(1M) for information about configuring the quorum server. OPTIONS
The following parameters are required for configuring a quorum server type of quorum device. See scconf(1M) for the list of supported generic options. Use the add and remove forms of the command to add shared quorum devices to and remove shared quorum devices from the configuration file. Use the change form of the command to change various cluster quorum configuration properties or states. The following quorum server spe- cific options can be used to change the cluster quorum configuration: Add a Quorum Server Type of Quorum Device Before adding a quorum device: o The quorum server must be running on the quorum server host machine. o You must enter the quorum server host name in the /etc/inet/hosts file. o You must set the netmask for the quorum server host. For information about the hosts file and netmask requirements, see the procedure on adding quorum server quorum devices in the Sun Cluster System Administration Guide. Once the quorum device is added, none of the parameters can be changed. # scconf -q -a name=devicename,type=quorum_server,qshost=qhost,port=portnumber name=devicename The name of a quorum server. This name must be unique among all quorum devices in the system. type=quorum_server Indicates the type of disk device group to create. For a quorum server type of quorum device, the value of this parameter must be quo- rum_server. qhost=qhost The hostname of the machine on the network that can be reached by all cluster nodes and that is running the quorum server. Depending on the IPv4 or IPv6 configuration of the host, this hostname must have an entry in the /etc/hosts file, the /etc/inet/ipnodes file, or both. port=portnumber The port on which the quorum server listens for requests. Note - If you need to change the port number of a quorum server while maintaining the same host name, remove the quorum device first, make your changes, then add the quorum device back. Change the Configuration Parameters of a Quorum Server Type Quorum Device # scconf -c -q name=devicename,maintstate | reset If other parameters such as qshost or port must be changed, add a new quorum device with the new parameters and remove the existing quorum device. Remove a Quorum Server Type of Quorum Device # scconf -q name=devicename When the scconf command is interrupted or fails while performing quorum-related operations, quorum configuration information can become inconsistent in the cluster configuration database. If this occurs, either run the same scconf command again or run the scconf command with the reset option to reset the quorum information. EXAMPLES
Example 1 Adding a Quorum Server Type of Quorum Device The following scconf command adds a quorum server quorum device with its port number configured as 9000. # scconf -q -a name=qd1,type=quorum_server,qshost=scclient1,port=9000 Example 2 Removing a Quorum Server Type of Quorum Device The following scconf command removes the quorum server quorum device named qd1. # scconf -r -q name=qd1 ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWsczu | +-----------------------------+-----------------------------+ |Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
Intro(1CL), clquorum(1CL), clquorumserver(1CL), cluster(1CL), scconf(1M), gateways(4), hosts(4) Sun Cluster 3.2 18 Jul 2006 scconf_quorum_dev_quorum_server(1M)
Man Page