Upgrade

Each Citrix ADM release offers new and updated features with increased functionality. Citrix recommends you upgrade Citrix ADM to the latest release to avail of the new features and bug fixes. A comprehensive list of enhancements, known issues, and bug fixes is included in the release notes accompanying every release announcement. It is also important to understand the licensing framework and types of licenses that can be used before you start to upgrade. For Citrix ADM licensing information, see Licensing.

Before you upgrade

Download the upgrade package from the Citrix ADM Downloads page and follow the instructions in this article to upgrade your system to the latest 13.0 build. After the upgrade operation is started, Citrix ADM restarts and the existing connections are terminated and reconnected when the upgrade is completed successfully. The existing configuration is preserved, but Citrix ADM does not process any data until the upgrade is successfully completed.

Points to note before upgrading to 13.0:

  • If you are upgrading to Citrix ADM 13.0 build 36.27 version from either version 11.1 or from version 12.0 build earlier than 56.x, perform the following steps:

    • Upgrade from existing version to 12.0 build 57.24.

    • Upgrade to the latest build of version 12.1.

    • Upgrade to version 13.0.

      You must follow this two-step process because there are certain clean-up procedures required to upgrade successfully to 13.0 release. These procedures are available only from 12.0 build 56.x onwards.

    Note

    You cannot downgrade Citrix ADM from a 13.0 build to any build of an earlier release.

Recommended precautions:

  • Back up the Citrix ADM server before you upgrade.

  • After the upgrade, you might have to reestablish connections between the Citrix ADM server and the managed instances. A confirmation prompt warns you that connections can fail if you proceed.

  • For Citrix ADM servers in high availability setup, when upgrading, do not make any configuration changes on either of the nodes.

    Warning

    Do not refresh the browser until the upgrade process is successfully completed. It might take a few minutes for the upgrade process to finish.

  • After upgrade, the active node can change in a high availability pair.

Upgrade a single Citrix ADM server

To upgrade single Citrix ADM Server:

  1. Log on to Citrix ADM with administrator credentials.

  2. Navigate to System > System Administration. Under the System Administration subheading, click Upgrade Citrix ADM.

    localized image

  3. On the Upgrade Citrix ADM page, select the Clean software image on successful upgrade check box to delete image files after upgrade. Selecting this option removes the Citrix ADM image files automatically upon upgrade.

    Note

    This option is selected by default. If you do not select this check box before starting the upgrade process, you must manually delete the images.

    localized image

  4. You can then upload a new image file by selecting either Local (your local machine) or Appliance. The build file must be present on the Citrix ADM virtual appliance.

    localized image

  5. Click OK. The Confirm dialog box is displayed. Click Yes.

    The upgrade process starts.

    Localized image

Upgrade a high availability pair from 12.1 release to 13.0 release

For Citrix ADM servers in a high availability mode, you can upgrade by either accessing the active node or the floating IP address. Both the Citrix ADM servers are automatically upgraded to the latest build once you initiate the upgrade process in either of the servers.

Note

If you are upgrading a high availability pair from 12.0 or earlier releases, see Citrix ADM 12.1 Upgrade

Upgrade Citrix ADM disaster recovery deployment

Upgrading Citrix ADM disaster recovery deployment is a two-step process:

  • Upgrade the Citrix ADM nodes configured in high availability mode in the primary site. Later you must upgrade the disaster recovery node.

  • Ensure that you have upgraded the Citrix ADM servers that are deployed in high availability before upgrading the disaster recovery node.

Upgrade the Citrix ADM disaster recovery node

  1. Download Citrix ADM upgrade image file from Citrix download site.

  2. Upload this file to the disaster recovery node using “nsrecover” credentials.

  3. Log on to the disaster recovery node using the “nsrecover” credentials.

  4. Navigate to the folder where you placed the image file and unzip the file.

    localized image

  5. Run the following script:

    ./installmas

    localized image

Upgrade on-prem agents for multisite deployment

Upgrading Citrix ADM agent deployment is a three-step process. Ensure that you have completed the following tasks before upgrading the on-prem agents:

  1. Upgrade the Citrix ADM servers that are deployed in high availability.

  2. Upgrade the Citrix ADM disaster recovery node.

    For more information, see Upgrade Citrix ADM disaster recovery deployment.

Upgrade the on-prem agent

  1. Download Citrix ADM agent upgrade image file from Citrix download site.

  2. Upload this file to Agent node using “nsrecover” credentials.

  3. Ensure that you download the correct agent upgrade image. The following is an example of an image file name format:

    build-masagent-13.0-48.18.tgz

  4. Log on to the on-prem agent using the “nsrecover” credentials.

  5. Navigate to the folder where you placed the image file and unzip the file.

    localized image

  6. Run the following script:

    ./installmasagent

    localized image

Add an additional disk to the Citrix ADM server

If your Citrix ADM storage requirement exceeds the default disk space (120 gigabytes), you can attach an additional disk. You can attach additional disk in both single-server and high availability deployments.

When you upgrade Citrix ADM from release version 12.1 to 13.0, the partitions that you had created on the additional disk in the earlier version remain the same. The partitions are not removed nor are they resized.

The procedure to attach additional disk remains the same in the upgraded build. You can now use the new disk partitioning tool in Citrix ADM to create partitions in the newly added disk. You can also use tool to resize the partitions in the existing additional disk. For more information on how to attach additional disks and to use the new disk partitioning tool, see How to attach an additional disk to Citrix ADM.

Provision Citrix ADC instances in OpenStack using StyleBooks

From Citrix ADM 12.1 build 49.23 onwards, the architecture of OpenStack orchestration workflow has been updated. The workflow now uses Citrix ADM StyleBooks to configure Citrix ADC instances. If you are upgrading to Citrix ADM 13.0 from either version 12.0 or from version 12.1 build 48.18, you must run the following migration script:

/mps/scripts/migration_scripts/migrate_configurations.py

For more information about the “os-cs-lb-mon” StyleBook and the migrtaion script, see Provisioning of Citrix ADC VPX instance on OpenStack using StyleBook