Upgrade Air-Gapped Single Node Installations of Wallaroo via Kots
Table of Contents
The upgrade Wallaroo follows these general steps.
- Pre-upgrade Checklist: Actions that should be performed before the upgrade process is initiated. See Upgrade Prerequisites for more details.
- Upgrade Procedure: Steps for upgrading Wallaroo to a specified version.
Upgrade Procedure
Depending on the size and number of workspaces and artifacts, a typical upgrade can take 30-60 minutes.
Download Update
The following procedure is used to upgrade a Wallaroo Ops instance via kots
.
To upgrade Wallaroo in the prepared Linux environment, follow these steps. This requires the following:
- Admin access through the
sudo
command. - Have at least 75 GB disk space free to download the installation files.
- The Wallaroo download and authentication link provided by your Wallaroo support representative.
- If required, use
ssh
port forwarding to connect to port30000
through a browser as part of the installation process.
Verify that the Ubuntu distribution is up to date, and reboot if necessary after updating.
(Optional) Remove the previous Wallaroo air-gapped installation files:
wallaroo-{previous-wallaroo-version}.tgz license.yaml # the license file wallaroo # the install executable wallaroo.airgap # the install package
Download the Embedded Wallaroo gzipped tarball file
wallaroo-2025-1.tgz
through the Replicated link viacurl
. This command is provided by your Wallaroo representative and follows this format.curl -f "https://replicated.app/embedded/wallaroo/2025-1/{{param wallaroo_sdk_version}}?airgap=true" \ -H "Authorization: {YOUR AUTHORIZATION CODE HERE}" \ -o wallaroo-2025-1.tgz
The download process takes approximately 30 minutes and the install file is 35 GB.
When the download process is complete, unpack the file
wallaroo-2025-1.tgz
:tar -xvzf wallaroo-2025-1.tgz
The tarfile may be deleted to save space. This provides the following files:
license.yaml # the license file wallaroo # the install executable wallaroo.airgap # the install package
Upgrade the Wallaroo installation by pushing the new
wallaroo.airgap
installation package with the following command:sudo ./wallaroo update --airgap-bundle wallaroo.airgap
Access the Kots Administrative Dashboard via a browser via the installation’s external IP address and port
30000
. For example:http://{YOUR IP ADDRESS}:30000
Or, via
localhost
if port forwarding to port 30000 is enabled.
Update Wallaroo via Kots
Access the Kots Administrative Dashboard via the domain name and port as provided in the previous step.
From the Kots Administrative Dashboard:
- If there is a new version of Wallaroo to install based on your Wallaroo license type, it will be displayed under the Version (B) display as New Version Available. Select Check for updates to check for updated versions.
- Select the version to upgrade to.
- To perform a preflight check, select the preflight icon and verify the cluster meets the requirements.
- If ready to upgrade, select Deploy (C).
- Verify the upgrade process by selecting Yes, Deploy.
During the upgrade process, the status indicator (A) changes from Ready to Unavailable. Selecting Details will show which services are available or are still being upgraded.
When the upgrade process is complete, the status indicator will change to Ready. At this point, users can resume their normal operations.