4.3 Novell Cluster Services Console Commands

Novell Cluster Services provides several server console commands to help you perform certain cluster-related tasks. The following table lists the cluster-related server console commands and gives a brief description of each command. To execute a cluster console command, enter cluster followed by the command. For example, if you want to display cluster statistics, enter cluster stats display at the server console. You can also enter cluster help at the console prompt to get information on the commands and their functions. The functions of many of the commands can also be performed using iManager. See the other sections of this document for additional information.

Table 4-2 Cluster Console Commands

Cluster Console Command

Description

ALERT {resource}{YES|NO}

The resource start, failover, or failback mode is set to manual and the resource is waiting to start on a node, or fail over or fail back to another node. Specify the resource name in the command and use the YES or NO switch to specify whether you want the resource to fail over, fail back, or start.

CONVERT {Preview, Commit}{Resource}

Finalizes the cluster conversion from NetWare® to Linux after all nodes in a mixed cluster have been converted to Linux. Specify a resource name with the Preview switch to view the resource load and unload script changes prior to finalizing the conversion. Use the Commit switch without specifying a resource to finalize the conversion for all cluster resources. The CLUSTER CONVERT command can only be executed on Linux cluster nodes.

DOWN

Removes all cluster nodes from the cluster. Has the same effect as executing the CLUSTER LEAVE command on every server in the cluster.

INFO {All, Basic, Notification, Priority, Protocol, Summary}

Displays information on cluster configuration.

  • All displays a combination of Basic, Notification, Priority, and Protocol information.
  • Basic displays IP address, port, and cluster quorum settings.
  • Notification displays cluster e-mail notification settings.
  • Priority displays the resource priority list.
  • Protocol displays the cluster protocol settings.
  • Summary displays the cluster protocol summary.

JOIN

Adds the node where the command is executed to the cluster and makes the node visible to other servers in the cluster. Novell Cluster Services software must already be installed on a node for it to join the cluster.

LEAVE

Removes the node where the command is executed from the cluster. The node will not be visible to other servers in the cluster.

MAINTENANCE {ON|OFF}

Turning this switch on lets you temporarily suspend the cluster heartbeat while hardware maintenance is being performed. This is useful if you want to reset or power down the LAN switch without bringing the cluster servers down.

Turning this switch on from one cluster server puts the entire cluster in maintenance mode.

MIGRATE {resource}{node name}

Migrates the specified resource from the node where it is currently running to the node you specify in the command. The node you migrate the resource to must be running in the cluster and also be in the resource's assigned nodes list.

OFFLINE {resource}

Unloads the specified resource from the node where it is currently running.

ONLINE {resource}{node name}

Starts the specified resource on the most preferred node that is currently active. You can start the resource on a different node by specifying that node in the command.

POOLS

Lists the NSS pools on the shared disk system that are accessible by Novell Cluster Services.

RESOURCES

Lists all resources that currently exist in the cluster. The resources do not need to be online or running.

RESTART {seconds}

Restarts Novell Cluster Services software on all servers in the cluster.

SET {Parameter} {Value}

Sets cluster parameters individually for the cluster. See Section 3.8, Configuration Settings for more information on cluster parameters.

Specify one of the following parameters and a value for that parameter:

  • IPADDRESS Sets the cluster IP address to the specified value. If you change the cluster IP address, you must restart cluster software on all cluster nodes.
  • PORT Sets, or lets you change the cluster port number.
  • QUORUMWAIT This is the amount of time in seconds that the cluster waits before resources start to load.
  • QUORUM This is the number of nodes that must be running in the cluster before resources will start to load.
  • HEARTBEAT This is the amount of time in seconds between transmits for all nodes in the cluster except the master.
  • TOLERANCE This is the amount of time in seconds that the master node gives all other nodes in the cluster to signal that they are alive.
  • MASTERWATCHDOC This is the amount of time in seconds between transmits for the master node in the cluster.
  • SLAVEWATCHDOC This is the amount of time in seconds that the slave nodes give the master node in the cluster to signal that it is alive.
  • MAXRETRANSMITS This is the maximum number of times transmits will be attempted between the master node and slave nodes.
  • ENABLEEMAIL Enables and disables e-mail notification. You can set the value to OFF to disable e-mail notification, or either CRITICAL or VERBOSE to enable e-mail notification.
  • EMAILADDRESSES Lets you specify the e-mail addresses used for e-mail notification. The addresses should be separated by spaces. Using this parameter without specifying any addresses will clear existing addresses that have been set previously.
  • EMAILOPTIONS Sets the e-mail notification options. Specify XML as the value to receive e-mail notification in XML format. Not specifying any value with this parameter will turn notification in XML format off.

STATS {Display, Clear}

Reports the node number, node name, and heartbeat information. You must switch to the log console screen to see cluster statistics.

STATUS {resource}

Reports the status of the specified resource. This includes the number of times the resource has been migrated or failed over to another server, the resource state, and the node where the resource is currently running.

VIEW

Displays the node name, cluster epoch number, master node name, and a list of nodes that are currently members of the cluster.