cthactrl Command

Purpose

Controls subsystems within a cluster.

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

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

-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

Uninstalls the group services and topology services subsystems.

-h

Writes the command's usage statement to standard output.

You must have root authority to run this command.

This command applies to the cthags and cthats subsystems only.

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

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
```
To start the group services and topology services subsystems (cthags and cthats), enter:
```
cthactrl -s
```
To stop the group services and topology services subsystems (cthags and cthats), enter:
```
cthactrl -k
```

/opt/rsct/bin/cthactrl