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 port 30000 through a browser as part of the installation process.
  1. Verify that the Ubuntu distribution is up to date, and reboot if necessary after updating.

  2. (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
    
  3. Download the Embedded Wallaroo gzipped tarball file wallaroo-2025-1.tgz through the Replicated link via curl. 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.

  4. 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
    
  5. Upgrade the Wallaroo installation by pushing the new wallaroo.airgap installation package with the following command:

    sudo ./wallaroo update --airgap-bundle wallaroo.airgap
    
  6. 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

  1. Access the Kots Administrative Dashboard via the domain name and port as provided in the previous step.

  2. From the Kots Administrative Dashboard:

    1. 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.
    2. Select the version to upgrade to.
    3. To perform a preflight check, select the preflight icon and verify the cluster meets the requirements.
    4. If ready to upgrade, select Deploy (C).
    5. Verify the upgrade process by selecting Yes, Deploy.
  3. 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.

  4. When the upgrade process is complete, the status indicator will change to Ready. At this point, users can resume their normal operations.