Product Documentation

Transfer

Oct 08, 2015

AppDNA licenses are tied to the AppDNA database and the machine on which the AppDNA license server is installed. If you need to move the AppDNA license server from one machine or environment to another, you need to transfer the licenses for all of your AppDNA databases as described below.

The AppDNA license server is automatically installed when you install a complete AppDNA server installation. Therefore if you need to move your AppDNA server installation from one machine to another, you need to transfer the licenses for your database. Moving your AppDNA license server is typically as simple as installing the complete AppDNA server installation on the new machine. A stand-alone AppDNA license server installation is available if required. However, Citrix recommends that the AppDNA license server is on the same machine as the AppDNA server machine whenever possible.

Note: It is not necessary to transfer licenses if you simply want to move a database from a SQL Server installation on one machine to a SQL Server installation on another machine – provided there is no change in the location of the AppDNA license server.

Transferring a license involves the following steps:

  1. Export the license transfer token – This exports a license transfer token from the database and saves it to a file. During this step you need to enter the name of the new AppDNA license server machine. After exporting the token, the database will be unlicensed until you complete the import steps.
  2. Import the license transfer token – Run this step after the AppDNA license server is set up on the new machine. In this step, you import the license transfer token (which unlocks the database) and reactivate the license against the new AppDNA license server.

You need to do these two steps for each AppDNA database that is affected by the AppDNA license server move. Instructions are provided for each of these steps under separate headings below.

Export the license transfer token

  1. From the Windows Start menu on the AppDNA server machine, choose Citrix AppDNA > Management Tools > Configure AppDNA.
  2. In the first step in the Configure AppDNA Environment wizard, choose Licensing and then click Next.
  3. In the License Management step, choose Transfer and then click Next.
  4. In the Transfer License step, select the database whose license you want to transfer.

    If the database whose license you want to transfer does not appear in the list of databases, click Cannot see the database in the list to open the Enter Database Details dialog box. See Transfer License for more information about this dialog box.

  5. Select Export, and then click Next.
  6. Specify the name and location for the exported license token file.
  7. Specify the name of the new AppDNA license server machine.

    The exported license token will be tied to this machine. You must specify this correctly, or the database will become permanently unusable. If you do not yet know the name of the machine on which the AppDNA license server will be installed, cancel the export now and start it again when you are sure of the machine name.

  8. Click Next to export the license transfer token. AppDNA then asks you to confirm that you have specified the new AppDNA license server name correctly.
  9. When the export has finished, click Close to exit the wizard.

You now need to import the license transfer token and, if necessary, reactivate the license, as explained next.

Import the license transfer token

Perform this step after you have moved the AppDNA license server to the new machine. Typically you do this by installing the complete AppDNA server installation on the new machine.

Note: A stand-alone AppDNA license server installation is available if required. However, Citrix recommends that the AppDNA license server is on the same machine as the AppDNA server machine whenever possible.
  1. From the Windows Start menu on the AppDNA server machine, choose Citrix AppDNA > Management Tools > Configure AppDNA.
  2. In the first step in the Configure AppDNA Environment wizard, choose Licensing and then click Next.
  3. In the License Management step, choose Transfer and then click Next.
  4. In the Transfer License step, select the database whose license you want to transfer.

    If the database whose license you want to transfer does not appear in the list of databases, click Cannot see the database in the list to open the Enter Database Details dialog box. See Transfer License for more information about this dialog box.

  5. Select Import, and then click Next.
  6. Specify the name and location of the exported license token file.
  7. Specify the name of the new AppDNA license server machine. This must be the same as that specified in Step 7 of the export procedure.

    You can generally accept the default port number of 8079. See Import Transfer Token to Unlock Database for more information about this.

  8. Click Next to import the license transfer token and unlock the database.
  9. If you are using an AppDNA license issued through www.citrix.com the Reallocate license file step then opens:
    • Activate now – Select this option if you want to reallocate your license now. You now need to log on to http://www.citrix.com to reallocate your license to the new AppDNA license server machine and download a new license file (see http://support.citrix.com/article/CTX126167 for step-by-step instructions).

      When you do this, you must enter the name of the machine that hosts the new AppDNA license server. Click Copy to copy this to the clipboard for pasting into www.citrix.com. After reallocating the license and downloading the license file, enter its name and location.

    • I'll do this later – Select this option if you want to reallocate the license file later. You may not be able to view reports for all applications until you reallocate the license.
    Note: This step does not appear if the database was activated using a XenDesktop or XenApp Platinum license only.
  10. Click Next to complete the operation.

Typically you now need to add the database to the AppDNA web site, as described in Add an existing AppDNA database. However, this is not necessary if you moved only the AppDNA license server and not the AppDNA server.