How to update a cluster on versions prior to 3.29
  • 2 minutes to read
  • Dark
    Light
  • PDF

How to update a cluster on versions prior to 3.29

  • Dark
    Light
  • PDF

Article summary

Customers who have a cluster environment with versions prior to 3.29 of senhasegura and wish to update to version 3.29 or later must follow the instructions provided in this article.

Requirements

  • All cluster members must be synchronized.
  • Firewall rules must allow communication through port 443 to establish a connection with the senhasegura repository (only for online updates).
  • The server time for each cluster member must be correctly set.
  • The Arbitrator must be removed from the cluster (only for environments with an Arbitrator).
  • Take snapshots of each cluster member before the update.
Application unavailability during update

When senhasegura initiates the update process, it will be unavailable until the activity is complete.


Take a snapshot

Important
  • In clustered environments, always take snapshots in reverse order, starting from the last member towards the primary member.
  • Always take snapshots of all senhasegura instances separately.
  • Turn off one instance at a time, take the snapshot, turn it back on, and validate that it has resynchronized before proceeding to the next instance.

Snapshots should be taken only when senhasegura instances are offline. This ensures the ability to revert to a previous version if necessary.

  1. To shut down a senhasegura instance, use the following command:
sudo orbit shutdown

2.Once the instance is completely shut down, take a snapshot in the hypervisor.
3. Then, start the senhasegura instance and update the application after taking snapshots of all instances in the cluster.


How to update a cluster on versions prior to 3.29

Caution

Before updating senhasegura, always take a snapshot in your hypervisor and backup using the Orbit CLI.

Caution

If you use the senhasegura Arbitrator, remove it from the cluster before updating senhasegura. Learn more in our documentation.

  1. In the senhasegura platform, go to Orbit Config Manager > Replication > Status and check the status of each member. All members must be ON and synchronized.

  2. In the senhasegura platform, go to Settings > Execution processes, and turn the following items OFF:

  • Expired password.
  • Expired operation cancellation.
  • Operation executor.
  • Operation executor: Retry.
  1. Take snapshots of each cluster member.
Important

Remember to take snapshots in reverse order, from the last member to the first.

  1. Start an SSH session as an administrator user of senhasegura.

  2. Execute the following command to update the operating system to the latest Debian version:

apt-get update

5.1. The following command should be entered twice, as shown:

apt-get install orbit-cli
apt-get install orbit-cli
  1. To update the kernel, use the following command:
orbit update
  1. After the update, restart the system to load the new kernel version:
orbit shutdown -r
  1. Execute the following command to update senhasegura to the latest version:
orbit update
  1. After updating senhasegura, restart the system once again to ensure all changes have been applied correctly:
orbit shutdown -r
Important

When updating Senhasegura in a clustered environment, do not update the members as standalone entities. Be sure to update each cluster member individually, starting with the primary member and proceeding sequentially to the other members. For example, update the Primary Member, then update Member 2, and finally, update Member 3.

Not following these steps during the update can harm the cluster.

  1. Apply steps 5 to 9 to all the other cluster members.
  2. Go back to Settings > Execution processes and re-enable the items:
  • Expired password.
  • Expired operation cancellation.
  • Operation executor.
  • Operation executor: Retry.
  1. Return to Orbit Config Manager > Replication > Status, and check the status of each member to confirm that they are ON and synchronized.

Do you still have questions? Reach out to the senhasegura Community.


Was this article helpful?