Application Delivery Management

Upgrade NetScaler Console

October 16, 2025

Contributed by:

C R

Each NetScaler Console release offers new and updated features with increased functionality. A comprehensive list of enhancements is listed in the release notes accompanying the release announcement. Take a moment to read the release notes before you upgrade the software. It is important to understand the licensing framework and types of licenses before you start to upgrade.

Pre-upgrade checks

Before triggering an upgrade from the NetScaler Console, the system automatically performs a pre-upgrade check to validate system readiness and upgrade image integrity. This check ensures that the upgrade proceeds smoothly and reduces the likelihood of encountering failures during the upgrade process.

Note:

The pre-upgrade check feature is available from NetScaler Console 14.1 release build 56.x. The check runs automatically before every upgrade initiated through the NetScaler Console on-premises.

If the check detects any issues, the NetScaler Console displays detailed information about the discrepancies and prompts you to address them before continuing with the upgrade.

The pre-upgrade check includes the following validations:

Memory availability check – Verifies that the NetScaler Console has sufficient available RAM to perform the upgrade safely.
Disk space check – Ensures that the required free disk space is available for extracting and installing the upgrade image.
Image file requirements check – Confirms that all mandatory image files required for the upgrade are available.
Image file integrity check – Validates the checksum of the upgrade image to ensure that the file is complete and not corrupted.

In addition to resource and file validations, NetScaler Console verifies the health and connectivity of the system to ensure a safe upgrade. The verification includes the following checks:

Database integrity check – Detects missing or corrupted database files to prevent upgrade failures.
Database streaming channel status – Confirms that the streaming channel is active and operational.
Secondary node connectivity – Ensures proper communication with the secondary node for redundancy.
Password-less SSH verification – Confirms that password-less SSH login to the secondary node is working.

The pre-upgrade check feature provides the following benefits:

Performing these validations before the upgrade helps prevent failures caused by insufficient resources or corrupted image files.
By identifying potential issues in advance, the pre-upgrade check improves upgrade reliability and minimizes downtime due to recovery or reinstallation efforts.

To upgrade NetScaler Console:

Navigate to Settings > Administration. Under System Maintenance, click Upgrade NetScaler Console.
On the Upgrade NetScaler Console page, upload a new image file by selecting either Local (your local computer) or Appliance.

Note

When you select Appliance, ensure that the upgrade image is available at /var/mps/mps_images in NetScaler Console.

By default, the software image is cleaned up after a successful upgrade.
Click OK.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

NetScaler Secure Deployment Guide

Upgrade NetScaler Console

October 16, 2025

Contributed by:

C R

October 16, 2025

Contributed by:

C R

Upgrade NetScaler Console

Pre-upgrade checks

In this article