Citrix Application Delivery Management service

Upgrade Advisory

As a network administrator, you might manage many ADC instances running on different ADC releases in Citrix ADM. Monitoring the lifecycle of each ADC instance can be a cumbersome task. You must visit Citrix Product Matrix, identify the ADC instances that are reaching or reached End of Life (EOL) or End of Maintenance (EOM). Then, plan their upgrade.

To ease this process, Citrix ADM upgrade advisory helps you monitor the lifecycle of your ADC instances in the following ways:

  • Identifies instances reaching or reached EOL or EOM. So, you can plan ADC upgrades ahead of EOL or EOM date.

  • Highlights the instances that are not on latest release or build. You can upgrade these instances to latest release or build. With this upgrade, you receive updates on new features and fixed issues.

  • Highlights the instances that are not on preferred ADC builds. Some organizations might have a preferred ADC builds for their instances. In Citrix ADM, you can set the preferred build for your organization depending on build stability, features, and other considerations. Then, review and upgrade the instances that are not on preferred builds. Instances running the preferred builds are indicated with a star icon.

  • Highlights instances running on the most popular releases or builds. Instances running the popular builds are indicated with a ribbon icon.

The upgrade advisory provides links to corresponding release notes. With this information, you can review and decide an ADC build for upgrade. You can proceed to create a maintenance job to upgrade ADC instances from the Upgrade Advisory page.


Upgrade advisory only monitors EOL of ADC software releases. It doesn’t check the EOL of ADC appliances.

View upgrade advisory

Navigate Infrastructure > Instance Advisory > Upgrade Advisory and view the following information:

  • Total count of ADC instances.
  • Instances reaching the end of life.
  • Instances reaching the end of maintenance.
  • Instances in older build.
  • Instances not in preferred build.
  • End of Life and End of Maintenance dates for the various ADC releases.

Upgrade Advisory page

The Upgrade Advisory page groups the ADC instances by their releases. The Release Notes link guides you to the specific ADC release notes. Review new features, fixed, and known issues before deciding to upgrade. You can select multiple ADC instances across different releases to upgrade at a time. When you proceed with an upgrade, it creates an upgrade job. See, Upgrade ADC instances.

Set the preferred builds

As an administrator, you can define a preferred ADC build for organization. Do the following to set the preferred build:

  1. In Infrastructure > Instance Advisory > Upgrade Advisory, click Settings.

  2. Select the preferred release and build.

    Set the preferred build

    In this example, the preferred builds are 13.0-58.30 and 13.0-67.39.

  3. Click Save.

Upgrade ADC instances

In the Upgrade Advisory page, after your review, do the following steps to upgrade the required ADC instances:

  1. Select the instance builds that you want to upgrade and click Select instances to upgrade.

  2. Select the ADC instance that you want to upgrade and click Proceed to upgrade workflow.

    Upgrade workflow

    This workflow creates an upgrade job.

  3. In the Select Instance tab,

    1. Specify a name to the upgrade job.

    2. (Optional) if you want to add other instances, click Add Instances.

      Add instances to upgrade maintenance job

    3. Click Next.

  4. In the Select Image tab, select an ADC image from the image library or local or appliance.

    • Select from Image Library: Select an ADC image from the list. This option lists all ADC images that are available in the Citrix Downloads website.

      ADC images

      The ADC software images display the preferred builds with the star icon. And, most downloaded builds with the bookmark icon.

    • Select from local or appliance: You can upload the image from your local computer or the ADC appliance. When you select ADC appliance, the Citrix ADM GUI displays the instance files that are present in /var/mps/mps_images. Select the image from the Citrix ADM GUI.

    • Skip image uploading to ADC if the selected image is already available - This option checks whether the selected image is available in ADC. Upgrade job skips uploading a new image and uses the image available in ADC.

    • Clean software image from Citrix ADC on successful upgrade - This option clears the uploaded image in the ADC instance after the instance upgrade.

    Click Next to start the pre-upgrade validation on the selected instances.

  5. The Pre-upgrade validation tab displays the failed instances. you can remove the failed instances and click Next.

    Pre-upgrade validation

    • Disk Space Check: If you face insufficient disk space on an instance, you can check and clean up the disk space. See, Clean up ADC disk space.

    • Policy Check: If Citrix ADM finds unsupported classic policies, you can remove such policies to create an upgrade job.


    If you specify cluster IP address, the Citrix ADM does pre-upgrade validation only on the specified instance not on the other cluster nodes.

  6. Optional, in the Custom scripts tab, specify the scripts to run before and after an instance upgrade.

    Custom scripts

    For more information, see Use custom scripts.

  7. In the Schedule Task, select one of the following options:

    • Upgrade Now - The upgrade job runs immediately.
    • Schedule Later - Select this option to run this upgrade job later. Specify the Execution Date and Start Time when you want to upgrade the instances.

    If you want to upgrade an ADC high-availability pair in two stages, select Perform two stage upgrade for nodes in HA.

    Perform two stage upgrade

    For more information, see Upgrade ADC high-availability pair.

  8. In the Create Job tab, specify the following details:

    If you schedule the upgrade job, you can specify when you want to upload the image to an instance:

    • Upload now: Select this option to upload the image immediately. However, the upgrade job runs at the scheduled time.

    • Upload at the time of execution: Select this option to upload the image at the time of upgrade job execution.

For more information on the other options, see ADC upgrade options.

Upgrade Advisory