Citrix AppDNA 7.11 / 7.9 / 7.8

Last Modified: Sep 17, 2016 @ 2:21 pm



Your Citrix License Server must have XenApp or XenDesktop Platinum Edition licenses. If you don’t have Platinum Edition licenses, then work with a Citrix Partner to perform AppDNA analysis.

AppDNA server should have the following:

  • 12 GB of RAM
  • 80 GB free disk space for up to 200 applications. 150 GB if more applications.
  • Cannot be installed on a Delivery Controller. Must be a separate machine.

SQL Server:

  • SQL 2008 R2, 2012, 2014, or 2016. SQL Express is not supported.
  • AppDNA generates load on SQL during install (duration = few hours) and during import and analysis.
  • See Optimize AppDNA > Optimize SQL Server at Citrix Docs.
  • Disk space could easily be 20+ GB.

AppDNA can directly import and analyze .msi installers. For non-.msi installers, you’ll need a machine to capture the install process. The machine(s) should be the same operating system as what you are migrating from. The machine can either be directly accessible through a hypervisor, which means AppDNA can automate the capture process. Or it can be any machine where a user can perform Self Provisioning.

Server Prerequisites

  1. On the AppDNA Server, open Computer Management. Edit the Administrators group, and add the service account.
  2. In Server Manager, start the Add Roles and Features Wizard.
  3. In the Server Roles page, select Web Server (IIS), and click Next.
  4. In the Select features page, select .NET Framework 3.5 (and 4.5). Click Next.
  5. In the Select role services page, select HTTP Redirection. Scroll down.
  6. Scroll down and under Health and Diagnostics, select Request Monitor.
  7. Scroll down and  under Performance, select Dynamic Content Compression.
  8. Scroll down and under Security, select Basic Authentication, IP and Domain Restrictions, URL Authorization, and Windows Authentication.
  9. Scroll down and under Application Development, select everything except CGI and WebSocket Protocol.
  10. Scroll down and check the box next to IIS 6 Management Compatibility, which includes IIS 6 Metabase Compatibility.
  11. Also select IIS Management Scripts and Tools and Management Service. Click Next.
  12. In the Confirm installation selections page, click Specify an alternate source path.
  13. Browse to the sources folder on the Windows Server 2012 R2 DVD, and click OK.
  14. Click Install.

Server Installation

  1. Run the downloaded AppDNA 7.11 (Citrix-AppDNA.msi).
  2. In the Welcome to the Installation Wizard for Citrix AppDNA 7.11 page, click Next.
  3. In the License agreement page, select I accept the terms, and click Next.
  4. In the Citrix AppDNA Installation Type page, select Complete, and click Next.
  5. In the Citrix AppDNA installation locations page, click Next.
  6. In the Ready to install Citrix AppDNA page, click Install.
  7. In the Installation Wizard Completed page, click Finish.

SQL Database

Instructions from CTP Eric Haavarstein Configure Citrix AppDNA 7.11 in Minutes instead of Hours:

  1. If this is a new installation, on the AppDNA server, go to C:\Program Files (x86)\Citrix\AppDNA\Server\Bin, and extract the AppDNA.bz2 file.
  2. Rename the extracted file with a .bak extension.
  3. Copy the file to the SQL server.
  4. In SQL Studio, right-click Databases, and click Restore Database.
  5. Change the Source to Device, and click the ellipsis.
  6. Click Add.
  7. Select the AppDNA.bak file, and click OK twice.
  8. Change the destination database name as desired, and click OK to begin the restore.

  9. Add a service account to SQL logins.
  10. On the Server Roles page, add the service account to the bulkadmin role.
  11. Give the service account db_owner permission to the AppDNA database.

Configuration Wizard

  1. The Configuration wizard launches. Or you can launch Configure AppDNA from the Start Menu.
  2. If you see a Prerequisites page, click Enable.
  3. In the Configure AppDNA page, if you are upgrading, select the Upgrade installation option and click Next. The remaining wizard screens will be similar but different.
  4. Or leave it set to Configure new installation and click Next.
  5. In the Create database page, enter the SQL server name, enter the database name, and click Next.
  6. In the Connect to database page, enter the credentials of your service account and click Next.
  7. In the License database page, enter the address of a Citrix License server that has XenApp/XenDesktop Platinum Licenses and click Next.
  8. In the CEIP page, make a selection and click Next.
  9. In the Firewall page, click Next.
  10. In the System check page, click Configure or Upgrade.

  11. It will take several minutes to update the database.
  12. Click Close when done.
  13. See Optimize AppDNA > Optimize IIS at Citrix Docs.

Note: Database and License Configuration can also be run from the command line: “C:\Program Files (x86)\Citrix\AppDNA\Server\Bin\AppDNAConfig.exe”

 Launch and Login

  1. Launch AppDNA from the Start Menu.
  2. Login as administrator and apps3cur3.

Welcome Wizard

  1. In the Welcome page, click Next.
  2. This wizard lets you select which modules to enable. The more modules you enable, the longer it takes to analyze an application. Go through each page and make your selections.
  3. The primary new feature in AppDNA 7.11 is analysis of Windows Server 2016.  💡

  4. Then click Configure.
  5. And click Close.
  6. AppDNA 7.9 adds a new Compliance Manager module.
  7. You can use the Module Manager (Configure > Modules > Management) to see what each module is checking for.
  8. Click Groups next to one of the modules.
  9. Notice that not every analysis rule is enabled.


  1. Open the Administration menu, expand User Management, and click Users.
  2. In the toolbar, click Add from AD.
  3. Select your Citrix Admins group and click OK.
  4. On the right, notice that Administrators role is selected by default.
  5. Open the File menu and click Exit.
  6. Launch AppDNA again.
  7. On the login page, click Options.
  8. You can check the box next to Integrated Login and click Log On.
  9. Go back to Administration > User Management > Users.
  10. Edit the administrator account.
  11. And change its password.
  12. Then click Save.

Direct Import

  1. Switch to the Import workspace.
  2. On the left, under Import, click Applications.
  3. On the right, switch to the Direct Import tab.
  4. Click Browse in the toolbar. Then browse to an .MSI file.
  5. The .msi files are shown in the list. Use the checkboxes on the left to select the applications.
  6. Then on the top right click the Import & queue for analysis button to begin analysis.
  7. A progress bar is displayed next to the application.
  8. If needed, you can cancel a task in the Server Queue.
  9. Analysis begins immediately. You can change the analysis modules by going to Configure > Modules > Wizard.
  10. After analysis is complete, select a report you want to view and click Finish on the top right.

  11. You can also view reports for applications that have already completely analysis by switching to the Reports: Applications workspace.
  12. On the left, select a report you want to view.
  13. You might be prompted to select applications. If you want to change this selection later, there’s a Change Selection button on the toolbar.

  14. The report displays a list of applications with color coding. Click an application name to view more details.

Install Capture

Install Capture lets you import application installers that are not available as MSI files. AppDNA uses a hypervisor connection to automate the Install Capture process. Alternatively, you can do a manual capture using the Self Provisioning process.

Prepare Install Capture Machine

  1. Create a share on the AppDNA machine. The captured data is stored in this share.

  2. The operating system of the Install Capture machine should match the operating system version you are migrating from.
  3. On the Install Capture machine, make sure Remote Desktop is enabled.
  4. On the Install Capture machine, browse to the AppDNA server in the \\AppDNAServer\C$\Program Files (x86)\Citrix\AppDNA\Tools folder and run Citrix AppDNA VM Configuration.msi.
  5. In the Welcome to the Installation Wizard for Citrix AppDNA VM Configuration page, click Next.
  6. In the License Agreement page, select I accept the terms and click Next.
  7. In the Ready to Install the Program page, click Install.
  8. In the Installation Wizard Completed page, click Finish.
  9. Click Yes when prompted to reboot.
  10. You can either take a snapshot now or AppDNA will do it for you.

Configure AppDNA for Install Capture

  1. In the AppDNA Console, open the Edit menu and click Settings.
  2. On the left, switch to the Install Capture page.
  3. On the right, click New.
  4. In the Virtual Machine Configuration Wizard page, click Next.
  5. In the Virtual machine details page, give the configuration a name.
  6. Select vSphere and click Next.
  7. In the vSphere Host Details page, in the Single Sign-on Server field, enter the Platform Services Controller hostname
  8. In the Port field, enter 7443.
  9. In the vCenter Server field, enter the hostname of the vCenter server.
  10. Enter credentials that can snapshot and perform power operations on the Install Capture machine. Click Test and then click Next.
  11. In the vSphere Virtual Machine page, in the list of machines, select the Install Capture machine and click Next.
  12. In the vSphere Snapshot selection page, if there are no snapshots, click Take Snapshot.

  13. Click Test. At least confirm that the machine can be reverted to snapshot. Don’t worry if the console doesn’t open. Click Next.
  14. In the Virtual machine connection page, enter the hostname of the Install Capture machine and click Test. Note: the RemoteAdmin.exe process only runs while somebody is logged into the machine. Click Next.

  15. In the Capture output location page, enter the UNC path to the file share on the AppDNA server and click Test. Then click Next.
  16. In the Virtual machine state page, make a selection and click Next.
  17. In the Virtual machine configuration summary page, click Finish.
  18. Click Save to close the Settings window.

Perform Install Capture

  1. Switch to the Import workspace.
  2. On the left, under Import, click Applications.
  3. On the right, switch to the Install Capture tab. Click Browse and find an installer you want to import using Install Capture.
  4. If you have more than one Install Capture machine, use the drop-down to select the one you want to use.
  5. Select the apps. Then on the top right click Import & queue for analysis.

  6. The virtual machine configuration check window is displayed.
  7. The Install Capture VM will be started.
  8. Eventually you’ll be prompted to RDP to the Install Capture machine.
  9. The capture process begins with a snapshot of the Install Capture machine.
  10. Then the application is installed. This should happen automatically.
  11. Then a differencing snapshot is taken and uploaded to AppDNA Server.
  12. Once the Capture process is complete, Analysis begins immediately.
  13. You will eventually be asked to view a report.

Self Provisioning

Self Provisioning is very similar to Install Capture except there’s no need for direct connectivity between AppDNA server and the hypervisor that hosts the Self Provisioning machine. Once the process is started in the AppDNA console, a different user can complete the snapshot process on the Self Provisioning machine.

Prepare Self Provisioning Machine

  1. Make sure AppDNA VM Configuration is installed first.
  2. On the Self Provisioning machine, browse to the AppDNA server in the C$\Program Files (x86)\Citrix\AppDNA\Tools folder and run Citrix AppDNA Self Provisioning Client.msi.

  3. In the Welcome to the Installation Wizard for Citrix AppDNA Self Provisioning Client page, click Next.
  4. If you see the Pre-Requisites Check page, stop the installer, install the AppDNA VM Configuration Client and then restart this installer.
  5. In the License Agreement page, select I accept the terms, and click Next.
  6. In the Destination Folder page, click Next.
  7. In the Ready to Install the Program page, click Install.
  8. In the Installation Wizard Completed page, click Finish.
  9. Take a snapshot of the Self Provisioning machine.

Perform Self Provisioning Capture

  1. In the AppDNA Console, switch to the Import workspace.
  2. On the left, click Applications.
  3. On the right switch to the Self Provisioning tab.
  4. Then click the Configuration icon in the toolbar.
  5. In the Self Provisioning page, enter the UNC path to a share that both machines (AppDNA server and Self Provisioning machine) can access.
  6. In the toolbar click Browse and browse to the application installer.
  7. Click Publish to push the files to the file share.

  8. Click in the PublishedFile column to access the full path and copy it to the clipboard.
  9. On the Self Provisioning machine, run the Self Provisioning Client from the Start Menu.
  10. Paste in the path and click Start.
  11. After the snapshot is taken, click the Start button and install the application.
  12. Once the install is complete, another snapshot will be taken and the results will be uploaded to the share. Click Close.
  13. Back in the AppDNA console, click Refresh Status and make sure the status changes to Complete.
  14. Make sure the application is selected and then on the right side of the toolbar click Move to Import.
  15. This moves the application to the Direct Import tab where you can select the application and click Import & queue for analysis button to begin analysis.


CitrixTV XenApp Upgrades with AppDNA demonstrates the Solutions feature of AppDNA 7.6 including: XenApp upgrades, operating system image upgrades, and application interoperability.

Other links on Solutions:

Here are generic instructions for adding a Solution:

  1. For some of the solutions it is helpful to import operating system images of the machines you are moving from and the machines you are moving to..
  2. In the Import workspace, on the left click Operating Systems.
  3. On the right, click Download Snapshot Manager. Run this on a operating system image that you want to import.
  4. Then click Import from MSI to import the MSI file generated by the Snapshot Manager.
  5. Switch to the Solutions workspace.
  6. On the top left click Add solution.
  7. In the Solutions Templates page, select a solution and click Next.
  8. In the Solution name page, give the solution a name and click Next.
  9. In the Platform name page, choose the platform you are migrating from and click Next.
  10. In the Applications page, select the applications you want to analyze and click Next.
  11. In the Solution platforms page you can change the Target platforms or add more platforms.
  12. Click Build.

Email this to someonePrint this pageTweet about this on TwitterShare on LinkedInShare on FacebookPin on PinterestShare on RedditShare on StumbleUpon

50 thoughts on “Citrix AppDNA 7.11 / 7.9 / 7.8”

  1. Hello, when you import a new SO, APPDNA shows the aplcations??? or only the operative system??,, anyway how could i capture the applications that are installed in my servers? any aidea, or i have to import one by one in the section of “IMPORT”?

    1. You can import MSI installers. Or you can perform a packaged install and import that. However, you can’t import already installed applications.

  2. Hi Carl. AppDNA 7.9 supports SQL Express. Perhaps you could update the site?
    Not sure if I would use SQL Express for a PROD deployment. Keep up the great work.

  3. Hi Carl, hope you are well, Is it prudent in terms of functionality in the installation of App-DNA 7.8 to have 2 servers separate (App-DNA on W2012 R2, SQL 2014 R2 SP1 on W2012 R2) or both on one server W2012 R2?

    1. Depends on the size of app portfolio.

      Since SQL requires a license, I typically use an existing SQL server.

  4. Hi Carl, I am about to embark on my first AppDNA project, will your very detailed write up above assist to a T? Also will you recommend installing the sql server within the appDNA or seperate. I have 400 apps to investigate

    1. This should include everything you need to install AppDNA. How to actually use it is detailed elsewhere. Jani Anttila frequently helps people on Citrix Discussions. Also see

      For that many apps, you definitely want separate SQL.

      1. Thanks Carl, btw have you deployed AppDNA Express or the full version, built on the Microsoft Azure platform from the Citrix Workspace Cloud Labs. It would be interesting to assess its functionality.


          1. That looks like the on-premises version, which is what’s detailed in this post. I’m not aware of a full version from Citrix Workspace Cloud.

          2. Hi Carl, you were right that the appDNA express is somewhat limited when using in the Citrix Workplace Cloud, but can the full version i.e. AppDNA 7.8 work under the Azure Microsoft Cloud. And if so will the on premises Platinum License cover the hosting process

          3. Hi Carl, will the on-premises version of AppDNA 7.8 work within a Azure Microsoft hosted environment and if yes, will the existing Platinum license cover the hosting costs?

          4. If you deploy VMs in the traditional manner then I suspect it will work. Citrix licenses don’t cover Azure hosting costs.

            Automated Install Capture probably won’t work but you can always do it manually.

          5. Hi Carl, can I use your epic App-DNA run-through in installation on the Azure VMs or will it need a different approach? or what can you anticipate as blockers in this Azure based installation?

          6. As long as you regular VMs and regular SQL then it should work fine. Install Capture is my only concern.

          7. Hi Carl, I have installed AppDNA SQL Server succesfully, but when I try to install App-DNA on a separate server, I get errors when I get to the Configuration Wizard, “Access to path c:\users……….” is denied. any assistance will help

          8. That’s new to me. Are you running the Config wizard as administrator? Is there a specific file name it’s trying to access?

          9. Hi Carl, In reference to your Install Capture write up, can one use a Microsoft Option as opposed to Vmware VSphere. If Yes, Also did you go for Vmware for any functional reason?

      2. Hello Carl, For the Install Capture Server, I have requested Server 2003 (as this is the platform that the applications are being migrated from), what other pre-reqs should I be looking for in the IC server?

  5. Hi Carl,
    Thank you for the very detailed doc. Just one question though: I can not add AD groups on User Management .. I don’t see the Groups objects for AD.. I can add any user but. I have seen in the docs that the service AppDNA should run with a domain user which is my case .. a service account .. but still no luck. Any ideas?
    Thank you,

    1. Is your AppDNA IIS Application Pool running as a domain account?

      I just tried adding a group and it works for me.

      1. Yes it is running with the same domain service account the Citrix AppDNA service is running. I know for you it is working .. I have seen the screenshot you posted .. the Select Users or Groups window.. I have only select sers. Does the AppDNA License server need to run also as a domain account?

        1. Are you seeing the normal Windows user/group selection dialog box? Does it say “Users and Groups”? Maybe there are some traces you can run on Windows to see the problem. Procmon, wireshark, etc.

    2. Hi Carl, tried to analyse a straight forward application but its coming up with an error “Column’ unique_identifier’ does not belong to the underlying table ‘attribute’
      There a lot more under view stack track, is there a way that I can upload the screen shot to you?

      1. Are you able to post at That way more than just me is reading it and able to respond.

          1. Yes, needs to be separate because a snapshot is taken, the install is performed, and the snapshot is rolled back.

  6. Thanks for the guide but I’ve got a bug when I try to do a URL Import on our corporate site with 7.8 on a fully patched Windows 2012R2 vm. Enter the internal URL as a new Import line item. Click Import. The “App-DNA Directed Spider” box flashes up, the last line in the Activity Log tab says “Waiting for response from Internet Explorer” then the window closes and the Import does nothing. It closes so fast I had to hit printscreen just to review what the window contents were before it closed. I’ve tried a couple of other internal websites (Director 7.8 for one) and the same thing happens – the Spider pops open and closes almost instantly.

  7. hi Carl!

    do you have any idea wether sql-mirror is supported? we use sql2012 as seen below for mirroring.

    Microsoft SQL Server Management Studio 11.0.6020.0
    Microsoft Analysis Services Client Tools 11.0.6020.0
    Microsoft Data Access Components (MDAC) 6.3.9600.17415
    Microsoft MSXML 3.0 6.0
    Microsoft Internet Explorer 9.11.9600.18231
    Microsoft .NET Framework 4.0.30319.42000
    Operating System 6.3.9600

    thx tom

  8. Hi Carl, we have over 1500 applications, do you recommend installing the sql on the appdna server or db cluster? how much storage space will require if db in cluster?

  9. Hi Carl, Where to configure the account in step 2 “Login as administrator and apps3cur3.”. I try to logon, always error username or password…

  10. MInor point of clarification: you have got SQL Express is not supported. On the Citrix product documentation it has got •SQL Server 2012 Express Edition (built-in 10GB database size limit). I was wondering if 7.6.5 no longer supports Express Edition, but 7.6 does.

    1. It’s OK for small PoCs or small number of app analysis. But Platinum customers will want a production implementation of AppDNA and thus should avoid SQL Express.

  11. Epic walk-through, but has anyone used this software during a project… seems like lots of effort (cost) for what?, Package, UAT, fix if needed, vs AppDNA, package, UAT, fix if needed.

    1. Hey Steve,
      Say I use AppDNA for my project and you don’t: you’ll be spending a huge amount of time testing application that are very likely to work while I’ll only be focusing on critical/applications assessed red by AppDNA. Not to mention that static analysis (per binary PE dump) is way safer than manual smoke testing.

Leave a Reply