Blog, Citrix, NetScaler

NetScaler 10.5 – Cannot login admin GUI after firmware upgrade

Normally before you upgrade NetScaler you should check if you have NetScaler Gateway theme customised and set theme to Default from the NetScaler Gateway Global Settings and Client Experience tab before doing upgrade. If you forgot to do that and already upgraded NetScaler you might find out that admin GUI login won’t work anymore. Here are the steps to fix that.

Go to NetScaler console.

Change to default theme:

>set vpn parameter -UITHEME DEFAULT

Save NetScaler configuration:

>save ns config

Reboot device:


After device comes up, you should be able to login via admin GUI again.


If you want to apply customised theme back again after firmware upgrade, change NetScaler Gateway UI theme back to Green Bubble from GUI. Make your customisations on it and when you are happy for the results, run the following commands in NetScaler shell:

Backup current configuration:

# cd /nsconfig
# cp ns.conf

Create custom theme:

# mkdir /var/ns_gui_custom
# cd /netscaler
# tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*

This creates the file customtheme.tar.gz which are used by NetScaler Gateway and also makes sure the NetScaler Gateway customisation is retained after reboot. Now change Custom theme back from the NetScaler Gateway Global Settings and Client Experience tab.





Views: 4545

Jani Kohonen Visit Website
Jani Kohonen is an author of and working as a Citrix Consultant and Architect with 22 years of experience in the IT industry. Jani's been working in the IT industry since 1997 and with Citrix technologies since 2001. He holds several years experience with Microsoft, Citrix, Apple, HP and VMware vendors as well as Server, Application and Desktop virtualization and Mobile technologies. He has done dozens of virtualization design and implementation projects from Small Business to the large global enterprise customers and complex environments. Jani has been awarded as Citrix Technology Advocate (CTA).
Related Posts
Citrix Workspace App 1910.2 for macOS
XenMobile 8.7 Shared Devices Configuration
XenMobile 10 – Configuration Series Part 1: Installing in FIPS 140-2 Compliance Mode

Leave Your Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.