Configure a server installation

Aug 14, 2017

Use the Configure AppDNA Environment wizard to configure a new AppDNA installation for a trial or production system. This includes creating a new SQL Server database.

Important: If you already have an AppDNA installation, stop AppDNA clients before running the configuration wizard. That will reset IIS, which terminates import and analysis sessions on running AppDNA clients connected to a web server that hosts the AppDNA web site and database.

By default, the wizard opens automatically when the AppDNA installation completes.

  1. If the Configure AppDNA Environment wizard is not open: From the Windows Start screen or menu choose Programs > Citrix AppDNA > Management Tools > Configure AppDNA.

  2. Select Configure new installation, click Next and on the Database creation page specify the details as follows:

    • Server name - Enter this as Machine\Instance, where Machine is the name of the machine that hosts the SQL Server installation and Instance is the SQL Server instance if a named instance is in use. If a named instance is not in use, omit the backslash (\).
    • Database name - Defaults to AppDNADB. If the database administrator has created an empty database for you to use, enter its name here. Otherwise enter a name that does not already exist within the SQL Server instance.
    • Database authentication - Enter the credentials for connecting to SQL Server when creating the database. The user account must have the sysadmin server role, regardless which authentication method you use.
      • Windows authentication - This type of authentication uses the logged on Windows user account when connecting to the database. The user account must have a password.
      • SQL Server authentication - This type of authentication uses a SQL Server user account. Selecting this option activates the User name and Password prompts. Enter the user name and password of the account.
  3. Click Next and then, in the AppDNA web site credentials step, specify the credentials that the AppDNA web site is to use when connecting to the database after it is created. The options are:

    • Use the built-in IIS application pool identity
    • Use these credentials - Specify the credentials to be used. For a production system, Citrix recommends an AppDNA-specific service account that has a password that does not expire (not the account used to create the database).

    See Web site credentials for more information.

  4. Click Next and then, in the License database step, activate your license or choose to run AppDNA in trial mode for up to 30 days:

    • Activate now - Select this option to activate an AppDNA trial or retail license. You now need to log on to http://www.citrix.com and allocate and download your license file (see http://support.citrix.com/article/CTX126167 for instructions). When you do this, you must enter the name of the machine that hosts the AppDNA license server.
      • License server machine - This shows the name of the AppDNA license server machine. This is the same machine as the AppDNA server. Click Copy to copy this to the clipboard so you can paste it into www.citrix.com.
      • License file - After you download your license file, enter its name and location here. This must be a license issued from www.citrix.com. If necessary, you can log on to www.citrix.com and download new Citrix licenses that match your existing entitlements. Important: AppDNA handles licensing differently from other Citrix products. If you have purchased multiple Citrix products, make sure you download your AppDNA licenses separately from the licenses for the other products.
    • Run in trial mode - Select this option to run AppDNA in trial mode for up to 30 days. This provides no limit to the number of applications that you can import and for which you can view the EstateView and Effort Calculator reports views. However, you can only view the results in the other report views for up to five applications.
    • Activate a XenDesktop or XenApp Platinum license - Select this option to activate AppDNA using a XenDesktop or XenApp Platinum license.
      • Platinum license server machine - Enter the host name or IP address of the machine on which the XenDesktop or XenApp License Server is installed.
      • Port - Enter the license server port. By default, this is 27000. However, sometimes a different port is used. If in doubt, contact your XenDesktop or XenApp administrator.
  5. Click Next. In the CEIP step, Yes is selected by default.

    • Yes - opts in to the Citrix Customer Experience Improvement Program (CEIP), which gathers anonymous configuration and usage data from AppDNA and automatically sends the data to Citrix.
    • No - you can join later from Edit > Settings > CEIP.
  6. Click Next and then, in the Firewall step, review the automatic exceptions to Windows Firewall. Uncheck if you do not want to add these exceptions. 

  7. Click Next to move to the System check step.

    See System Check issues if any of the checks fail.

  8. Click Configure to start the configuration of AppDNA and the creation of the database.

    This takes some time.

    The configuration wizard also performs an IIS reset. This will make any other web sites hosted by IIS on this server unavailable for a brief interval.

    After the process completes, a summary page opens.

You are now ready to start using AppDNA: From the Windows Start screen or menu, choose Programs > Citrix AppDNA > AppDNA. The default administrator account is:

  • Username: administrator
  • Password: apps3cur3

Important: Citrix recommends that you change the password the first time you log on.

The first time you log on, the Configure Modules Wizard starts.