Upgrading cloudSwXtch

  • Updated on Sep 6, 2024
  • Published on Oct 18, 2023
  • 1 minute(s) read
Prev Next

WHAT TO EXPECT

In this article, users will learn how to update their cloudSwXtch when new versions are available. The following commands are cloud agnostic so they should work regardless of what cloud they're using. 

Prerequisites

For major upgrades, it is important to remove your high availability and protocol fanout configurations before upgrading your cloudSwXtch. This will ensure that you have the latest and greatest version of both features.

Users have two ways of doing this: via the UI and via the cloudSwXtch.

  • via the wXcked Eye UI

    1. Go to the Settings page in wXcked Eye and navigate to either the high availability or protocol fanout tabs.

    2. Delete all your configurations.

  • via the cloudSwXtch

    1. cd into the /swXtch/ folder on the cloudSwXtch VM.

    2. ls all of the files.

    3. Copy the config.json as a backup.

    4. Delete the original config.json.

    5. Delete any old “install-x.x.x” files. This is optional for users lacking space.

You may now proceed with the upgrade.

There are two ways of ensuring your cloudSwXtch is up-to-date: via the cloudSwXtch or via the xNIC. 

Upgrading cloudSwXtch via the cloudSwXtch

  1. Sign onto the VM where the cloudSwXtch is running. 

  2. Run the following command:

    Shell

    sudo /swxtch/swx update -i localhost -v v<desired version>

Example:

Shell

sudo /swxtch/swx update -i localhost -v v3.0.0

Upgrading cloudSwXtch via the xNIC 

  1. Connect to any VM where an xNIC is running. 

  2. Run the following command: 

    Shell

    swx update -v <desired version> --ip <ip of cloudSwXtch>

Example: 

swx update -v v3.0.0 --ip 10.5.1.6

Note: The <desired version> includes a "v" before the version number (e.g. v3.0.0).

Upgrading cloudSwXtch and xNICs

Make sure you upgrade all cloudSwXtches and xNICs in the environment to have the best functionality.