Last updated
Last updated
The purpose of this guide is to assist in upgrading a Helmut4 instance to a more recent snapshot release, providing instructions for all necessary preparations and security precautions essential for a successful upgrade.
It is strongly advised to always install an update on a development (staging) system first and conduct various stress and workflow tests to ensure its stability before applying it in your production environment.
The latest snapshot release can be found on the page. We strongly recommend installing only snapshot versions, as we do not provide support for development versions used in production environments.
If necessary, refer to the page for detailed information about the versions of the corresponding containers.
We recommend creating a backup of the Helmut4 configuration and making a copy of the Helmut4 stack before proceeding with an update.
Please refer to for a detailed information about how to create a backup.
An alternative method to create a backup of the Helmut4 configuration is to restart the mongobackup container. This container will automatically generate a backup upon startup.
Additionally, you can establish a connection to this container via Portainer or the host and execute the command
to initiate a manual backup process.
Ensure that you also have a backup of your configuration.
For enhanced security, consider creating a snapshot of your host (virtual machine). This snapshot can be utilized to swiftly restore the system to its previous state if necessary.
Updating a single server installation is straightforward and simple. Log in to your host via SSH and execute the following commands:
In a cluster environment, updating follows a similar process to that of a standalone setup. The main difference is that you need to start the update on the server hosting the leader Portainer instance.
Navigate to the helmut4 stack on the leader, click the 'Editor' tab, and ensure that the configuration looks like this:
Identifying the leader is simple: just ensure that port 9000 is open on all servers. If a machine serves as a manager, its status will be clearly indicated in the stack message by the following information.
After completing this task, you'll need to adopt the 'helmut4.snapshot' file on every cluster node. Open this file in a text editor and modify its content to match the snapshot version, for example, 4.8.0.
After updating the system to a version beyond 4.8, it's essential to import a new license code due to changes in the length of security keys.
When performing a snapshot update, such as from 4.7 to 4.8, the existing license will be removed and replaced with a new default license.
Starting from version 4.8 and newer, the URLs for health checks of the languages and cronjob containers have been updated.
You'll need to modify the existing URLs in the stack file to align with the new ones:
Languages
Old URL: http://localhost:8007/v1/language/version
Cronjob
Old URL: http://localhost:8008/v1/cron/version
Please update the URLs accordingly in your stack file.
After successfully updating, allow a few minutes for all images to download and containers to start. During this time, we suggest clearing the cache and cookies in your web browser to avoid any issues caused by cached information.
Next, open the debugger and run some default streams such as connected, custom user, or creating/opening projects. If these operations proceed smoothly, it confirms the update was successful.
As the next step, check all types of streams and profiles. If everything works as expected, you may consider starting to replace any deprecated nodes with their newer versions.
While this task may take some time, it doesn't have to be completed immediately. However, we recommend doing so in the near future.
After these steps, consider creating another backup and saving it.
If the test system operates without any problems for a certain duration, you can securely install the update on the production system. The procedure remains the same, but it's advisable to choose a time period outside the daily production cycle for this process.
The server displaying the current stack configuration is where the update must be executed. To do so, run the update command, as referenced here: .
For additional information, please refer to the .
MoovIT will provide the new license; if you haven't received it, please contact us through .
Note that updating the license will affect clients using an autologin file; refer to: .
This change only applies to and can be skipped for single-server installations.
New URL:
New URL:
Further information can be found here:
