Citrix ADC

Upgrade a Citrix ADC standalone appliance

October 19, 2020

Contributed by:

S C

Before upgrading the system software, make sure that you read the Before you begin section and complete the necessary prerequisites such as backing up the necessary files and downloading the Citrix ADC firmware.

Note

Starting with release 12.1, 64-bit Citrix ADC MPX and VPX images are supported, along with 32-bit images. For more information, see the Citrix Downloads site.

Upgrade a Citrix ADC standalone appliance by using the GUI

Follow these steps to upgrade a standalone Citrix ADC to release 12.1 by using the GUI.

In a web browser, type the IP address of the Citrix ADC, for example http://10.102.29.50.
In User Name and Password, type the administrator credentials (nsroot/nsroot) and then click Log On.
From the GUI, click System Upgrade.
From the Choose File drop-down menu choose the appropriate option: Local or Appliance. If you want to use the Appliance option, the firmware needs to be uploaded to the Citrix ADC first. You can use any file tranfer method such as WinSCP to upload the Citrix ADC firmware to the appliance.
Select the correct file and click Upgrade.
Follow the instructions to upgrade the software.
When prompted, select Reboot.

After the upgrade, close all browser instances and clear your computer’s cache before accessing the appliance.

Upgrade a Citrix ADC standalone appliance by using the CLI

Follow these steps to upgrade a standalone Citrix ADC to release 12.1 by using the CLI:

In the following procedure, <release> and <releasenumber> represent the release version you are upgrading to, and <targetbuildnumber> represents the build number that you are upgrading to. The procedure includes optional steps to avoid losing any updates that are pushed to the /etc directory during the upgrade.

Use an SSH client, such as PuTTy, to open an SSH connection to the appliance.
Log on to the appliance by using the administrator credentials. Save the running configuration. At the prompt, type:

save config
Switch to the shell prompt by running the following command:

shell
Create a copy of the ns.conf file. At the shell prompt, type:
- cd /nsconfig
- cp ns.conf ns.conf.NS<currentreleasenumber><currentbuildnumber>
You should backup the configuration file to another computer.
(Optional) If you have modified some of the following files in the /etc directory, and copied them to /nsconfig to maintain persistency, any updates that are pushed to the /etc directory during the upgrade might be lost:
- ttys
- resolv.conf
- sshd_config
- host.conf
- newsyslog.conf
- host.conf
- httpd.conf
- rc.conf
- syslog.conf
- crontab
- monitrc
To avoid losing these updates, create a /var/nsconfig_backup directory, and move the customized files to this directory. That is, move any files that you modified in /etc directory and copied to /nsconfig by running the following command:

cp /nsconfig/<filename> /var/nsconfig_backup

Example:

cp /nsconfig/syslog.conf /var/nsconfig_backup
Create a location for the installation package. At the shell prompt type:
- cd /var/nsinstall
- cd <releasenumber>
  
  Note:
  
  If the desired release number directory is not present, create one using the following command:
  
  mkdir <releasenumber>
  
  Example:
  
  mkdir 13.0
- mkdir build_<targetbuildnumber>
- cd build_<targetbuildnumber>
Copy the already downloaded Citrix ADC firmware to the build directory that you have created in the above step, by using any file transferring method such as WinSCP. See the Before You Begin section for more information about downloading the Citrix ADC firmware.
Extract the contents of the installation package. Example:

tar –xvzf build-12.1-32.2_nc_64.tgz

tar –xvzf build-12.1-32.2_nc_32.tgz
Run the installns script to install the new version of the system software.

./installns
When prompted, restart the Citrix ADC.
(Optionally) If you’ve created a copy of the ns.conf file in the Before You Begin section, do the following:
1. Manually compare the files in /var/nsconfig_backup and /etc and make appropriate changes in /etc.
2. To maintain persistency, move the updated files in /etc to /nsconfig.
3. Restart the appliance to put the changes into effect.

Below is an example of Citrix ADC firmware upgrade.

login: nsroot

Password: nsroot

Last login: Mon Apr 17 15:05:05 2018 from 10.252.243.134

Done

> save config

> shell

Last login: Mon Apr 17 15:05:05 2018 from 10.252.243.134

root@NSnnn# cd /var/nsinstall

root@NSnnn# cd 12.1

root@NSnnn# mkdir build_43.1

root@NSnnn# cd build_43.1

root@NSnnn# ftp <FTP server IP address>

ftp> mget build-12.1-41.1_nc.tgz

ftp> bye

root@NSnnn# tar xzvf build-12.1-41.1_nc.tgz

root@NSnnn# ./installns

installns version (12.1-41.1) kernel (ns-12.1-41.1_nc.gz)

...

Copying ns-12.1-41.1_nc.gz to /flash/ns-12.1-41.1_nc.gz ...

...

Installation has completed.

Reboot NOW? [Y/N] Y

Upgrade a Citrix ADC standalone appliance by using NITRO API

To use NITRO API to upgrade or downgrade a Citrix ADC, see Automate Citrix ADC Upgrade and Downgrade with a Single API.

Check and install Citrix ADC 12.1 software update

Update the Citrix ADC software when an update is available, for better performance. A Citrix ADC update can include feature improvements, performance fixes, or enhancements. Make sure you read the release notes to see what fixes and enhancements are available in the update. To check and install a software update, do the following.

In the Citrix ADC home page, click Check for Update from the nsroot drop-down menu at the top right corner of the page.
In the Latest System Software Updates Available page, check the available software update that you can install.
Click Download to download the installation package from the Citrix download website.
After you have downloaded the software package, install the update through either CLI or GUI procedure.

Note

The Check for Update link is accessible only if you log into the GUI through HTTP protocol and not through HTTPS protocol.

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

Upgrade a Citrix ADC standalone appliance

October 19, 2020

Contributed by:

S C

October 19, 2020

Contributed by:

S C

Upgrade a Citrix ADC standalone appliance

Upgrade a Citrix ADC standalone appliance by using the GUI

Upgrade a Citrix ADC standalone appliance by using the CLI

Upgrade a Citrix ADC standalone appliance by using NITRO API

Check and install Citrix ADC 12.1 software update

In this article