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.1 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 completes.

Points to note before upgrading to 13.1:

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

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

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

• If you upgrade from versions lower than 13.0 64.xx, for better user experience, first upgrade to 13.0 64.xx and then to 13.1.

Important points to note before upgrading to 13.1 xx.xx and later

When you upgrade the ADM software to version 13.1 xx.xx, 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.1 xx.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.

• If you upgrade to any version between 13.1.9.x and 13.1.30.x, Citrix ADM rolls back the existing StyleBooks ConfigPacks to its earlier version.

  To avoid this issue, upgrade to 13.1.33.50 build.

• 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 13.1-12.x

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.

6. The Upgrade ADM page displays few details such as file name, selected version, estimated time to complete, and so on. Click Upgrade.

   

   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.

After the upgrade is complete, you can view the message that the default free licenses get reduced to two. Click View Details for more information.

Upgrade a single Citrix ADM server to 13.1-4.x or 13.1-9.x

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.1 xx.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-->