--- title: Turbine 24.2.8 Upgrade Instructions slug: turbine-upgrade-guide/turbine-2428-upgrade-instructions docTags: createdAt: 2025-12-01T07:34:07.913Z --- Use these upgrade instructions to upgrade your instance of Turbine 24.x. The instructions are organized by subsections of this document that will help you upgrade by specific installation type, whether you have an embedded or existing cluster installation. ## Pre-Upgrade Tasks The following tasks are only necessary in some cases; however, it is more simple to run these for all environments. Enabling feature flags that are already enabled will not affect the environment. The Kubernetes jobs will also be recreated once the update is initiated. Make sure to include the namespace if applicable. - Releases that include a RabbitMQ Upgrade may require manual steps before deploying the new version of Turbine: :::BlockQuote{indent="1"} kubectl exec rabbitmq-server-0 -- rabbitmqctl enable\_feature\_flag all ::: - Depending on which version you are upgrading from, you may be required to delete some immutable jobs. You can delete these jobs using this command: :::BlockQuote{indent="1"} kubectl delete jobs --all ::: ## Upgrade Turbine on Embedded Cluster Installations Use the following instructions to upgrade this version of Swimlane on an embedded cluster installation. Prerequisites: - Turbine version 23.5.x+ - MongoDB 5.0.24 **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 Snapshots. ### Upgrade Instructions 1. SSH into any node in your deployment. 2. Scale down EKCO and kotsadm-rqlite. **Note**: EKCO and Kotsadm-rqlite will automatically scale back up after the script in Step 3 has completed. :::BlockQuote{indent="1"} kubectl scale deployment ekc-operator --replicas=0 -n kurl kubectl scale statefulsets kotsadm-rqlite --replicas=0 -n default ::: :::Paragraph{indent="1"} **NOTE**: If you have configured SELinux, add this to the end of the command above: ::: :::BlockQuote{indent="1"} installer-spec-file=se.yaml ::: 2. Execute the following command to begin the Turbine Platform Installer component upgrade: :::BlockQuote{indent="1"} curl -sSL https\://kurl.sh/turbine-turbine-24-2-8 | sudo bash -s ha ::: 3. After the install script has completed, log in to the Turbine Platform Installer dashboard (https\://\:8800). 4. Go to the Version History tab and click **Check For Updates**. 5. A pop-up window appears, click **Go to the updated version** and click Configure. 6. Click **Deploy** on the new 24.2.8 version with the highest sequence number at the top of the versions list. 7. Once the Application tab shows ‘Ready’ your upgrade is complete. ## Upgrade Turbine on Existing Cluster Installations Prerequisites: - Turbine version 23.5.x+ - MongoDB 5.0.27 - Kubernetes 1.27-1.30 - KOTS kubectl plugin 1.110.x - Velero 1.13.x **Important! **Swimlane recommends that you perform a MongoDB backup prior to starting this update. For more information, see Backup and Restore on an Existing Cluster with Snapshots. ### Upgrade Velero to 1.13.x 1. See the Velero documentation for details: Velero Docs - Upgrading to Velero 1.13 ### Upgrade KOTS addon and KOTS app Prepare the Swimlane Turbine Installer Kubectl Add-on 1. Prepare the Swimlane Turbine Installer Kubectl Add-on: - Download the Swimlane Turbine Installer kubectl add-on for the OS version where you run kubectl commands from: Linux: https\://get.swimlane.io/turbine/existing-cluster/install/linux OSX: https\://get.swimlane.io/turbine/existing-cluster/install/osx - Untar the file: :::BlockQuote{indent="2"} tar zxf kots\_\.tar.gz ::: :::Paragraph{listStyleType="decimal" listStart="3" listRestartPolite="3" indent="2"} Rename the kots binary to kubectl-kots: ::: :::BlockQuote{indent="2"} mv kots kubectl-kots ::: :::Paragraph{listStyleType="decimal" listStart="4" listRestartPolite="4" indent="2"} Move the kubectl-kotsbinary into your PATH so that it can be recognized by kubectl (e.g. /usr/local/bin/) ::: :::BlockQuote{indent="2"} mv kubectl-kots /usr/local/bin/ ::: 2. Run the upgrade command: :::BlockQuote{indent="1"} kubectl kots admin-console upgrade -n \ ::: 3. When the upgrade is complete, login to the Turbine Installer dashboard (https\://\:8800). 4. Go to the Version History tab - you will see a version for 24.2.8 5. Click **Deploy** once the preflight checks have completed. 6. A new configuration is needed for the Elasticsearch persistent volume size and storageclass. Recommended sizes for small/medium/large environments are 8GB/16GB/32GB respectively. 7. Once the Application tab shows ‘Ready’ your upgrade is complete. ## Upgrade Turbine on Embedded Airgap Cluster Installations Prerequisites: - Turbine version 23.5.x+If you are not on a version that is >= 11.0, contact your Swimlane support representative. - MongoDB 5.0.24 - Links to the Offline Installer Package and Offline Airgap Bundle If you do not have these linked, contact your Swimlane support representative. **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 Snapshots. ### Upgrade Instructions 1. Copy the latest offline installer package to each airgapped server. Untar the offline installer package on each server. :::BlockQuote{indent="1"} $ tar -xzvf turbine-24.2.8.tar.gz ::: 2. Scale down EKCO and kotsadm-rqlite. :::BlockQuote{indent="1"} kubectl scale deployment ekc-operator --replicas=0 -n kurl kubectl scale statefulsets kotsadm-rqlite --replicas=0 -n default ::: 3. Run the Turbine Platform Installer update on any node in your deployment: :::BlockQuote{indent="1"} $ cat install.sh | sudo bash -s airgap ha ::: 4. 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: :::BlockQuote{indent="1"} Run this script on node swimlane-2 to load required images before proceeding: cat ./tasks.sh | sudo bash - s load-images Have images been loaded on node swimlane-2? (Y/n) ::: 5. Run :::BlockQuote{indent="1"} cat./tasks.sh | sudo bash -s load-images ::: :::Paragraph{indent="1"} on nodes two (2) and node three (3) before proceeding to run the command on node one (1). ::: :::Paragraph{indent="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. ::: 6. When the upgrade script completes, press **Enter **on node 1 and then upload the airgap bundle to the SPI dashboard. 7. Log in to the Turbine Platform Installer dashboard (https\://\:8800). 8. Go to the Version History tab and click **Upload a new version**, then browse to the turbine-24.2.8.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 9. Go back to the Version History tab and click **Deploy** on the new 24.2.8 version at the top of the versions list. 10. Once the Application tab shows 'Ready', your upgrade is complete. ## Upgrade Turbine on Existing Airgap Cluster Installations Prerequisites - Turbine version 23.5.x+ - MongoDB 5.0.27 - Kubernetes 1.27-1.30 - KOTS kubectl plugin 1.110.0 - Velero 1.13.x - Turbine 24.2.8 airgap bundle from Swimlane - Contact your Swimlane support representative if you do not have a download link for this. **Important! **Swimlane recommends that you perform a MongoDB backup prior to starting this update. For more information, see Backup and Restore on an Existing Cluster with Snapshots. ### Upgrade Velero to 1.13.x 1. See the Velero documention for details. You’ll have to use a jumpbox to download the new images and move them over. https\://velero.io/docs/v1.13/upgrade-to-1.13/ - Confirm both client and server version are on the same 1.13.0 release after upgrading: :::BlockQuote{indent="2"} $ ./velero version ::: ### Upgrade KOTS plugin and KOTS app: 1. Download the latest SPI Kubectl Add-on - See kots documentation for how to do so. A versioned link will look like this :::BlockQuote{indent="1"} \# Linux AMDhttps\://github.com/replicatedhq/kots/releases/download/v1.109.3/kots\_linux\_amd64.tar.gz ::: 2. Download the latest SPI offline package: :::BlockQuote{indent="1"} curl -L https\://get.swimlane.io/existing-cluster/install/offline-package -o kotsadm.tar.gz ::: 3. Copy the latest SPI Kubectl Add-on and SPI offline packages to your jumpbox: :::BlockQuote{indent="1"} $ scp kotsadm.tar.gz user@\:/tmp/kotsadm.tar.gz ::: :::BlockQuote{indent="1"} $ scp kots\_\.tar.gz user@\:/tmp/kots\_\.tar.gz ::: 4. Untar the SPI Kubectl Add-on: :::BlockQuote{indent="1"} $ tar -zxvf kots\_\.tar.gz ::: 5. Rename or remove the *original* kubectl-kots file: :::BlockQuote{indent="1"} $ rm /usr/local/bin/kubectl-kots ::: 6. Rename and move the *latest* SPI Kubectl Add-on file to/usr/local/bin/kubectl-kots :::BlockQuote{indent="1"} $ mv kots kubectl-kots ::: :::BlockQuote{indent="1"} $ mv kubectl-kots /usr/local/bin/ ::: 7. Push the SPI (kotsadm) images to your registry: :::BlockQuote{indent="1"} $ kubectl kots admin-console push-images kotsadm.tar.gz \/\ --registry-username \ --registry-password \ ::: 8. Next, upgrade the Swimlane Platform Installer (SPI): :::BlockQuote{indent="1"} $ kubectl kots admin-console upgrade --kotsadm-registry \/\ --registry-username \ --registry-password \ -n \ ::: :::Paragraph{listRestartPolite="8" indent="1"} When the SPI upgrade is complete, upload the Turbine airgap bundle to the SPI dashboard. ::: 9. Log in to the Swimlane Platform Installer dashboard (https\://\:8800). 10. Go to the Version History tab, click Upload a new version, then browse the turbine-24.2.8.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 file extraction. 11. Go to the Version History tab - you will see a version for 24.2.8 and Click on configure. 12. Click Deploy on the new 24.2.8 version at the top of the versions list. 13. Once the Application tab shows ‘Ready’ your upgrade is complete. NOTE: It may be necessary to perform a rolling restart if you notice unexpected behavior post upgrade. Please follow the steps in the following article, Restarting Services in Swimlane Using Kubernetes Rollout Restart Commands