Upgrading NetScaler MAS

Each NetScaler MAS release offers new and updated features with increased functionality. Citrix recommends that you upgrade NetScaler MAS to the latest release to avail the new features and bug fixes. A comprehensive list of enhancements, known issues, and bug fixes is included in the release notes accompanying the release announcement. Understand the licensing framework and types of licenses before you start to upgrade. For NetScaler MAS licensing information, see Licensing.

After the upgrade operation starts, NetScaler MAS restarts. All existing connections are terminated and they are reconnected when the upgrade is completed successfully. The existing configuration is saved, but NetScaler MAS does not process any data until the upgrade is successful.

When you upgrade NetScaler MAS, the NetScaler MAS image files are copied to the corresponding /var/mps/mps_images folder. To prevent image files from occupying storage space after you upgrade NetScaler MAS, you can select an option to have the images deleted automatically. NetScaler MAS then deletes these images from the /var/mps/mps_images after the upgrade is successful.

Upgrade NetScaler MAS servers in high availability mode by accessing the active node or the load balancing virtual server IP address. Both the servers are automatically upgraded to the latest build once you initiate the upgrade process in either of the servers.

Note the following recommended precautions:

  • Back up the NetScaler MAS server before you upgrade.

  • After the upgrade, you might have to re-establish connections between NetScaler MAS and the browser. Connections should establish automatically if the browser is not refreshed when NetScaler MAS is upgraded.

  • For NetScaler MAS servers in high availability pair, when upgrading, do not make any configuration changes from either of the nodes.


  • Do not refresh the browser until the upgrade process is successfully completed. It might take a few minutes for the upgrade process to finish.

  • After upgrade, the active node can change in a high availability pair.

To upgrade NetScaler MAS:

  1. In a web browser, type the IP address of the NetScaler MAS server.


    For NetScaler MAS servers in High Availability mode, type the IP address of either of the servers or the load balancing virtual server IP address.

  2. In the User Name and Password fields, enter the administrator credentials.

  3. Navigate to System > System Administrations. Under the System Administration subheading, click Upgrade NetScaler MAS.

    localized image

  4. On the Upgrade NetScaler MAS page, select the Clean software image on successful upgrade check box if you want to delete image files after upgrade. Selecting this option automatically removes the NetScaler MAS image files upon upgrade. This option is selected by default.


    If you do not select this check box before starting the upgrade process, you have to manually delete the images if you want them removed.

    localized image

  5. You can then upload a new image file by selecting either Local or Appliance. That is, the build file must be present in your local system or on the NetScaler MAS virtual appliance.

    localized image

  6. Click OK. Upgrade process starts along with the following message.

    localized image

Upgrading NetScaler MAS