Starts the topology services subsystem.
The topsvcsctrl control script controls the operation of the topology services subsystem. The subsystem is under the control of the system resource controller (SRC) and belongs to a subsystem group called topsvcs. This script is normally started by the HACMP/ES startup process.
An instance of the topology services subsystem runs on every node of a cluster.
The topsvcs subsystem is associated with the hatsd daemon and the topsvcs script. The topsvcs script configures and starts the hatsd daemon. The subsystem name on the nodes is topsvcs. There is one of each subsystem per node and it is associated with the cluster to which the node belongs.
Provides the topology services. The topsvcs script configures and starts the hatsd daemon.
The topsvcsctrl script is not normally executed from the command line. It is normally called by the HACMP/ES startup command.
Except for the clean and unconfigure functions, all functions are performed within the scope of the current system partition.
Starting the subsystem: When the -s flag is specified, the control script uses the startsrc command to start the topology services subsystem, topsvcs.
Stopping the subsystem: When the -k flag is specified, the control script uses the stopsrc command to stop the topology services subsystem, topsvcs.
Turning tracing on: When the -t flag is specified, the control script turns tracing on for the hatsd daemon, using the traceson command.
Turning tracing off: When the -o flag is specified, the control script turns tracing off (returns it to its default level) for the hatsd daemon, using the tracesoff command.
Refreshing the subsystem: When the -r flag is specified, the control script refreshes the subsystem, using the topsvcs refresh command and the refresh command. It rebuilds the information about the node and adapter configuration in the global object data manager (ODM) and signals the daemon to read the rebuilt information.
Logging: While it is running, the topology services daemon (hatsd) provides information about its operation and errors by writing entries in a log file called /var/ha/log/topsvcs.cluster_name.
Item | Description |
---|---|
-a | Adds the subsystem. |
-s | Starts the subsystem. |
-k | Stops the subsystem. |
-d | Deletes the subsystem. |
-c | Cleans the subsystems. |
-u | Removes the topology services subsystem from all partitions. |
-t | Turns tracing on for the subsystem. |
-o | Turns tracing off for the subsystem. |
-r | Refreshes the subsystem. |
-h | Writes the script's usage statement to standard output. |
You must be running with an effective user ID of root to use this script.
This command is valid in an HACMP™ environment only.
Use this command only under the direction of the IBM® Support Center.
When the -h flag is specified, this command's usage statement is written to standard output. All verbose messages are written to standard output.
This script writes error messages (as necessary) to standard error.
topsvcsctrl -a
topsvcsctrl -s
topsvcsctrl -k
topsvcsctrl -d
topsvcsctrl -c
topsvcsctrl -t
topsvcsctrl -o