Product Documentation

Use Case 2: Upgrading a Partition Deployment in a HA Setup

Nov 14, 2016

When upgrading NetScaler appliances in a high availability setup to software release 11.1, be sure to upgrade the secondary appliance first, and then upgrade the primary appliance.

Note: If you encounter any issues during the upgrade, roll back to version 11.0 for services managed by the NetScaler appliance.

Warning

Any customization within the partitioned appliance might cause an unexpected behavior during or after the upgrade process. This might lead to a configuration loss. Therefore, be sure to back up the running configuration of each admin partition and default partition before you begin the upgrade.

Important

The deployment described here is applicable when you have untagged VLANs passing through the port interface and bound to admin partitions.

There are two ways of implementing this deployment on a partitioned appliance.

  1. Tagging few VLANs before deploying NetScaler 11.1
  2. Enabling VLANs as "Shared" after deploying NetScaler 11.1

Tagging VLANs before deploying NetScaler 11.1

  1. Before you begin the upgrade on the secondary appliance, make a few VLANs tagged members of the port interface. For example:
         >bind partition p1 - vlan 10
         > unbind vlan 10 -ifnum 1/2
         >Done
         > bind vlan 10 -ifnum 1/2 -tagged
         >Done
  2. Access the secondary NetScaler appliance by entering its NSIP address in an SSH utility, such as PuTTY, and use the nsroot credentials to log on to the appliance.
  3. From the command line interface of the appliance, type the "save configuration" command to save the existing configuration. 
  4. Switch to the shell prompt 
    • login as: username
    • Using keyboard-interactive authentication.
    • Password:
    • Last login: Wed Jun 24 14:59:16 2015 from 10.252.252.65
    • Done
    • shell
    • Copyright (c) 1992-20   
  5. Run the following command to change to the default installation directory:                                           cd/var/nsinstall
  6. Run the following command to create a temporary subdirectory of the nsinstall directory:  
    • # mkdir x.xnsinstall   Note: The text x.x is used to name the NetScaler version for future configurations.  For example, the directory for the installation files of NetScaler 11.1 will be called 11.1nsinstall.
  7. Change to the x.xnsinstall directory.
  8. Download the installation package and documentation bundle, such as "ns-x.0-xx.x-doc.tgz", to the temporary directory created in Step 4. Note: Some builds do not have a documentation bundle. Installing the documentation is optional.
  9. Click the Documentation tab from the GUI to access the documentation.
  10. Before you run the install script, the files must be extracted and placed on the appliance. Use the following command to uncompress the bundle downloaded from Citrix website.                                                            
    • tar -zxvf ns-x.0-xx.x-doc.tgz  where                                                                                            
    • z = The file is a "gzipped" file
    • x = Extract files 
    • v = Print the file names as they are extracted one by one
    • f = Use the following tar archive for the operation
  11. Run the following command to install the downloaded software.  
    • # ./installns   Note: If the appliance does not have sufficient disk space to install the new kernel files, the installation process performs an automatic cleanup of the flash drive.
  12. After the installation process is completed you are prompted to restart the appliance. Press y to restart the appliance.
  13. Upgrade the secondary appliance to release 11.1, and then perform a force failover to make the secondary appliance primary.    
    • > force failover
  14. Access the new secondary appliance (formerly the primary) by entering its NSIP address in an SSH utility, such as PuTTY, and use the nsroot credentials to log on to the appliance.
  15. Repeat steps 3 through 13 to upgrade the current secondary appliance to release 11.1.
  16. After the installation process is complete, you are prompted to restart the appliance. Press y to restart the appliance.
  17. From the command line interface of the secondary appliance, type the following command to save the running configuration: save config
  18. Run "save config" command to make the secondary appliance is the primary appliance.
  19. Run "> force failover" command to make the secondary appliance is the primary appliance.
  20. Verify the appliance is now the  primary appliance.
  21. After upgrading both the primary and secondary appliances, enable the tagged VLANs as "Shared". This is a preferred choice as you will not encounter a configuration loss during upgrade.

Enabling VLANs as "Shared" after NetScaler 11.1 deployment

This scenario is about untagged VLANs and how to enable it as shared for VLAN deployment from an earlier release to 11.1 release. This is a least preferred scenario as it involves configuration loss during the software upgrade.

  1. Follow steps 2 to 20 of the previous procedure to upgrade the secondary appliance with NetScaler 11.1 software.
  2. After you have upgraded the software on the secondary appliance, VLAN bindings to partitions are lost, and the configuration depends on the VLAN inside the partition during the upgrade process.
  3. Now  enable  the untagged VLANs of any port interface "Shared" and bind the "Shared" VLAN to the partitions and configure the VLAN inside each partition. Note: Make sure you first enable the untagged VLANs as shared before you bind it to a partition. 
    • unbind partition p1 -vlan 10
    • Done
    • set vlan 10 -sharing enabled
    • Done
    • bind partition p1 -vlan 10
    • Done
  4. From the command line interface of the appliance, type "save config" command to save the configuration in all the affected partition and the default partition. 
  5. If the appliance is not a primary appliance, run the "> force failove" command to perform a force failover to ensure that the appliance is a primary appliance.
  6. Upgrade the new secondary (formerly the primary) appliance with NetScaler 11.1 software and reboot it to synchronize its configuration from the primary appliance.
  7. From the command line interface of the primary appliance, type the "save config" command to save the configuration in the primary appliance.
  8. If the appliance is not a primary appliance, run the "> force failover" command to perform a force failover to ensure that the appliance is a primary appliance.
  9. Verify that the appliance is a primary appliance.