cluster_mgr(1m)

NAME
     cluster_mgr, cmgr - IRIS 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 IRIS FailSafe 2 cluster.  An IRIS 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 IRIS 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
     modify      These commands modify the IRIS FailSafe object definitions.

     show        Shows IRIS FailSafe objects:

                 cmgr> show cluster test_cluster

     start       Start IRIS FailSafe HA services:

                 cmgr> start ha_services in cluster test_cluster

     stop        Stops IRIS FailSafe HA services:

                 cmgr> stop ha_services in cluster test_cluster

     quit        Quits Cluster Manager.

     test        Tests defined IRIS 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.

     IRIS 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 IRIS 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.

     -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 ALSO
     failsafe(1M)