Turbine 26.1.0 Upgrade Instructions

Use these instructions to upgrade your instance to Turbine 26.1.0. The instructions are organized into subsections of this document that will help you upgrade based on your installation type, whether you have an embedded or existing cluster installation.

RHEL 8 is no longer a supported operating system for Turbine. Beginning with Turbine 26.0.3, Kubernetes is updated to version 1.33, which does not support RHEL 8 (specifically, Linux kernel versions 4.18 and earlier). All customers running RHEL 8 must upgrade to RHEL 9 before upgrading to Turbine version 26.0.3 or greater. You can use the following to determine your host's current RHEL version: cat /etc/redhat-release

Before upgrading MongoDB to version 8.0, perform the following steps to check the current configuration and update it if needed.

1.1 Connect to MongoDB as an Admin (replace <namespace> with your actual namespace)

NOTE: You will be prompted to enter your MongoDB admin password.

1.2 Check the current MongoDB version (it should display 7.0.x)

1.3 Verify the Feature Compatibility Version

1.4 Update the Feature Compatibility Version (if required)

If the version does not include 7.0, update it:

Use the following instructions to upgrade Turbine on an embedded cluster installation.

Important: Swimlane recommends performing a MongoDB backup before starting this update. For more information, see Backup and Restore on an Embedded Cluster with SnapshotsBackup and Restore on an Embedded Cluster with Snapshots.

1.1 SSH into any node in your deployment.

1.2 Scale down EKCO and kotsadm-rqlite

Note: EKCO and kotsadm-rqlite will automatically scale back up after the script in Step 1.3 completes.

1.3 Run the Turbine Platform Installer upgrade

Note: If SELinux, a firewall, or a proxy is configured, append the following to the command:

The se.yaml file is an installer patch file created as described here: https://docs.swimlane.com/turbine-installer/overriding-installer-settings

Prerequisites:

Important! Swimlane recommends that you perform a MongoDB backup before starting this update. For more information, see Backup and Restore on an Existing Cluster with Snapshots. Upgrade KOTS add-on and KOTS app

1.1 Download the add-on for your OS

Linux (AMD64)

macOS (Apple Silicon / ARM64)

1.2 Untar the downloaded file

1.3 Rename the kots binary to kubectl-kots

1.4 Move the kubectl-kots binary into your PATH (e.g. /usr/local/bin/)

1.5 Run the upgrade command

💡 Note: Replace <file-name> with:

Important! Swimlane recommends that you perform a MongoDB backup prior to starting this update. For more information, see Backup and Restore on an Embedded Cluster with SnapshotsBackup and Restore on an Embedded Cluster with Snapshots.

1.1 Copy the latest offline installer package to each airgapped server

1.2 Untar the offline installer package on each server

1.3 Run the Turbine Platform Installer update on any node in your deployment

Provide the absolute path for kubernetes-1.34.4.tar.gz, downloaded as part of step 2, when prompted during installation.

1.4 Run load-images script on all nodes (for HA clusters)

Once the installation is complete, if you have a multi-node (HA) cluster, the script prompts you to run an additional command on every node.

Run this script on node swimlane-2 to load required images before proceeding:

You will be prompted:

Run the following on nodes two (2) and three (3) before proceeding to run the command on node one (1):

This command can be run simultaneously on nodes 2 and 3.

Once the load-images script completes, press Enter on node 1 and then upload the airgap bundle to the SPI dashboard.

1.5 Complete the upgrade

When the upgrade script completes, press Enter on node 1 and then upload the airgap bundle to the SPI dashboard.

Log in to the Turbine Platform Installer dashboard: https://<SwimlaneDNS>:8800

Go to the Version History tab and click Upload a new version, then browse to the turbine-26.1.0.airgap file and click Upload.

The sequence number “_XXX” of the airgap file may be higher than shown if a new sequence has been published.

Once the upload of the airgap completes, refresh the page or switch tabs to see the status of the new file extraction.

Go back to the Version History tab and click Deploy on the new 26.1.0 version at the top of the versions list.

Once the Application tab shows ‘Ready’, your upgrade is complete.

Contact your Swimlane support representative if you do not have a download link for the airgap bundle.

Important! Swimlane recommends that you perform a MongoDB backup before starting this update. For more information, see Backup and Restore on an Existing Cluster with SnapshotsBackup and Restore on an Existing Cluster with Snapshots.

1.1 Download the latest SPI Kubectl Add-on

See kots documentation for how to do so. A versioned link will look like this (Linux AMD64):

1.2 Download the latest SPI offline package

1.3 Copy the SPI Kubectl Add-on and SPI offline package to your jumpbox

1.4 Untar the SPI Kubectl Add-on

1.5 Rename or remove the original kubectl-kots file

1.6 Rename and move the latest SPI Kubectl Add-on file to /usr/local/bin/

1.7 Push the SPI (kotsadm) images to your registry

1.8 Upgrade the Swimlane Platform Installer (SPI)

When the SPI upgrade is complete, upload the Turbine airgap bundle to the SPI dashboard.

If you face any issues downloading Kubernetes:

Download and copy kubernetes-1.34.4.tar.gz on each server. The file can be downloaded on the jump server using: