How to update Segura® Platform online

Important

If you’re using a version prior to 3.33 and wish to update Segura® Platform to version 3.33 or later, please refer to the article How to update versions prior to 3.33.

Important

If you use Zabbix, it will be necessary to reconfigure it after updating Segura® Platform to version 3.30 via Orbit Command Line Interface (CLI). For instructions on how to configure Zabbix via Orbit CLI, refer to the article How to configure Zabbix via Orbit CLI.

In this article, you’ll find a guide on how to update Segura® Platform online.

Requirements

Firewall Rules: Ensure your firewall settings allow communication with the Segura® Platform repositories. Detailed firewall rules can be found in the documentation.
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 Segura® Repository: Learn how to set up the new Segura® repository.

Application unavailable during update

When Segura® Platform initiates the update process, all features will be unavailable until all nodes in the cluster have been fully updated.

Caution

Before updating Segura® Platform, always run a snapshot on your hypervisor and backup using the Orbit CLI.

Caution

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

Take a snapshot

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

You can shut down a Segura® Platform instance using the following command:
```
sudo orbit shutdown
```
Once the instance is completely shut down, take a snapshot in the hypervisor.
Reboot your Segura® Platform instance and update the application.

Download update packages for later installation

As an option, you can download update packages to install at a later time. Download update packages for later installation

Take a snapshot.
Start an SSH session using Segura®’s administrative user.
Run the following command:
```
apt-get update
```
Run the following command:
```
apt-get install orbit-cli
```
Run the command below to update Segura® Platform to the newest version:
```
orbit update
```
After the update, restart the system to ensure that all changes were correctly applied. Use the following command to restart:
```
orbit shutdown -r
```

Debian Kernel Package Updates

Pay attention to the messages displayed during the Segura® Platform update process. If the update includes Debian kernel packages, a specific message will be shown at the end.

In these cases, it is essential to follow the instructions in that message, which will require you to:

Restart the Segura® Platform server. (Step 6)
In some cases, run the update command again (Step 5)

Ignoring this step may result in an incomplete update or system instability.