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