1. Home
  2. High Availability
  3. How do I rename my head nodes?

How do I rename my head nodes?

This article is being updated. Please be aware the content herein, not limited to version numbers and slight syntax changes, may not match the output from the most recent versions of Bright. This notation will be removed when the content has been updated.

I’ve got a failover setup. How do I rename my head nodes?

The following works even if you are exchanging names:

Eg: head 1 is a white box and head 2 is a black box.

But their names got swapped around during setup by mistake, so that head 1 is wrongly called blackbox and head 2 is wrongly called whitebox
The swap can be corrected with these commands run on the active. Suppose the active is blackbox:


  1. using cmha-setup: undo failover setup,
  2. using cmsh: change hostname of only head to the desired name from blackbox to whitebox. This must be done from within CMDaemon to get configurations changed appropriately. Eg: cmsh -c “device use master; set hostname whitebox commit”. The head node (which is incidentally the only head node since failover was undone) is then rebooted after this to commit the changes.
  3. using cmha-setup: run failover setup on the box that is to be whitebox
Updated on August 18, 2020

Related Articles

Leave a Comment