Use jobs to upgrade Citrix ADC instances

You can use Citrix Application Delivery Management (ADM) to upgrade one or more Citrix ADC instances. You must know the licensing framework and types of licenses before you upgrade an instance.

When you upgrade your Citrix ADC instance by creating a maintenance job, perform pre-validation check on the instances that you want to upgrade.

  1. Check for customizations - Back up your customizations and delete them from the instances. You can reapply the backed-up customizations after the instance upgrade.

  2. Check the disk usage - If the /var folder has less than 6 GB space and the /flash folder has less than 200 MB space, clean up the disk space. Check the following folder paths to clean the disk space:

    • /var/nstrace
    • /var/log
    • /var/nslog
    • /var/tmp/support
    • /var/core
    • /var/crash
    • /var/nsinstall
    • /var/netscaler/nsbackup
  3. Check for disk hardware issues - Resolve the hardware issues if any.

You can upgrade an ADC HA pair in two stages:

  1. Create an upgrade job and execute on one of the nodes immediately or schedule later.

  2. Schedule the upgrade job to execute on the remaining node later. Ensure to schedule this job after the initial node’s upgrade.

When you upgrade an ADC HA pair, note the following:

  • The secondary node is upgraded first.

  • Synchronization and propagation of the nodes are disabled until both the nodes are upgraded successfully.

  • After the successful HA pair upgrade, an error message appears in the execution history. This message appears if your nodes in the HA pair are on different builds or versions. This message indicates that synchronization between primary and secondary node is disabled.

When you upgrade an ADC cluster, the ADM does pre-upgrade validation on the specified instance only. Before you upgrade, check and resolve customization, disk usage, and hardware issues on the cluster nodes.

Create an upgrade maintenance job to upgrade ADC instances

  1. In Citrix ADM, navigate to Networks > Configuration Jobs > Maintenance Jobs. Click the Create Job button.

    Create maintenance job

  2. In Create Maintenance Jobs, select Upgrade Citrix ADC (Standalone/High-Availability/Cluster) and click Proceed.

    Select upgrade maintenance job

  3. In Select Instance, type a name of your choice for Job Name.

  4. Click Add Instances to add ADC instances that you want to upgrade.

    • To upgrade an HA pair, specify the IP address of either primary or secondary node.

    • To upgrade a cluster, specify the cluster IP address.

    Add instances to upgrade maintenance job

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

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

    Important

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

  6. Optional, in Custom scripts, specify the scripts to execute before and after an instance upgrade. Use one of the following ways to execute the commands:

    • Import commands from file - Select the command input file from your local computer.
    • Type commands - Enter commands directly on the GUI.

    Custom scripts

    You can use custom scripts to check the changes before and after an instance upgrade. For example:

    • The instance version before and after upgrade.
    • The status of interfaces, high-availability nodes, virtual servers, and services before and after upgrade.
    • The statistics of virtual servers and services.
    • The dynamic routes.
  7. In Schedule Task, select one of the following options:

    • Upgrade now - The upgrade job executes immediately.

    • Schedule Later - Select this option to execute 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 HA pair in two stages, select Perform two stage upgrade for nodes in HA.

      Specify the Execution Date and Start Time when you want to upgrade another instance in the HA pair.

  8. In Create Job, specify the following details:

    1. Select one of the following options from the Software Image list:

      • Local - Select the instance upgrade file from your local machine.

      • Appliance - Select the instance upgrade file from an ADM file browser. The ADM GUI displays the instance files that are present at /var/mps/mps_images.

    2. 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 executes at the scheduled time.

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

    • Clean software image from Citrix ADC on successful upgrade - Select this option to clear the uploaded image in the ADC instance after the instance upgrade.

    • Backup the ADC instances before starting the upgrade. - Creates a backup of the selected ADC instances.

    • Receive Execution Report through email - Sends the execution report in email.

      • Add - Enables you to add an email distribution list. When you click the Add button, the Create Email Distribution List page is displayed. Type the values for all parameters and click Create.

        Add email

        Click Email* and select the configured distribution list to send the execution report.

        Specify details of email distribution list

        Note: Contact your administrator if you get any errors while creating the email distribution list.

      • Edit - Enables you to edit the values for all parameters. Click OK, after you update the values.

      • Test - Sends a test email to the configured email address.

    • Receive Execution Report through slack - Sends the execution report in slack.

      • Add - Enables you to add a slack channel. When you click the Add button, the Create Slack Profile page is displayed. Type the values for all parameters and click Create.

        Add Slack channel

        Select the channel from the list to send the execution report.

        Note

        Contact your administrator if you get any errors while creating the Slack channel.

      • Edit - Enables you to edit the values for all parameters.

  9. Click Create Job.

    Create upgrade job and upload image to ADC