How to upgrade the Messaging Gateway (SMG) to a specific version or release

Products

• Messaging Gateway

Issue/Introduction

How to upgrade the Messaging Gateway (SMG) to a specific version from the command line.

This may be required if you want to upgrade to a version/release that is not the most current. 

Resolution

Upgrading Messaging Gateway (SMG) to a version other than the latest.

 

Command line:

Note: The "--version" directive must come before the action (download/install/notes), otherwise it will ignore the requested version and attempt the action for the latest available version.

1. Log into the Command Line Interface (CLI) with the admin account via SSH or the virtual or physical console.
2. Run the command to download: update --version <VERSION_NUMBER> download
   Example:

   update --version 10.8.0-7 download

3. Before installation, configure the Symantec Messaging Gateway Scanner(s) to not accept incoming mails, after a successful upgrade please accept back incoming mails. To install, run the command: update --version <VERSION_NUMBER> install
   ​​Example:

   update --version 10.8.0-7 install

(Note: If the install command is run without running the download command first, the update will download the version requested before the install)

To get the list of available software updates, use this command:

update list

 

Control Centre:

1. Log in to the Control Centre GUI.
2. Click on Administration > Hosts > Version > Updates tab. Specify a host in the drop-down box.
3. Select the version from the Version(s) available for update. Click View Description first, then click Download Only to download for installing later or Install to begin the install immediately after download.

 

Note: 
Using the commands "update install" or "update download" without including the argument "--version x.x" may cause SMG to upgrade to the latest available version.
Refer to the upgrade best practice documentation when upgrading your appliance.

 

Additional Information

The help for the command line update command contains the following information  (update --help):

NAME
       update - update the appliance software

SYNOPSIS
       update list

       update [--version | -v number] ( check | download | install | notes )

       update localinstall URL to ISO file

       update localcleanup

       update --help

DESCRIPTION
       You can perform the following tasks with the update command:

       •  Check for new software updates

       •  Download software updates

       •  Install software updates from the Internet or locally

       •  List the available software updates for download or installation

       Before you update the software, ensure that your appliance is not performing any tasks that, if disrupted, could cause problems after you reset the appliance. Also ensure
       that you perform a backup of your database.

       db-backup(1)

OPTIONS
       --help, -h
              Display this message.

       [--version | -v n] check | notes | download | install
              Specify a software update version number for the check, download, install, or notes arguments.

ARGUMENTS
       check  Perform a test update.

              The test update demonstrates what happens if you choose to perform a software update. Running update check does not update your appliance software. If you do not
              specify a version, the test update uses the latest software version. For example, if you run update check without specifying the version, and your appliance is
              currently running a version that must be updated to an interim version before it can be updated to the latest version, the test fails. You can check the Release
              Notes to find information on approved update paths.

       download
              Download but do not install a software update. Defaults to the latest released version.

              After you download a software update, you can install it by typing update install. If you do not specify a version, the latest software update is downloaded.

       install
              Download and install a software update. If you do not specify a version, the latest software update is installed on your appliance.

              Defaults to the latest released version.

       list   Display the available software updates.

       localinstall URL to ISO file
              where URL to ISO file is the HTTP location from which Symantec Messaging Gateway can retrieve an OSRestore ISO.

              Updates the software version without an Internet connection.

              You first download an ISO image from Symantec and place it on an HTTP server that is accessible from the appliance.

       localcleanup
              Remove temporary files that may have been left behind from a previously failed localinstall attempt.

       notes  Display the software update notes. If you do not specify a version, the latest software update notes appear.

EXAMPLES
       update download

       Download but do not install a software update. After you download a software update, you can install it by typing update install.