Upgrade SWG using the mwg-update Tool

Last updated
Save as PDF

You can upgrade to a new version of Web Gateway using the mwg-update tool. The usage of the tool depends on your product version and mode of upgrade (online or offline).

Perform Online or Offline Upgrade

Online Upgrade - For an online upgrade, the mwg-update tool accesses an existing remote repository. It downloads the necessary packages from this repository to upgrade your system.

Offline Upgrade - For an offline upgrade, the mwg-update tool creates a temporary repository on your local disk. It uses ISO file packages to upgrade the system based on the local repository. After the upgrade, the tool removes the repository from the local disk.

Version Restrictions

Starting with version 7.8.2, the appliance uses the new MLOS 3 operating system. Versions earlier than 7.8.2 run on MLOS 2. Due to this change, the tool has the following restrictions:

Offline upgrades from versions earlier than 7.8.2 to later versions are not supported.
Online upgrades from versions earlier than 7.8.2 to later versions are supported.

NOTE:

Upgrade from a version earlier than 7.8.2 to a later version occurs in two steps: Initially, upgrade to version 7.8.2, and later from 7.8.2 to the target version.

Use Cases

You can use the tool to upgrade directly, either offline or online:

From 7.8.0 to 7.8.1 (both versions are earlier than 7.8.2)
From 8.1 to 8.2 (both versions are later than 7.8.2)

You can also upgrade directly online:

From 7.8.1 to 7.8.2 (from any earlier version to 7.8.2)

However, for upgrades from a version earlier than 7.8.2 to a version later than 7.8.2 — for example, from 7.8.1 to 8.2:

You cannot upgrade offline
To upgrade online, you must first go from 7.8.1 to 7.8.2, followed by a second upgrade from 7.8.2 to 8.2

Upgrade SWG Offline using the mwg-update Tool

To upgrade SWG offline using the mwg-update tool:

Log on to the appliance to perform the upgrade from a local system console or remotely using SSH.

NOTE: When upgrading with SSH, consider using a terminal multiplexer (tmux multiplexer) to ensure that the update does not fail due to an unstable or broken SSH connection.

Run the mwg-update -o <file name>command to perform the upgrade.
- sample command:mwgappl-7.8.2.12.0-29703.x86_64.iso.
Enter the applicable option:
- [y]es - To continue the upgrade.
- [n]o - To cancel the upgrade.

Preparing files ...
Creating repository

Ready to update the current version
mwg-7.8.2.11.0-2 361.mlos2.mwg.x86_64 using the file
mwgappl-7.8.2.12.0-29703-22595.x86_64.iso

Do you want to proceed? ([y]es/[n]o)

If [y]es is entered, run the following commands:

mwg-update -y -o <file name> command without user interaction, which is useful for scripting.
mwg-update -d -y -o <file name>command without user interaction, returning debugging information.

After the upgrade, restart the appliance manually.

Command Parameters and Functions

The mwg-update tool performs an upgrade to a new version of Web Gateway using mwg-update command on the command line of a system console.

The following table lists and explains the command parameters.

Parameter	Definition
No parameter	The upgrade is performed using a repository, which must have been enabled. A repository and path name might be, for example: `/etc/yum.repos.d/mwg.local.repo`
`-h`	Displays help information about the command parameters.
`-d`	Returns debugging information.
`-p <proxy>`	The upgrade is performed using the specified proxy.
`-y`	Answers all questions asked during the upgrade process with yes. This parameter is useful when running a script to perform the upgrade.
`-o <file name>`	The upgrade is performed offline using the specified ISO file.