Upgrade a high availability pair 编辑

One of the requirements of Citrix ADC appliances in a high availability setup is to install the same Citrix ADC software release on both appliances of the setup. Therefore, when software on one appliance is upgraded, ensure that the software is upgraded on both the appliances.

You can follow the same procedure to upgrade a standalone appliance or each appliance in a high availability pair, although additional considerations apply to upgrading a high availability pair.

Before you start a Citrix ADC firmware upgrade on an HA pair, read the prerequisites mentioned in the Before you begin section. Also, you need to consider a few HA-specific points.

Points to note

• IMPORTANT:

  It is important that both the upgrade changes and your customizations are applied to an upgraded Citrix ADC appliance. So, if you have customized configuration files in the /etc directory, see Upgrade considerations for customized configuration files before you proceed with the upgrade.

• First upgrade the secondary node, and then the primary node. Upgrading software on the secondary appliance before the primary appliance ensures that the upgrade process is completed without any issues.

• If both the nodes in a high availability (HA) setup are running different Citrix ADC software releases, the following functionalities are disabled:
  • HA config synchronization
  • HA command propagation
  • HA synchronization of states services information
  • Connection mirroring (connection failover) of sessions
  • HA synchronization of persistence sessions information

• The above mentioned functionalities are disabled, if both the nodes in a high availability (HA) setup are running different builds of the same release but both the builds have different internal HA versions. The above mentioned functionalities works fine if both the nodes in a high availability (HA) setup are running different builds of the same release but both the builds have the same internal HA versions.

  Refer to the New internal HA version in Citrix ADC builds section to check if the internal HA version has changed in a Citrix ADC build.

• Synchronization of the files in the All mode of the Sync HA files command works successfully if the two nodes in an HA configuration are running different Citrix ADC software releases, or the two nodes are running different builds of the same release. For more information, see Synchronising Configuration Files in High Availability Setup.

Figure. Upgrade a high availability pair

You can upgrade using the Citrix ADC CLI or GUI.

New internal HA version in Citrix ADC builds

The following table lists the Citrix ADC builds that have a new internal HA version:

Upgrade a high availability pair by using the CLI

The upgrade process includes the following steps:

1. Upgrade software on the secondary appliance
2. Upgrade software on the primary appliance
3. Synchronize secondary appliance

Upgrade software on the secondary appliance

The following illustration depicts the procedure to upgrade software on the secondary appliance:

1. Log on to the secondary appliance using an SSH utility, such as PuTTY and specifying the Citrix ADC IP (NSIP). Use the nsroot credentials to log on to the appliance.

2. From the command line interface of the appliance, type the following command to save the existing configuration:

   save config
   <!--NeedCopy-->