Product Documentation

Upgrading NetScaler Gateway VPX

Jul 18, 2013

After you install NetScaler Gateway VPX on your hypervisor, you can then upgrade to new versions of the software by using the same method that you use for the physical appliance.

You can upgrade the software that resides on NetScaler Gateway when new releases are made available. You can check for updates on the Citrix Web site. You can upgrade to a new release only if your NetScaler Gateway licenses are under the Subscription Advantage program when the update is released. You can renew Subscription Advantage at any time. For more information, see the Citrix Web site.

When a new version is released, you download the .tgz file to your computer, copy the file to the NetScaler Gateway virtual appliance, and then upgrade by using either the command line or the configuration utility.

For the most recent Access Gateway 9.3, Enterprise Edition maintenance release readme, see article CTX129345 in the Citrix Knowledge Center.

For the most recent Access Gateway 10 maintenance release readme, see article CTX133966 in the Citrix Knowledge Center.

To download the VPX software for your NetScaler Gateway version, see Downloading the Virtual Image for NetScaler Gateway VPX.

To upgrade NetScaler Gateway by using the Upgrade Wizard

  1. In the configuration utility, in the navigation pane, click System.
  2. In the details pane, click Upgrade Wizard.
  3. Click Next and then follow the directions in the wizard.

To upgrade NetScaler Gateway by using a command prompt

  1. Upload the software to NetScaler Gateway by using a secure FTP client, such as WinSCP, to connect to the appliance.
  2. Copy the software from your computer to the /var/nsinstall directory on the appliance.
  3. Use a Secure Shell ( SSH) client, such as PuTTY, to open an SSH connection to the appliance.
  4. Log on to NetScaler Gateway.
  5. At a command prompt, type: shell
  6. To change to the nsinstall directory, at a command prompt, type: cd /var/nsinstall
  7. To view the contents of the directory, type: ls
  8. To unpack the software, type: tar –xvzf build_X_XX.tgz

    where build_X_XX.tgz is the name of the build to which you want to upgrade.

  9. To start the installation, at a command prompt, type: ./installns
  10. When the installation is complete, restart NetScaler Gateway.

After NetScaler Gateway restarts, to verify successful installation, start the configuration utility. The NetScaler Gateway version that is on the appliance appears in the upper-right corner.