Commands Reference, Volume 1

cthactrl Command

Purpose

Controls subsystems within a cluster.

Syntax

cthactrl -i <init_opt> | -s | -k | -b | -r | -d | -z | -h

Description

The cthactrl command establishes and controls cluster subsystem information and manages topology services and group services.

Flags

-i <init_opt>

Initializes the group services and topology services subsystems, where <init_opt> can be specified as:

-c <cluster_name>

Specifies the cluster name.

-n <nodenum>

Specifies the node number.

-e <environ>

Specifies the subdirectory that contains the cluster access modules.

[-p <portspec>]

Specifies the UDP port numbers for group services and topology services.

For example:

cthactrl -i -c filesys -n 1 -e filesys -p "cthats=12347,cthags=12348"

-s

Starts the group services and topology services subsystems.

-k

Stops the group services and topology services subsystems.

-b

Rebuilds the group services and topology services subsystems configurations (machines.lst, for example).

-r

Refreshes the group services and topology services subsystems.

-d

Deletes the group services and topology services subsystems.

-z

Deinstalls the group services and topology services subsystems.

-h

Writes the command's usage statement to standard output.

Security

You must have root authority to run this command.

Exit Status

0

Successful completion.

non-zero

A failure has occurred.

Restrictions

This command applies to the cthags and cthats subsystems only.

Standard Output

When the -h flag is specified, this command's usage statement is written to standard output.

Examples

1. To initialize the local node as a part of the cluster of filesys1 and designate 12347 as the UDP port number for cthags and 12348 as the UDP port number for cthags, enter:

   cthactrl -i -c filesys1 -n 1 -p "cthats=12347,cthags=12348" -e filesys1

2. To start the group services and topology services subsystems (cthags and cthats), enter:

   cthactrl -s

3. To stop the group services and topology services subsystems (cthags and cthats), enter:

   cthactrl -k

Location

/usr/sbin/rsct/bin/cthactrl

Related Information

Commands: cthagsctrl, cthagstune, cthatsctrl, cthatstune, lssrc, nlssrc