cluster_mgr(1m)cluster_mgr(1m)NAME
cluster_mgr, cmgr - SGI FailSafe Cluster Manager Command-Line Interface
SYNOPSIS
cluster_mgr [ -p ] [ -c "command" ] [ -f filename ] [ -i ]
cmgr [ -p ] [ -c "command" ] [ -f filename ] [ -i ]
DESCRIPTION
Cluster Manager is a command-line interface tool used to configure and
administer an SGI FailSafe Version 2 cluster. A FailSafe administrator
can use the Cluster Manager to perform FailSafe configuration and
administration tasks. The cluster manager commands can be scripted. You
must be root in order to run Cluster Manager.
Cluster Manager commands are built around actions and objects. The major
Cluster Manager actions are:
admin Admin commands are for administrative tasks such as moving a
resource group to a particular node or reseting a node:
cmgr> admin reset node srvr1
define These commands are used to define new SGI FailSafe objects.
Here is an example for the command to define a new cluster:
cmgr> define cluster test_cluster
delete These commands delete the object definitions. For example:
cmgr> delete failover_policy ordered-in-order
help Help command. To view help for a specific topic, enter the
topic at the "help >" prompt. You can drill down topic by
topic in help or go directly to a particular help topic by
including the topic with the help command. Use quit to exit
help.
cmgr> help
help > define
help define > cluster
- or -
cmgr> help define cluster
install Command installs resource_types into a particular cluster:
cmgr> install resource_type NFS in cluster test_cluster
Page 1
cluster_mgr(1m)cluster_mgr(1m)
modify These commands modify the SGI FailSafe object definitions.
show Shows SGI FailSafe objects:
cmgr> show cluster test_cluster
start Start SGI FailSafe HA services:
cmgr> start ha_services in cluster test_cluster
stop Stops SGI FailSafe HA services:
cmgr> stop ha_services in cluster test_cluster
quit Quits Cluster Manager.
test Tests defined SGI FailSafe objects:
cmgr> test resource /disk4 of resource_type NFS in cluster
test_cluster on node srvr1
When entering a Cluster Manager command, all objects are specified first
with the object type and then with the name of that object. When
defining a new cluster, for example, the object cluster must be used and
the name of the cluster to be defined:
cmgr> define cluster test_cluster
The syntax includes the action to be performed - define - the type of
object affected - cluster - and the name of the new cluster to be defined
- test_cluster.
SGI FailSafe objects include: clusters, nodes, failover_policies,
resources, resource_types, resource_groups, log_groups, and
ha_parameters.
Users can set environment variable CMGR_STARTUP_FILE to a cluster_mgr
script. This script is executed when cluster_mgr is started. The
cluster_mgr startup script can contain set and show commands.
For more information please see the SGI FailSafe Administrator's Guide.
OPTIONS-p Prompt mode. Additional prompting for defining and modifying
FailSafe objects.
-c "command"
Executes command without interactively entering Cluster
Manager. Acceptable commands include: show, delete, admin,
install, start, stop, test, and help.
Page 2
cluster_mgr(1m)cluster_mgr(1m)-f filename Executes input file containing Cluster Manager commands.
-i Ignore option. Must be used with -f filename option. This
option tells Cluster Manager not to exit if a command fails
while executing a script.
NOTES
There are two ways to execute a Cluster Manager script:
1) Command line execution:
# cluster_mgr -f file_name
2) Script execution with first line of the script containing:
#!/usr/cluster/bin/cluster_mgr -f
IMPORTANT:
When using the -i option with a script file, use this syntax:
#!/usr/cluster/bin/cluster_mgr -if
FILES
/usr/cluster/bin/tbi_help.cat
Help message catalog file.
/usr/cluster/bin/tbi_help.cat.m
Help message catalog file.
SEE ALSOfailsafe(1M)
Page 3