Skip to main content
Skyhigh Security

Upgrade to a New Version - Controlled Release

The procedure for upgrading to a new version of the Web Gateway appliance software that is provided as a controlled release differs depending on the version that you are currently running.

IMPORTANT: Create a configuration backup before you upgrade and be sure to save it in an external location, so it is still available in case you cannot access Web Gateway after the upgrade failed.

  • 7.8.2 or later — Activate the repository for the new version and upgrade to it from the Web Gateway interface or from a system console.
  • 7.3.x to 7.8.1.x — Upgrade to version 7.8.2 first, then upgrade to the new version, proceeding as follows:
    • Activate the repository for version 7.8.2 and upgrade to this version from the Web Gateway interface or from a system console.
    • Activate the repository for the new version and upgrade to it in one of the ways described.
  • 7.2.x or earlier 7.x, 6.9.x, or 6.8.x — Re-image the appliance using an image of the new version.

Download an image of the new version from the download page of the McAfee Content & Cloud Security Portal at https://contentsecurity.mcafee.com/software_mwg7_download.

Activate the repository

Activate the repository for the new version from a system console. You can use a local system console or work remotely with SSH.

When working with SSH, consider using a terminal multiplexer to ensure that the upgrade will not fail due to an unstable or broken SSH connection.

You can use the tmux multiplexer that Web Gateway has installed.

  1. Log on to the appliance where you want to perform the upgrade.
  2. Run this command:
    mwg-switch-repo <version number>

    As <version number> type the version number of the new version.

    When upgrading to version 7.8.2, which can be required as an intermediate step for upgrading to the new version, type 7.8.2.

You can now upgrade to the new version from the Web Gateway interface or from a system console.

Upgrade from the interface

To upgrade to a new version from the Web Gateway interface, select an appliance and perform the upgrade, then restart the appliance.

  1. Select Configuration | Appliances.
  2. On the appliances tree, select the appliance where you want to perform the upgrade.
    The appliance toolbar appears on the upper right of the tab.
  3. Click Update Appliance Software.
    The upgrade starts, and you are logged off from the interface.

    When the upgrade is complete, a message informs you about the completion.

    If you are running Web Gateway as an appliance on a virtual machine, a warning also appears on the host system where you created the virtual machine. You are warned that an operating system is being used that is not recommended.

    To optimize the operation of the virtual machine, adapt its settings by configuring the recommended operating system, which is CentOS, 64 bit, version 7.
  4. To perform the restart of the appliance that is required:
    1. Log on to the interface again.
    2. Select Configuration | Appliances, then select your appliance.
    3. On the appliance toolbar, click Reboot.

When the restart is complete, you can again log on to the interface and start working with the new version.

Upgrade from a system console

When upgrading to a new version from a system console, you can work with a local system console or remotely using SSH.

When working with SSH, consider using a terminal multiplexer to ensure that the upgrade will not fail due to an unstable or broken SSH connection.

You can use the tmux multiplexer that Web Gateway has installed.

  1. Log on to the appliance where you want to perform the upgrade.
  2. Run the following commands:

    yum upgrade yum

    yum upgrade


    When the upgrade is complete, a message informs you about the completion.

    If you are running Web Gateway as an appliance on a virtual machine, a warning also appears on the host system where you created the virtual machine. You are warned that an operating system is being used that is not recommended.

    To optimize the operation of the virtual machine, adapt its settings by configuring the recommended operating system, which is CentOS, 64 bit, version 7.
  3. To perform the restart of the appliance that is required, run this command:

    reboot

When the restart is complete, a logon prompt appears. You can now log on to the Web Gateway interface and start working with the new version.

  • Was this article helpful?