Understanding Releases and Notes

Our release notes contain detailed information about the release, including:

  • Change Log - key changes to the product functionality

  • Improvements - new features added to the product to extend functionality

  • Bug Fixes - bug fixes addressing previous functionality

  • UI Changes - changes the user interface

  • API Changes - changes to the APIs (e.g. GraphQL) that may alter integrations

  • Configuration Changes - differences in the configurable settings

  • Upgrade Compatiblity - basic release compatibility and advice for upgrades

Version Numbering

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:

  • MAJOR: When there are major changes to the software, including high-profile ones, we’ll change the value of this number, the primary number (e.g., the version will change from 1.x.x to 2.x.x).

  • MINOR: When we’ve added some new features or new functionality to Humio software, we’ll issue a new release and the secondary number will be changed (e.g., 1.16 to 1.18). Unlike Semantic Versioning, though, we allow backwards incompatible changes (e.g., changing compression algorithms).

  • PATCH: When a patch is added, the tertiary or third number will be increased (e.g., 1.18 to 1.18.1). Only backwards-compatible security or bug fixes are made with these. No new features or other code changes are permitted. This is important, as it means that each patch release should be more stable than the last.

Preview & Stable Releases

Humio provides two separate releases, stable and preview. The stable release contains the latest functionality and is considered appropriate for production use. The preview release includes functionality that is still considered to be under development. Using a preview release can get you access to the newest featurs, but may be subject to areas of instability. Humio recommends that the preview release is installed on a test server or a non-production system.

The release number can be used to identify whether the release is stable or preview:

  • Even numbered releases, for example 1.20 or 1.26, are stable

  • Odd numbered releases, for example 1.19 or 1.29, are preview

Upgrade Requirements

When reviewing the release notes, a section at the top of each release notes sections porovides basic information about the release and upgrade compatibility. For example:

Version

Type

Release Date

Minimum Upgrade Version

Data Migration

Configuration Changes

1.28.0

Stable

2021-06-15

1.16.0

No

Yes

  • Version — The full version number for this release.

  • Type — The release type, either Stable or Preview

  • Release Date — The date when this version was released.

  • End of Support — The date when Humio Support will no longer support this version.

  • Minimum Upgrade Version — This field states the minimum version of Humio required to upgrade to this version. Upgrades from earlier versions may not succeed are not recommended.

  • Data Migration — If No, you can safely upgrade without worrying about migrating your data. If Yes you will have to migrate data. This will be in relation to the last stable version, not the minimum previous version. See Data Migrations for more information on how to do this.

  • Configuration Changes — Indicates whether there are configuration changes within the release that should be checked and updated during the upgrade process to ensure that they meet your requirements. See the release notes for information on the specific changes.

Built-in Release Information

To determine the version of Humio you are usng and view 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. Figure shows the corresponding part of the Humio interface with release information.

Figure 1, Humio Releases in User Interface

If you’re using Humio Cloud, the latest, preview or stable, is used; upgrades are handled automatically for you.