Product Documentation

Upgrade

Nov 28, 2017

Important

AppDNA includes all major OS images and loads them when you install or upgrade. As a result, it can take up to a few hours, particularly on less optimal hardware, to install AppDNA in a configuration with a remote SQL server or to upgrade AppDNA. An installation with the database on the same machine as the web server will be as fast as it was previously.

Prepare for an upgrade

From AppDNA 7.13, the AppDNA server and client are installed as 64-bit processes and are supported on 64-bit versions of Windows OS platforms. If the installer detects a 32-bit version of Windows, it does not proceed. This move to 64-bit does not affect AppDNA tools (Install Capture, Self Provisioning Client, Virtual Machine Configuration, Web Application Capture, Remote Admin, and Snapshot Manager). You can continue to install these tools on supported 32-bit or 64-bit OS platforms.

The following steps show you how to prepare for an upgrade if you are moving the AppDNA server from a 32-bit to a 64-bit machine.

  1. Prepare the 64-bit machine that AppDNA will be migrated to.
  2. From Start > Configure AppDNA > Licensing, export the license from the AppDNA 7.12 (or earlier version between 7.6.5 and 7.12) on the 32-bit machine. For steps on how to export the license token, see Transfer.
  3. Back up the AppDNA database.
  4. Restore the AppDNA database to the new SQL Server.
  5. Install AppDNA 7.12 (or the version previously installed) on the new 64-bit machine.
  6. From Start > Configure AppDNA > Licensing, import the license back into the database on the 64-bit machine. For steps on how to import the license token, see Transfer.
  7. From Start > Configure AppDNA > Reconfigure database, select Add existing database to add the database to AppDNA.
  8. Upgrade the new installation to the latest version of AppDNA (64-bit). For steps on upgrading, see the next section.

Note

An upgrade may consume 30 GB or more of SQL Transaction Log space. This can vary depending on the upgrade path and SQL server versions. Ensure that the disk configured to store the SQL log files has at least 50 GB of free space. In addition we recommend backing up and truncating the transaction log before and after the upgrade.
Please allow 2-3 hours for the upgrade to complete.

Upgrade from AppDNA 7.6.5 and later

  1. Run the installer as described in Install AppDNA
  2. Use the Configure AppDNA Environment wizard to upgrade each database as described in Upgrade a database.

    If you were already using a XenApp or XenDesktop Platinum license with AppDNA, the upgrade makes all AppDNA features available to you.

    Note: When you upgrade to AppDNA, a one-time manual license reactivation is required if your Subscription Advantage date has expired.
  3. Upgrade the AppDNA tools as described in Upgrade AppDNA tools.
  4. Upgrade any remote AppDNA clients: Run the installer as described in Install AppDNA.
  5. If you have forward path scripts with references to the following operating systems or features, remove the references or delete the scripts: Windows XP, Windows Vista, Windows Server 2003 SP3, Windows Server 2008 SP2, and XenApp Streamed.

    Those report modules are deprecated.

Upgrade from AppDNA 6.3 and earlier

You can also upgrade directly to AppDNA from AppTitude 5.1, AppDNA 6.0, AppDNA 6.1, AppDNA 6.1 SP1, AppDNA 6.2, and AppDNA 6.3. Do not uninstall the previous version before installing AppDNA 7.6. The installer will automatically delete any unnecessary old files while preserving your settings and configuration options.

Before you upgrade

Before you upgrade, review the following information.

  • System requirements

    Make sure that your environment meets the System requirements.

  • Disk space requirements

    In AppDNA 6.0 and later, the results of the analysis of the application DNA are stored in the database in a format optimized for report generation. When you upgrade from AppTitude 5.1, the size of your database will increase by approximately 15% so ensure that you have sufficient disk space available before you upgrade.

    Default OS images are installed in the database for all relevant versions of Windows. This requires significant additional disk space (2 - 3GB) if you are upgrading from AppDNA 6.0 or earlier and previously chose to install only a subset of the available OS images.

  • Families and suites

    The upgrade to AppDNA 7.6 removes existing families and suites and flattens the application list to its original form. Please contact Citrix support before upgrading AppDNA if the removal of families and suites will cause issues

  • Time needed to upgrade

    Upgrading a database from AppTitude 5.1 can take a long time, particularly if you have a large application portfolio. On a recommended software and hardware configuration, the upgrade time is expected to be approximately one hour per 500 applications if all reports are enabled. Upgrading from AppDNA 6.0 or later is not expected to take as long.

The results of an upgrade include the following.

  • External data handling when upgrading from AppDNA 6.1 SP1 (6.1.610)

    AppDNA 6.1 SP1 (6.1.610) included a technical preview of the Windows 8 and Windows Server 2012 support. External data for those platforms was not included as part of the technical preview. An upgrade to AppDNA 7.6 does not apply the external data for Windows 8 and Windows Server 2012 to previously generated analysis results. You must re-analyze the applications to update the reports with the external data.

  • Installation location

    By default, the AppDNA files are installed into Program Files\Citrix\AppDNA.

  • Web site name

    If you upgrade from AppDNA 6.0 or earlier, the upgrade process renames the AppTitude web site to AppDNA, preserving the configuration files and moving them to the new location.

  • Licensing

    The licensing system integrates with the Citrix licensing system. All new AppDNA licenses are issued through http://www.citrix.com. However, if you are upgrading from AppDNA 6.0 or earlier, valid old licenses are upgraded automatically to the new licensing scheme when you upgrade your database.

    Important: If your AppDNA licensing service is located on a separate machine from the AppDNA Web server, you need to upgrade it before you upgrade the AppDNA database. To do this, download Citrix AppDNA License Server.msi and run it on the machine that hosts the AppDNA licensing service.

To upgrade a single-machine or server installation

This procedure applies to upgrades from AppDNA 6.3 and earlier.

  1. Upgrade the server on which you plan to install AppDNA if it does not meet the System requirements.
  2. Run the installer as described in Install AppDNA.
  3. Use the Configure AppDNA Environment wizard to upgrade each database as described in Upgrade a database.
  4. Upgrade the AppDNA tools as described in Upgrade AppDNA tools.
  5. If there are any remote AppDNA clients, upgrade each one as described next.

After the upgrade, we recommend that you re-analyze applications to take advantage of the data provided by new and improved algorithms.

To upgrade a client installation

This procedure applies to upgrades from AppDNA 6.3 and earlier.

  1. Upgrade the client on which you plan to install AppDNA if it does not meet the System requirements.
  2. Run the installer as described in Install AppDNA.
  3. Configure the client to connect with the server as described in Configure a client installation.
  4. Upgrade the AppDNA tools as described in Upgrade AppDNA tools.

After the upgrade, we recommend that you re-analyze applications to take advantage of the data provided by new and improved algorithms.