NetScaler Gateway

Upgrade NetScaler appliance with NetScaler Gateway customization

This topic provides information on upgrading your NetScaler appliance when NetScaler Gateway has customization in place.

Prerequisites

  • Disable high availability synchronization and high availability propagation on both the nodes.
  • Take a backup of the /nsconfig and /netscaler/ns_gui folders.

Steps to upgrade NetScaler with NetScaler Gateway customization in place

  1. Change the UITHEME to default and save the configuration. At the command prompt, type;

    set vpn parameter -UITHEME Default
    save c
    
  2. Using WinSCP, delete the folder ns_gui_custom folder (path: /root/var/ns_gui_custom).

    Note: Deleting the folder might break the existing symbolic link between /root/netscaler/ns_gui folder and /var/netscaler/gui folder. This can be verified by opening the folder /netscaler/ns_gui from WinSCP. If there is an error, then perform the following:

  3. Change the directory to /root/netscaler.
  4. Right-click the folder ns_gui and click Edit Link.
  5. Edit the path to /var/netscaler/gui and click OK (even if the path is already /var/netscaler/gui).
  6. Make sure that the rc.netscaler file does not have any copy commands (path: /root/nsconfig/rc.netscaler). Note: You can even rename the rc.netscaler file and then restart the appliance.
  7. Import the new firmware file (build.xx.x.x.nc.tgz) from the local machine to the NetScaler ADC appliance (path: /root/var/nsinstall/xx.x.x.nc).
  8. Upgrade the NetScaler ADC appliance using the SSH client.

    shell

    #cd /var/nsinstall

    #cd xx.x.x.nc

    #tar –xvzf build.10.5.x.nc.tgz

    #installns

  9. After the installation, the NetScaler ADC appliance prompts for a restart. Restart the appliance. The NetScaler ADC appliance boots into the upgraded version of the NetScaler ADC appliance (xx.x.x.nc) with no customization applied.
  10. Using WinSCP, navigate to /root/netscaler/ns_gui.
  11. Replace the VPN folder with the customized VPN folder located on your local machine.
  12. Access the external URL to confirm if the custom files are applied.
  13. Run the following commands to make sure that the custom theme persists after the restart:

    shell

    #cd /var/

    #mkdir ns_gui_custom

    #cd /netscaler/

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

    #exit

    set vpn parameter –uitheme custom

    save c

  14. Restart the NetScaler ADC appliance.

Upgrade NetScaler appliance with NetScaler Gateway customization