Overview of the Issue

NetScaler is made available as a Maintenance Phase release on which existing features are maintained on newer build numbers. NetScaler is also available as a different Feature Phase release (with a higher major version number). The Feature Phase release can include the introduction of new features and capabilities. The process of upgrading NetScaler can either be to the next major version number or to a newer build of the version that is already installed. The general configuration of NetScaler will use either Classic or Advanced configuration methods, with some enhanced capabilities becoming available with the newer Advanced method. See the following links and articles to help prevent or solve some of the common problems experienced when upgrading NetScaler or when performing general configuration tasks.

Top Knowledge Content

Troubleshooting Common Problems with Upgrades

• CTX546837 - ADC Upgrade best practice

• CTX549397 - How to upgrade Citrix ADC (Step-by-Step)

• CTX579137 - NetScaler SSL Certificates missing after upgrading Secondary Node

• CTX585679 - After upgrade to 14.1 ADC GUI response is slow resulting in operation timeout with tacacs auth

• CTX215643 - Customized NetScaler Gateway login page is not accessible after an upgrade

• Upgrade a NetScaler standalone appliance 

• Upgrade a high availability pair 

• Upgrade and downgrade a NetScaler appliance

• Single bundle upgrade

• Use jobs to upgrade NetScaler instances 

• Upgrade failure due to disk space

Troubleshooting Common Problems with General Configuration

• CTX109013 - Troubleshooting NetScaler High Availability (HA) Issue

• CTX208106 - Troubleshooting High Memory Issues on NetScaler

• CTX224218 - NetScaler Application Firewall High CPU Troubleshooting

• CTX335659 - Unable to access ADC GUI while CLI is accessible.

• CTX201156 - Time Display on NetScaler Does Not Sync Using NTP

• CTX223524 - Implementing EULA Feature with NetScaler n-Factor Schema

• CTX224027 - How to Change nsroot Password for NetScaler

• CTX109006 - How to Recover/Reset Password for Citrix ADC Appliance

Tools and Resources

• Preconfiguration check tool 

• Using the nspepi Tool to Convert Classic Expressions to Advanced Expressions

• Netscaler Notice of Status Change Announcement for Classic Policy Based Features and Functionalities 

FAQs

• FAQ: Citrix NetScaler MAC-Based Forwarding (MBF)

• FAQ: ADC High Availability Pair

• How to Restrict NetScaler Management Interfaces with ACLs

• How to Replace the Default Certificate of a NetScaler Appliance with a Trusted CA Certificate that Matches the Hostname of NetScaler

• How to create rewrite policy for Security Headers

• How to Free Space in the /flash Directory in a NetScaler Appliance

• How to Create a Perl Based Custom Monitor on NetScaler

• How do I setup a Diffie-Hellman key on NetScaler?

This document provides useful resources and links to help with upgrading NetScaler and for performing general configuration. See the best practice guides provided below to help with validating your deployment. The tools and resources section includes the Precheck Tool, which can be used before upgrading NetScaler. See also the nspepi tool, which can be used when converting from Classic to Advanced configuration settings.