A.0 Console Commands for BCC

Novell® Business Continuity Clustering (BCC) provides server console commands to help you perform certain BCC management tasks. Some of the commands can also be used to manage Novell Cluster Services™ clusters.

Table A-1 lists the server console commands for managing a business continuity cluster and gives a brief description of each command. For other cluster console commands, see Console Commands for Novell Cluster Services in the NW6.5 SP8: Novell Cluster Services 1.8.5 Administration Guide.

To execute a cluster console command, enter cluster followed by the command. For example, if this cluster is a member of a business continuity cluster, and you want to see this cluster's peer clusters, enter cluster view at the server console. You can also enter cluster help at the console prompt to get information on the commands and their functions.

Table A-1 Console Commands for Novell Business Continuity Clustering

Console Command

Description

cluster credentials [cluster]

Lets you change the administrator username and password that this cluster uses to connect to the specified peer cluster. The cluster you specify must be a member of a cluster that has already been enabled for Business Continuity Clustering.

cluster disable [resource]

Disables Business Continuity Clustering for the specified resource. The resource you specify must be a member of a cluster that has already been enabled for Business Continuity Clustering. If no resource is specified, the entire cluster is disabled for Business Continuity Clustering.

If you disable Business Continuity Clustering for a cluster by using the cluster disable console command, it is also disabled for those cluster resources that have been enabled for Business Continuity Clustering. If you re-enable Business Continuity Clustering for the cluster, you must re-enable each individual cluster resource that you want to be enabled for business continuity.

This can be a time-consuming process if you have many cluster resources that are enabled for business continuity. For this reason, you should use caution when disabling Business Continuity Clustering for an entire cluster.

cluster enable [resource]

Enables Business Continuity Clustering for the specified resource. The resource you specify must be a member of a cluster that has already been enabled for Business Continuity Clustering. If no resource is specified, the entire cluster is enabled for Business Continuity Clustering.

When enabling a resource for business continuity, previous versions of the CLI would not set the peer clusters where the resource was assigned to run. The only way to set peer clusters for a resource was through iManager. The new version of the cluster CLI automatically sets all the clusters in the BCC on a resource. Assigning a resource to specific clusters still must be done through iManager.

cluster migrate [source/resource] [destination/nodename]

Migrates the specified resource from the specified source cluster to the specified target (destination) cluster. Specifying * for the resource name migrates all BCC-enabled resources. Specifying * for the node name brings the resource online at the most preferred node.

cluster resetresources

Changes the state of all resources on this cluster to offline and secondary. This is a recovery procedure that should be run when a cluster in a BCC is brought back into service.

You should run this command when only one node is a member of the cluster.

  1. After a failure, bring up one node in the cluster.

    All other nodes should remain powered off.

  2. Run the cluster resetresources command.

  3. Bring up the remaining nodes in the cluster.

cluster view

Displays the node name, cluster epoch number, master node name, a list of nodes that are currently members of the cluster, and peer clusters if this cluster is a member of a business continuity cluster.

cluster resources [resource]

Lets you view the state and location of cluster resources and whether resources are primary or secondary. You can optionally specify a specific resource name.

cluster status

Lets you view the state and location of cluster resources and whether resources are primary or secondary. If the resource state is primary, the node where the resource is running is displayed. If the resource state is secondary, the cluster where the resource is located is displayed.

cluster connections [-a]

Displays the connection status of the cluster. Specifying -a attempts to show the connection status of all clusters in the BCC.

cluster refresh

This command should not be used except under the direction of Novell Support.