Product Documentation

Transfer

Jun 04, 2018

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

The AppDNA licensing service 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 licensing service is typically as simple as installing the complete AppDNA server installation on the new machine. A stand-alone AppDNA licensing service installation is available if required. However, Citrix recommends that the AppDNA licensing service 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 licensing service.

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 licensing service 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 licensing service 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 licensing service.

You need to do these two steps for each AppDNA database that is affected by the AppDNA licensing service 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 licensing service 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 licensing service name correctly.
  9. When the export has finished, click Close to exit the wizard.

Note: If you are moving the AppDNA database to a new SQL Server installation as part of the Licenses server move, the database must be backed up after the the license token has been exported.

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 licensing service to the new machine. Typically you do this by installing the complete AppDNA server installation on the new machine.

  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 licensing service 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. 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 licensing service and not the AppDNA server.