Console Commands for the Cluster Manager
The following console commands can be issued from within the eccmgr service. These commands are mainly concerned with broadcasting or unicasting commands to other cluster nodes.
- broadcast *`command`*
-
Broadcast a console command to the cluster. For a list of available console commands, see Console Commands Summary .
- broadcast cluster duravip move *`from_host`* *`to_host`*
-
The only safe way to do a duravip move is using a broadcast cluster duravip move command. This guarantees that both the node that currently owns the address and the new owner will be in sync. For example:
/tmp/2025> broadcast cluster duravip move
10.0.5.139
tohostname
Furthermore, if there is a mismatch between the machine's hostname and the spread node name (i.e. if the hostname is fully qualified) the move will not succeed.
Warning
If you modify DuraVIP™ bindings, a possible race condition means that a config reload taking effect on multiple machines at the same time can cause nodes to disagree about who owns which binding. For this reason, it is strongly suggested that you broadcast this command to the cluster by issuing the command broadcast cluster duravip announce view immediately after config reload . Doing this synchronizes ownership of the bindings and eliminates a possible race condition among the nodes.
- subcluster broadcast *`subcluster command`*
-
This command works in the same way as the broadcast
command
but sends the command only to the subcluster identified bysubcluster
.For example to broadcast a command to all nodes on the
west
subcluster, you would issue the command subcluster broadcast westcommand
. - subcluster retrieve *`subcluster command`*
-
This command works in the same way as the retrieve
command
but retrieves the responses only from the subcluster identified bysubcluster
.For example to retrieve the responses to a command broadcast to all nodes on the
west
subcluster, you would issue the command subcluster retrieve westcommand
. - flush control cache
-
Clear the results buffer. After executing this command, you will not be able to retrieve previous commands.
- help
-
Show a help message, listing available commands and their brief usages.
- info
-
Show general information about the cluster group and the cluster node.
This command is analogous to the similarly named cluster module console command, described in “Cluster Module-specific Console Commands”.
- retrieve *`command`*
-
Retrieve the responses to a command broadcasted by the cluster manager.
- retrieve_node *`node`* *`command`*
-
Retrieve the responses to a unicasted/broadcasted command from the specified node of the cluster.
- show cluster membership
-
Show current cluster members and their roles (nodes, manager or other).
This command is analogous to the similarly named cluster module console command described in “Cluster Module-specific Console Commands”, i.e., the output of show cluster membership while in XML format, is identical to the output of the cluster module command cluster membership .
- shutdown
-
Shutdown the cluster manager.
- unicast *`node`* *`command`*
-
Unicast a console command to the specified node in the cluster.
- version
-
Display version and copyright information of eccmgr.
- config
-
You can use the config commands for online configuration tuning. Commonly used commands include:
- config [set | get | eval] [ *`scope`* ] *`option_name`* [ *`value`* ]
-
Set, get, or eval any of the options in the
eccluster.conf
. - config showrecurse
-
View all options that affect the cluster manager. This command displays options found in the
eccluster.conf
file.