Console Commands for the Cluster Manager

March 26, 2020 Contributors

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 to hostname

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 by subcluster.

For example to broadcast a command to all nodes on the west subcluster, you would issue the command subcluster broadcast west command .

subcluster retrieve *`subcluster command`*

This command works in the same way as the retrieve command but retrieves the responses only from the subcluster identified by subcluster.

For example to retrieve the responses to a command broadcast to all nodes on the west subcluster, you would issue the command subcluster retrieve west command .

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.