NetScaler SDX

Upgrading a Citrix ADC instance

Note

The Citrix ADM service connect is enabled by default, after you install or upgrade the NetScaler SDX appliance to release 12.1 build 58.xx and above. For more details, see Data governance and Citrix ADM service connect.

The process of upgrading the Citrix ADC instances involves uploading the build file, and then upgrading the Citrix ADC instance.

Important

Downgrading an ADC instance using the Management Service is not supported. Use the instance CLI to downgrade.

Upload the Citrix ADC software images to the NetScaler SDX appliance before upgrading the Citrix ADC instances. For installing a new instance, you need the Citrix ADC XVA file.

In the Software Images pane, you can view the following details.

  • Name

Name of the Citrix ADC instance software image file. The file name contains the release and builds number. For example, the file name build-10-53.5_nc.tgz refers to release 10 build 53.5.

  • Last Modified

Date when the file was last modified.

  • Size

Size, in MB, of the file.

To Upload a Software Image

  1. In the navigation pane, expand Citrix ADC, and then click Software Images.
  2. In the Software Images pane, click Upload.
  3. In the Upload Citrix ADC Software Image dialog box, click Browse and select the Citrix ADC image file that you want to upload.
  4. Click Upload. The image file appears in the Citrix ADC Software Images pane.

To Create a Backup by Downloading a Build File

  1. In the Software Images pane, select the file you want to download, and then click Download.
  2. In the message box, from the Save list, select Save as.
  3. In the Save As message box, browse to the location where you want to save the file, and then click Save.

To Upload an XVA File

  1. In the navigation pane, expand Citrix ADC, and then click Software Images.
  2. In the Software Images pane, on the XVA Files tab, click Upload.
  3. In the Upload Citrix ADC XVA File dialog box, click Browse and select the Citrix ADC XVA file you want to upload.
  4. Click Upload. The XVA file appears in the XVA Files pane.

To Create a Backup by Downloading an XVA File

  1. In the XVA Files pane, select the file you want to download, and then click Download.
  2. In the message box, from the Save list, select Save as.
  3. In the Save As message box, browse to the location where you want to save the file, and then click Save.

Upgrading NetScaler VPX Instances

You can use the Management Service to upgrade one or more of the VPX instances running on the appliance. Before upgrading an instance, make sure that you have uploaded the correct build to the SDX appliance.

Before you start upgrading any instance, ensure that you understand the licensing framework and types of licenses. A software edition upgrade might require new licenses, such as upgrading from the standard edition to the enterprise edition, the standard edition to the platinum edition, or the enterprise edition to the platinum edition. Also note the following:

  • To prevent any loss of configuration, save the configuration on each instance before you upgrade any instances.
  • You can also upgrade an individual instance from the Instances node. To do so, select the instance from the Instances node. In the details pane, select the instance, and then in the Actions drop down menu, click Upgrade.
  • If you have configured a channel from the Citrix ADC instance and want to upgrade the instance from Citrix ADC release 10 to release 10.1 or later, you must delete all the channels from the Citrix ADC instance, upgrade the instance, and then create LACP channels from the Management Service. If you are downgrading the Citrix ADC instance from release 10.1 to release 10.0, you must delete all the LACP channels from the Management Service, downgrade the instance, and then create the LACP channels from the VPX instance.

  • Important

If you use the SDX Management Service and not the VPX GUI to upgrade VPX instances, the upgrade images are part of the backup file and allow you to restore the instance smoothly.

To Upgrade VPX Instances

  1. On the Configuration tab, in the navigation pane, click Citrix ADC.
  2. In the details pane, under Citrix ADC Configuration, click Upgrade.
  3. In the Upgrade Citrix ADC dialog box, in Software Image, select the Citrix ADC upgrade build file of the version to which you want to upgrade.
  4. From the Instance IP Address drop-down list, select the IP addresses of the instances that you want to upgrade.
  5. Click OK, and then click Close.
Upgrading a Citrix ADC instance