How to update a cluster

In this article, you’ll learn how to update a senhasegura in a clustered environment.

Requirements

• Firewall Rules: Ensure your firewall settings allow communication with the senhasegura repositories. Detailed firewall rules can be found in the documentation.
• Cluster Synchronization: All cluster members must be synchronized.
• Server Time: Verify that the server's time is correctly set.
• (Situational) Arbitrator: If your environment includes an Arbitrator, remove it from the cluster.
• Snapshot: Take a system snapshot before proceeding with the update.
• Updating Sequentially: For versions that are at least two releases old, update sequentially as instructed in this article.
• New senhasegura Repository: Learn how to set up the new senhasegura repository.

Take a snapshot

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

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.

3. Take snapshots of each cluster member.

   Important

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

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

5. Run the following command:

   apt-get update
   

6. Run the following command:

   apt-get install orbit-cli
   

7. Run the following command to update senhasegura to the latest version:

   orbit update
   

8. After updating senhasegura, restart the system 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.

9. Apply steps 5 to 8 to all the other cluster members.

10. Go back to Settings > Execution processes and re-enable the items:

    • Expired password.
    • Expired operation cancellation.
    • Operation executor.
    • Operation executor: Retry.

11. 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.