Product Documentation

Single Bundle Upgrade

Jun 13, 2017

NetScaler SDX appliance setup includes setting up XenServer hypervisor, its supplemental packs and hotfixes, the Management Service, NetScaler virtual machines, and LOM firmware. Each of these components has a different release cycle. Therefore, updating each component independently, as allowed by NetScaler SDX 10.5 and earlier releases, makes maintenance difficult. Updating each component separately also leads to unsupported combinations of components.

Single bundle upgrade combines all the components except the NetScaler image and LOM firmware in a single image file, called the NetScaler SDX image. Using this image upgrades all the components in a single step, eliminating the chances of incompatibility between various components. Single bundle upgrade also ensures that your appliance is always running a version that is tested and supported by Citrix. Because all the SDX components are combined in a single file, the NetScaler SDX image file is significantly larger than the image files of NetScaler SDX release earlier than 11.0.

The NetScaler SDX image is the single bundle image file, which includes all the SDX components, including the Management Service, except NetScaler image and LOM firmware. Use this image file to upgrade the entire appliance. The file name of the image file is of the format build-sdx-11.0-<build_number>.tgz

Upgrading the Entire Appliance

If you are currently running version 10.5.57.x or later of the NetScaler SDX Management Service, you can use the NetScaler SDX 11.0 image file to upgrade the appliance. If your Management Service is an earlier version, you must first upgrade it to either version 10.5.57.x. To upgrade the appliance to NetScaler SDX 11.0, it is essential to upgrade the Management Service 10.5.57.x because the 10.5.56.x or earlier versions of Management Service do not recognize the single bundle NetScaler SDX image file.

To upgrade the appliance, first upload the single bunlde image file. To upload the single bundle image file, navigate to Configuration> Management Service > Software Images and then click on Upload. After uploading the single bundle image field, navigate to Configuration > System > System Administration. In the System Administration group, click on Upgrade Appliance

Before the upgrade, Management Service displays the following information:
  • Single bundle image file name
  • The current version of NetScaler SDX running on your appliance
  • The selected version to which the appliance will be upgraded to
  • Approximate time to upgrade the appliance
  • Miscellaneous information

Before clicking Upgrade, make sure that you have reviewed all the information displayed on the screen. You cannot abort the upgrade process once it starts.

Note: If your current NetScaler SDX setup is 10.5.56 or earlier, using the NetScaler SDX image to upgrade the appliance directly to NetScaler SDX 11.0 is not supported.

After the Management Service is upgraded to NetScaler SDX 11.0, the new GUI does not display the options to upload the XenServer image file, supplemental packs, or hotfixes. This is because NetScaler SDX 11.0 does not support upgrading individual components.