cluadmin8

Usage

Overview

The cluadmin utility enables you to manage cluster systems and services. Using the utility, you can:

o Add, modify, and delete services

o Disable and enable services

o Display cluster and service status

o Modify cluster daemon event logging

o Backup and restore the cluster database

When you invoke the cluadmin utility in interactive mode, the cluadmin> prompt appears. You can then specify administrative commands, as described in the COMMANDS section.

Options

You can specify the following cluadmin command line options:

-d, --debug

Displays extensive diagnostic information.

-h,-?, --help

Displays help about the utility, and then exits.

-n, --nointeractive

Bypasses the cluadmin utility's top-level command loop processing. This option is used for cluadmin debugging purposes.

-t, --tcl

Adds a Tcl command to the cluadmin utility's top-level command interpreter. To pass a Tcl command directly to the utility's internal Tcl interpreter, at the cluadmin> prompt, preface the Tcl command with tcl. This option is used for cluadmin debugging purposes.

-V, --version

Displays information about the current version of cluadmin.

Commands

Within the cludamin interactive mode, you can specify the following commands at the cluadmin> prompt:

help [command]

Displays help for the specified cluadmin command, or, if a command is not specified, displays a list of cluadmin commands for which you can obtain help.

apropos [string]

Displays the cluadmin commands that match the specified character string. If no string is specified, displays all cluadmin commands.

clear

Clears the screen display.

exit

Exits from the cluadmin utility

cluster status

Displays a snapshot of the current cluster status.

cluster monitor

Continuously displays snapshots of the cluster status at five-second intervals. Press the Return or Enter key to stop the display. You can specify the -interval # option with a numeric value to display snapshots at the specified time interval (in seconds). In addition, you can specify the -clear yes option to clear the screen after each snapshot display, or a -clear no option to not clear the screen.

cluster loglevel daemon level

Sets the logging for the specified cluster daemon to the specified severity level. The cluster daemons include the quorumd, svcmgr, powerd, and hb daemons. Specify either the name of the severity level or its numeric equivalent, as follows: emerg (0), alert (1), crit (2), err (3), warning (4), notice (5), info (6), or debug (7).

cluster reload

Forces the cluster daemons to re-read the cluster configuration database.

cluster name cluster_name

Sets the name of the cluster to the specified name.

cluster backup

Saves a copy of the cluster configuration database in the /etc/opt/cluster/cluster.conf.bak file.

cluster restore

Restores the cluster configuration database from the backup copy in the /etc/opt/cluster/cluster.conf.bak file.

cluster saveas file_name

Saves the cluster configuration database to the specified file.

cluster restorefrom file_name

Restores the cluster configuration database from the specified file.

service add [service_name]

Adds a cluster service to the cluster database. The cluadmin utility will prompt you for information about service resources and properties.

service modify service_name

Modifies the resources or properties of the specified service.

service show state [service_name]

Displays the current status of all services or the specified service.

service show config service_name

Displays the current configuration for the specified service.

service disable service_name

Stops the specified running service.

service enable service_name

Starts the specified disabled service.

service delete service_name

Deletes the specified service from the cluster.

You can use the Tab key to help you identify cluadmin commands. For example, pressing the Tab key at the prompt displays a list of all the commands. Entering a letter at the prompt and then pressing the Tab key displays the command that begins with the specified letter or a list of all the commands that begin with the specified letter. Specifying a command and then pressing the Tab key displays a list of all the subcommands that can be specified with that command.

You can display the history of cluadmin commands by pressing the up arrow or down arrow key at the prompt. The command history is stored in the .cluadmin_history file in your home directory.

Examples

The following is an example of using cluadmin to disable a running service:

cluadmin> service disable nfs_home
Are you sure? (Y/N/?) y
notice: Stopping service nfs_home  ...
notice: Service nfs_home is disabled
service nfs_home disabled    
cluadmin>