Product Documentation

Upgrading a Citrix NetScaler instance

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

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

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

  • Name

Name of the Citrix NetScaler instance software image file. The file name contains the release and build 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 NetScaler, and then click Software Images.
  2. In the Software Images pane, click Upload.
  3. In the Upload NetScaler Software Image dialog box, click Browse and select the NetScaler image file that you want to upload.
  4. Click Upload. The image file appears in the NetScaler 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 a XVA File

  1. In the navigation pane, expand NetScaler, and then click Software Images.
  2. In the Software Images pane, on the XVA Files tab, click Upload.
  3. In the Upload NetScaler XVA File dialog box, click Browse and select the Citrix NetScaler 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 Citrix 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 NetScaler instance and want to upgrade the instance from Citrix NetScaler release 10 to release 10.1 or later, you must delete all the channels from the Citrix NetScaler instance, upgrade the instance, and then create LACP channels from the Management Service. If you are downgrading the Citrix NetScaler 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

Use the SDX Management Service only and not the VPX GUI to upgrade VPX instances, so that during backups the upgrade images are part of the backup file. Such backup files help you restore the instance smoothly

To Upgrade VPX Instances

  1. On the Configuration tab, in the navigation pane, click NetScaler.
  2. In the details pane, under NetScaler Configuration, click Upgrade.
  3. In the Upgrade NetScaler dialog box, in Software Image, select the NetScaler 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.

Demystifying the NetScaler SDX appliance upgrade process