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 the types of licenses that can be used before you start to upgrade. For Citrix ADM licensing information, see Licensing.

The Upgrade path information is also available in the Citrix Upgrade Guide.

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 process begins, ADM restarts and the existing connections are terminated and reconnected when the upgrade completes. 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 upgrade from version 11.1 or version 12.0 56.x and previous builds, perform the following steps:

  1. Upgrade from the existing version to 12.0 build 57.24.

  2. Upgrade to the latest build of version 12.1.

  3. Upgrade to version 13.0.

• If you upgrade from 12.0 build 57.24 and higher, first upgrade to 12.1 and then to 13.0.

• If you upgrade from 12.1, you can directly upgrade to 13.0.

• If you upgrade to 13.0 67.xx and later, first upgrade to 13.0 64.xx and then to 13.0 67.xx and later, for better user experience.

Important points to note before upgrading to 13.0 67.xx and later

When you upgrade the ADM software to version 13.0 67.xx and later, your ADM database is also migrated. This data migration happens because ADM now uses PostgreSQL version 10.11.

Note

Downgrading the ADM software is unsupported. Do not attempt to downgrade.

Recommended precautions:

• Take a snapshot of Citrix ADM server if you are upgrading to 13.0 67.xx and later.

• 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. Check the GUI for the approximate time for the upgrade to complete.

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

   

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.

   

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.

   

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

   The upgrade process starts.

After your configuration is migrated, you can log on to the ADM GUI. Upon logon, the historical data starts to migrate at the background while you can continue to work on ADM.

During historical data migration, some of the old data might not be available. The time taken to migrate your database depends on the size of data and the number of tables.

You can monitor the database migration using the ADM GUI. Click View upgrade progress and the Database Migration Status appears.

Troubleshooting database migration issues

During the upgrade process to 13.0 67.xx and later, sometimes the migration of Web Insight historical data might appear to be stuck. In such cases, to check details of data migration, do the following.

Log on to the ADM shell prompt and run the following command to see the granular details of the progress.

    cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status

<!--NeedCopy-->