Minimize upgrade issues between major Edge SWG (formerly ProxySG) SGOS releases

Products

• ProxySG Software - SGOS

Issue/Introduction

The Edge SWG (formerly ProxySG) SGOS software includes upgrade handlers designed to convert configuration settings between major release upgrades, such as upgrades from 6.x to 7.x, or from 5.x to 6.x. SGOS creates a new configuration file automatically the first time it boots to a new major version and retains a separate configuration file for each major release on the system.

When you boot up a major release for which a configuration already exists on the system, the SGOS upgrade handler does not create a new configuration; the existing one is used. If you want SGOS to create a new configuration instead, you must convert settings to migrate the configuration from the current release to the target release.

Resolution

If you are upgrading the SGOS major version and want to migrate the configuration from the previous version to the new version, consult the following table to identify the method you should use to automatically convert the configuration settings.

 

After you install the required release(s) and convert configuration settings, verify that you are using the correct SGOS version. You can quickly determine which configuration the appliance is using when you restart the appliance in SGOS 6.x. Look for lines similar to the following in the CLI:

Booting Version: SGOS 6.2.12.1, Release id: 104304 
Completed major version system upgrade

If you see the second line indicating that the system was upgraded, the 5.x configuration was migrated to 6.x. If the second line is not present after you boot into 6.x, an existing 6.x configuration was used. If the 6.x configuration was used but you want to use the 5.x one, you can use the restore-sgso5-config command to replace the 6.x config with the converted 5.x config. 

Additional Information

Regarding upgrades between SGOS 6.7.x and SGOS 7.x -

Only on the very first boot of SGOS 7.x (when an initialized config does not exist or has not been configured) will the SGOS 6.7.x configuration be copied or upgraded to the SGOS 7.x configuration. In other words, if an appliance was already booted on SGOS 7.x, it will have the configuration from the previous boot.
To copy or upgrade the SGOS 6.7.x config into SGOS 7.x, the SGOS 7.x config will need to be removed manually and prior to booting this release edition from SGOS 6.7.x.