Product Documentation
ADC
14.1 - Current Release 13.1 13.0 12.1
View PDF

Upgrade a Citrix ADC standalone appliance

October 4, 2023
Contributed by:
C S

Before upgrading the system software, make sure that you read theBefore you beginsection 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.

  1. In a web browser, type the IP address of the Citrix ADC, for examplehttp://10.102.29.50.
  2. In User Name and Password, type the administrator credentials (nsroot/nsroot) and then clickLog On.

  3. Navigate toSystemand clickSystem Upgrade.

  4. From theChoose Filedrop-down menu choose the appropriate option:LocalorAppliance. 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.

  5. Select the correct file and clickUpgrade.

  6. Follow the instructions to upgrade the software.

  7. When prompted, selectReboot.

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,andrepresent the release version you are upgrading to, andrepresents 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.

  1. Use an SSH client, such as PuTTy, to open an SSH connection to the appliance.

  2. Log on to the appliance by using the administrator credentials. Save the running configuration. At the prompt, type:

    save config

  3. Switch to the shell prompt by running the following command:

    shell

  4. Create a copy of the ns.conf file. At the shell prompt, type:

    • cd /nsconfig
    • cp ns.conf ns.conf.NS

    You should backup the configuration file to another computer.

  5. (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/ /var/nsconfig_backup

    Example:

    cp /nsconfig/syslog.conf /var/nsconfig_backup

  6. Create a location for the installation package. At the shell prompt type:

    • cd /var/nsinstall

    • cd

      Note:

      If the desired release number directory is not present, create one using the following command:

      mkdir

      Example:

      mkdir 13.0

    • mkdir build_
    • cd build_

  7. 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 theBefore You Beginsection for more information about downloading the Citrix ADC firmware.

  8. 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

  9. Run the installns script to install the new version of the system software.

    ./installns

  10. When prompted, restart the Citrix ADC.

  11. (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> 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, seeAutomate Citrix ADC Upgrade and Downgrade with a Single API.

检查和安装Citrix ADC 12.1软件更新

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.

  1. In the Citrix ADC home page, clickCheck for Updatefrom thensrootdrop-down menu at the top right corner of the page.
  2. In theLatest System Software Updates Availablepage, check the available software update that you can install.
  3. ClickDownloadto download the installation package from theCitrix downloadwebsite.
  4. After you have downloaded the software package, install the update through either CLI or GUI procedure.

Note

TheCheck for Updatelink is accessible only if you log into the GUI through HTTP protocol and not through HTTPS protocol.

Upgrade a Citrix ADC standalone appliance
October 4, 2023
Contributed by:
C S
October 4, 2023
Contributed by:
C S

In this article

Site feedback | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999-Cloud Software Group, Inc. All rights reserved.