Product documentation
Citrix ADC
Current Release 13.0 12.1 11.1
View PDF

Downgrade a Citrix ADC standalone appliance

September 14, 2021
Contributed by:
C

You can downgrade to any earlier release on a standalone Citrix ADC by using the CLI or GUI.

Note:

Loss in configuration might occur when downgrading. Compare the configurations before and after the downgrade, and then manually reenter any missing entries.

Downgrade a Citrix ADC appliance by using the CLI

Follow the steps given below to downgrade a Citrix ADC standalone appliance running release 13.0 to an earlier release.

In this procedure,andrepresent the release version you are downgrading to, andrepresents the build number that you are downgrading to.

  1. Open an SSH connection to the Citrix ADC by using an SSH client, such as PuTTY.

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

    save config

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

    1. cd /nsconfig
    2. cp ns.conf ns.conf.NS

    You should backup a copy of the configuration file on another computer.

  4. Copy the configuration file (ns.conf.NS) to ns.conf. At the shell prompt, type:

    cp ns.conf.NS ns.conf

    Note:

    ns.conf.NSis the backup configuration file that is automatically created when the system software is upgraded from release versionto the current release version.

    There may be some loss in configuration when downgrading. After the appliance restarts, compare the configuration saved in step 3 with the running configuration, and make any adjustments for features and entities configured before the downgrade. Save the running configuration after making the changes.

    Important:

    If routing is enabled, perform step 5. Otherwise, skip to step 6.

  5. If routing is enabled, the ZebOS.conf file contains the configuration. At the shell prompt, type:

    cd /nsconfig cp ZebOS.conf ZebOS.conf.NS cp ZebOS.conf.NS ZebOS.conf

  6. Change directory to/var/nsinstall/nsinstall, or create one if it does not exist.

  7. Change directory tobuild_, or create one if it does not exist.

  8. Download or copy the installation package (build--.tgz) to this directory and extract the contents of the installation package.

  9. Run theinstallnsscript to install the new version of the system software. The script updates the/etcdirectory.

    If the configuration file for the build that you are downgrading to, exists on the appliance, you are prompted to load that configuration:

    Figure 1. Downgrade menu if configuration file exists

    image

    If the free space available on the flash drive is insufficient to install the new build, the Citrix ADC aborts the installation. Manually clean up the flash drive and restart the installation.

Example:

登录:nsroot密码:nsroot最后登录:星期一4月24 02:06:52 2017 from 10.102.29.9 Done > save config > shell root@NSnnn# cp ns.conf.NS10.5 ns.conf root@NSnnn# cd /var/nsinstall root@NSnnn# mkdir 10.5nsinstall root@NSnnn# cd 10.5nsinstall root@NSnnn# mkdir build_57 root@NSnnn# cd build_57 root@NSnnn# ftp 10.102.1.1 ftp> mget build-10.5-57_nc.tgz ftp> bye root@NSnnn# tar -xzvf build-10.1-125_nc.tgz root@NSnnn# ./installns installns version (10.5-57) kernel (ns-10.5-57.gz) ... ... ... Copying ns-10.5-57.gz to /flash/ns-10.5-57_nc.gz ... Changing /flash/boot/loader.conf for ns-10.5-57 ... Installation has completed. Reboot NOW? [Y/N] Y

Downgrade a Citrix ADC appliance by using the GUI

You can use the upgrade wizard of the GUI to downgrade a Citrix ADC appliance running release 13.0 to an earlier release.

Notes:

You cannot downgrade a Citrix ADC appliance running release 13.0 directly to release 10.5 or earlier by using the GUI. Citrix recommends using the CLI for downgrading.

Visit theProduct Matrixsite for more information on the Citrix ADC release lifecycle.

It is a best practice to downgrade to one major release at a time.

For example, if the Citrix ADC appliance is on release 13.0, and you want to downgrade to release 12.0, you must downgrade the appliance to release 12.1 first, and then to release 12.0.

Follow the steps given below to downgrade a Citrix ADC appliance running release 13.0 to an earlier release by using 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 and then clickLog On.

  3. From the GUI, clickSystem Upgrade.

    Citrix ADC GUI升级奇才ard

  4. From theChoose Filemenu choose the appropriate option:LocalorAppliance. If you want to use the Appliance option, the firmware must be uploaded to the Citrix ADC first. You can use any file transfer 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 downgrade the software.

  7. When prompted, selectReboot.

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

The following resources provide related information about upgrading or downgrading a Citrix ADC appliance:

Downgrade a Citrix ADC standalone appliance
September 14, 2021
Contributed by:
C
September 14, 2021
Contributed by:
C

In this article

Site feedback | Privacy and legal terms | Cookie preferences | Consent settings
© 1999-Citrix Systems, Inc. All rights reserved.