We’re very proud of the work we do at Humio: our Engineering division, composed of several departments, has been working hard to produce the latest release of Humio software. If you’re using the previous release and thinking of upgrading to the new one, you may want know about what has changed. You’ll find information on the sub-pages here — look for the links in the Release Notes section below.
You can also see information on the latest releases available from the Humio user interface. When logged into Humio, click on the caption icon at the top of the screen, just to the left of Help. When you hover over it, a information box will appear saying, Updates & Releases. When you click on it, you’ll see information in the right margin about the most recent release, based on whichever version you have installed. In Figure 1 here you can see a screenshot showing how all of this will look — click on the image to enlarge it.
If you’re using Humio Cloud, it uses the latest version; upgrades are handled for you. However, if you’re using a self-hosted version of Humio, this page describes our release methods. It also explains what our release version numbering is intended to convey, along with providing other information to assist you in deciding how to update your installation.
Humio is always eager to publish new releases to make new features available quickly. However, this could sometimes result in some instability. Knowing some clients don’t want instability, we distinguish releases based on whether they are a preview or a stable release. This can help you to decide a strategy for upgrading.
Many administrators will download the latest preview release and install it on a test server or a non-production system. This gives them a chance to try new features and to see if they will need to make any adjustments to their systems or their metrics. Then, when the stable release is available, they’re ready to upgrade their production systems with it.
As features are developed, an odd-numbered release (e.g., 1.17, not 1.18) will be available containing the new features. While such a release is intended to be usable, there is a chance that problems could arise. Once the features have been tested sufficiently, the stable release will be made available. So, we recommend you use the preview release for testing, but wait for the stable release to deploy it on production systems.
We follow a version numbering convention that is similar to that recommended by Semantic Versioning. Basically, we use the MAJOR.MINOR.PATCH numbering format, which is defined as follows:
To reiterate, the numbering convention we follow for releases is fairly common and simple: an odd-numbered release is intended to be a preview to the stable release that will follow it; and an even-numbered release is a stable release. For example, when 1.17 was released, it was a preview of stable release 1.18.
More meticulous administrators will review the details of each release before upgrading. However, reviewing these notes can sometimes be important to any administrator. For instance, you may need to migrate some data, or there may be some sort of conflict with your systems. To be sure, you should at least glance at the release notes.
Below are links to the notes for the latest releases, as well as an archive of older ones:
Archive — As a reference, we keep the notes for older releases, ones that were created before the current versioning scheme was adopted.
When reviewing the release notes, you’ll see some text at the top. It will state the release date and two primary warnings. Below are descriptions of those warnings:
This field states the minimum version of Humio required from which to upgrade. If you try to upgrade from a much earlier version, there’s a possibility that you will have problems.
If this field has a value of false, you can safely upgrade without worrying about migrating your data. If it says it’s true, though, you will have to migrate data. This will be in relation to the last stable version, not the minimum previous version. So be prepared. See our documentation on Data Migrations to learn more on how to do this.