Promoting a dependent instance

When a primary Lighthouse is no longer reachable, a dependent Lighthouse instance can be promoted to primary. The new primary can then be used to set up a dependent Lighthouse if required.

Note: This should only be performed if the primary Lighthouse has no chance of returning, the procedure is not reversible and will break all node connections with the previous primary instance. The previous primary instance must be factory reset before it can be used again.

To promote a dependent instance to primary, login as root on the secondary instance via console or ssh and run

promote-secondary-lighthouse

Remove all dead connections from node side using the node's web UI. The Promotion tool deletes connection between primary and dependent instance but does not touch node connections.

The new primary can then be used to enroll a dependent Lighthouse if required.

Note:If the previous primary becomes accessible again, it will not be able to connect to its enrolled nodes or the previous secondary Lighthouses.

  • All scheduled firmware upgrades are cancelled in the event of a dependent Lighthouse promotion, and will need to be rescheduled.

  • Firmware files are not replicated among the multiple instance cluster and must be re-uploaded to the new primary after promotion.