Application Delivery Management

Upgrade NetScaler Console

February 24, 2026

Contributed by:

C R

Important:

File-based licensing will be EOL from April 15, 2026. All NetScaler (ADC, SVM) instances must be upgraded to LAS-compliant versions and transitioned to use LAS-based licensing before this date. The minimum required NetScaler versions that are LAS compatible are:

NetScaler ADCs: 14.1–51.80, 13.1-60.29, 13.1-37.247 (FIPS)

NetScaler SVM: 14.1–51.83, 13.1-60.30

After April 15, 2026, in NetScaler ADC and SVM release 14.1-66.x and later, an upgrade related check will be triggered before NetScaler upgrade. This check validates if your NetScaler (ADC, SVM) is still using file-based licensing, and if true, the upgrade would be blocked with an error “NetScaler Upgrade Blocked: File-based licensing in use”. This precaution avoids your NetScaler instances from proceeding with the upgrade and becoming unlicensed after April 15, 2026. Contact Citrix Support or your ATS representative to understand how you can unblock the upgrade and the risks involved with it.

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.
LAS transition check - Verifies whether NetScaler Console is still using file‑based licensing for pooled or flexed license types post April 15, 2026.

Note:

LAS transition check becomes effective on April 15, 2026 and is applicable to pooled and flexed license type. From this date onwards, if you are trying to upgrade to NetScaler Console 14.1‑66.x or later with file‑based licenses still in use, you will not be allowed to upgrade. This check is done to avoid your NetScaler Console on-prem from proceeding with the upgrade after April 15, 2026, and NetScaler instances becoming unlicensed after the upgrade. If you encounter this restriction, you must contact Citrix Support or your ATS representative for guidance.

The following error is displayed when the LAS pre‑upgrade check fails:

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

February 24, 2026

Contributed by:

C R

February 24, 2026

Contributed by:

C R

Upgrade NetScaler Console

Pre-upgrade checks

In this article