https://man.liquidfiles.com
LiquidFiles Documentation

The following information will help you stay up to date with latest LiquidFiles version.

About LiquidFiles Updates

Version Numbers

A LiquidFiles version number looks like this: v2.3.28 and makes up of:

  • v2 — Major Changes like moving between platforms (OpenBSD to CentOS, 32 bit to 64 bit) and similar major changes.
  • 3 — Feature release changes.
  • 28 — Fix release

In the v2.3.28 example, the major version is v2, feature release v2.3 and the fix release in that feature release: .28.

What this means is that you can expect major system and platform changes as we go from v1 to v2 (OpenBSD to CentOS 6), v2 to v3 and so on. You can expect new features within that major release with each feature release, v2.3 to v2.4 and so on. And between feature releases there will be fix releases that will deal with any issues within the current major release, but will not add any new features, or change how existing features work.

For organisations that want to use n-1 as their update policy, the recommendation is then to stay one feature release behind the current. So if v2.3.28 is the current, you want to stay on v2.2.xx where xx is the latest fix release within the v2.2 major release.

Once you have updated to a feature release, the recommendation is to always install the latest fix release in that feature release.

Supported Versions

LiquidFiles will support the current and previous major release. So if the current release is v2.3.30, any release v2.2.x and v2.3.x is supported. Fixes will typically only be released for the current release though. When a new major release is released, the one two versions back is no longer supported. So if v2.3.30 is the current release. When 2.4.0 is released, version 2.2.x is no longer supported. If you're following the n-1 update strategy, it is now time to schedule an update to v2.3.30 (or whatever is the latest v2.3.xx version) as soon as possible.

Release Notes

To see what's changed between releases, please see the Release Notes. The release notes will outline any major and minor changes to the system.

Getting Notified of new Releases

You can sign up to the Newsletter (at the bottom of this page). Every so often there's a newsletter update alerting of noteworthy new releases.

Performing the Update

There are three ways of updating LiquidFiles:

  • Web interface: You can update by browsing to Admin → Update on your LiquidFiles system. This is the simplest way.
  • Console: You can login on the console (hitting F1 on the actual console), or through ssh to the system and then type ft update.
  • CD/ISO Image: You can boot from the CD/ISO image and select "Upgrade" from the boot prompt.

All methods will update the system to the same status, but there are a few things to be aware of. The web or console way of updating requires Internet access. A lot of other functions in LiquidFiles also requires Internet access but in the event that you have built a closed system with no Internet access, updating through the CD/ISO is your only option.

Upgrading on the console/ssh will give better error messages of things like connection errors. The web interface monitors the update and provide details from what the console applications are doing. But the nature of the web doesn't allow us to run a command like we do on the console through a browser. If you ever run into a problem with DNS or connection timeouts or similar, updating through the console will likely give you better error descriptions.

Updating using the Web Interface

Simply browse to Admin → Update on your LiquidFiles system and select the latest version. It will look something like this:

images/install/update_01.png

As you can see in this screenshot, the latest release at this time was v2.3.26. You only ever need to install the latest release. It is not safer, or provide any benefits of stepping through releases beginning with v2.3.15, v2.3.16, ...

Updating using the Web Interface

If you login to the Console, either by hitting F1 Login or logging in with ssh, and typing ft update will look something like this:

images/install/update_02.png

Same here, you only ever need to install the latest release.

Updating using the CD/ISO Image

If you boot using the CD/ISO Image, you will see a screen like this:

Please Note that it's only possible to update LiquidFiles v2.x using this method as the CentOS team no longer supports CD/ISO updates with CentOS 7 that LiquidFiles v3.x uses.
images/install/update_03.png

Here you can select "Upgrade an Existing System" and it will update the system to whatever version the ISO image was that you downloaded. Please download the latest ISO image from https://license.liquidfiles.com/download/ before you begin.

Rollback Strategy

LiquidFiles does not provide a method for rolling back should an update not work properly. If something happens, we prefer that you open a Support Ticket and we will assist you in fixing whatever problem it is that you're having.

If the system is critical and you need to rollback quickly, please make sure that you take a VMware Snapshot (or similar for your virtual system) before beginning the update.