Page is loading ...
AppDNA 1906
Citrix Product Documentation | docs.citrix.com May 26, 2020
AppDNA 1906
Contents
AppDNA 1906 3
What’s new 4
Fixed issues 4
Known issues 5
Deprecation 6
System requirements 8
Requirements for optional features 12
Get started 15
Quick start guide 16
Import, analyze, and report 17
Add custom information to applications 19
Prepare for a XenApp or XenDesktop 7.x upgrade 22
Prepare for a move to XenApp or XenDesktop 7.x 26
Install 28
Plan 29
Prepare to install 31
Install AppDNA 33
Configure a client installation 35
Configure a server installation 35
Optimize AppDNA 37
Test performance 42
Install using the command line 43
Upgrade 44
© 1999-2020 Citrix Systems, Inc. All rights reserved. 2
AppDNA 1906
Upgrade a database 47
Upgrade AppDNA tools 48
Import 49
Direct Import 51
Install Capture 54
Options 55
Auto-Clicker 58
Self-Provisioning 62
Administer 65
Self-Provisioning toolbar 67
Self-Provisioning client 68
Install the Self-Provisioning client 69
Monitor Self-Provisioning 71
Capture an application 71
Web applications 72
Web Capture Import 74
Processing 75
Web Direct Import 77
Import web applications 78
Web import settings 79
Stand-alone Tools 81
Install 82
Spider 83
Capture Web Application 86
© 1999-2020 Citrix Systems, Inc. All rights reserved. 3
AppDNA 1906
MSI Converter 87
Generate MSI 89
Limitations 90
Import Applications Toolbar 92
Import from List 93
Search for applications 95
Settings 96
File settings 96
Import and analyze settings 97
Install Capture settings 99
Self-Provisioning settings 101
CEIP 103
Analyze 105
Which Reports? 106
Standard AppDNA reports 107
Licensing options 112
Operating systems 113
Application dependencies 116
Queue processor 117
Report views 118
Features 121
Understanding RAG Icons 123
Application reports 127
Eort Calculator 129
© 1999-2020 Citrix Systems, Inc. All rights reserved. 4
AppDNA 1906
Variables 136
Eort Calculator Worksheets 139
Forward Path 142
Run Forward Path tasks 143
Virtualization solution 144
Organization reports 145
Export 148
Reporting settings 148
Report and license summary 150
Resolve 151
Remediate web applications 155
Digital signatures 157
Manage 159
Application list 160
Filter applications 162
Application attributes 163
Application attributes forms 167
Add applications 171
Profile applications 174
Groups 183
Journals 185
Search and Browse 187
Prepare to import 188
Discover Applications 188
© 1999-2020 Citrix Systems, Inc. All rights reserved. 5
AppDNA 1906
Rationalize applications 189
Filter discovered applications 191
Link discovered and managed applications 192
Import discovered applications 193
Discovery settings 195
Columns 196
Discovered application details 197
Matching algorithm 198
Integrate data from Active Directory and Configuration Manager 198
Key Terms 203
Load Data 206
Load Active Directory and Configuration Manager data indirectly 208
Load Configuration Manager data 209
Load Active Directory data 211
Reference 213
Load AD and ConfigMgr Data Wizard 213
ConfigMgr Advanced Selection 217
AD and ConfigMgr Data Extraction Tool 219
Extract Data from Active Directory 220
Extract Data from ConfigMgr 222
Active Directory settings 224
Configuration Manager settings 225
Import managed applications 225
Importing Managed Applications 226
© 1999-2020 Citrix Systems, Inc. All rights reserved. 6
AppDNA 1906
Link managed applications 227
Auto-match managed applications with imported applications 228
Manually match managed applications with imported applications 230
Create groups from Active Directory and Configuration Manager collections 231
Create Groups 233
Organization data in the Users and Computers screen 234
Configure 235
Solutions 236
AppDisks 237
App-V sequencing 238
Assess builds 245
Analyze for interoperability 247
Patch impact analysis 248
Prepare for a XenApp or XenDesktop 7.x upgrade 253
Prepare for a move to XenApp or XenDesktop 7.x 256
Install Capture 259
Set up a virtual machine 260
Hyper-V 263
Configure a Hyper-V VM 269
vSphere 271
Configure a vSphere VM 275
XenServer 277
Remove the Virtual Machine from the Domain 281
Configure a XenServer VM 281
© 1999-2020 Citrix Systems, Inc. All rights reserved. 7
AppDNA 1906
VMware Workstation 283
Configure a VMware Workstation VM 286
Execution profiles 287
App-V 5.1 Sequencer execution profile 288
Run an execution profile 293
Edit an execution profile 295
Install Capture configuration reference 298
VM Configuration Wizard 299
Virtual Machine Configuration Details 300
VMware Workstation Virtual Machine 300
VMware Workstation VM Snapshot 301
Hyper-V Host Details 301
Hyper-V Virtual Machine 302
Hyper-V Snapshot Selection 303
vSphere Host Details 304
vSphere Virtual Machine 305
vSphere Snapshot Selection 305
XenServer Host Details 306
Snapshot Selection 307
XenServer Virtual Machine 308
Virtual Machine Connection 308
Capture Output Location 309
VMware Workstation Virtual Machine State 310
Virtual Machine State (Hyper-V) 311
© 1999-2020 Citrix Systems, Inc. All rights reserved. 8
AppDNA 1906
Virtual Machine State (vSphere) 312
Virtual Machine State (XenServer) 313
Virtual Machine Configuration Summary 314
VM Configuration Dialog Box 314
Changing the Remote Admin Port 320
Operating system images 322
Create an MSI for your OS image 323
Import an OS image 323
Configure OS image relationships 326
Delete an OS image 327
OS image settings 327
Modules, reports, and algorithms 328
Configure modules wizard 329
Configure algorithm groups 333
Configure algorithms 336
Add a remediation action 338
Export and import algorithms 340
Export customizations 340
Standard remediation actions 341
Configure algorithms for Windows desktop reports 363
Custom reports 365
Overview 368
Create custom reports 370
Import and export custom reports 373
© 1999-2020 Citrix Systems, Inc. All rights reserved. 9
AppDNA 1906
Create or edit the SQL query for an algorithm 374
Forward Path 376
Create and edit Forward Path scripts 378
Forward Path specifications 380
Forward Path example 383
Create links to remediation report views 388
Use Eort Calculator variables in a Forward Path scenario 391
Grouped Forward Path reports 402
Sort and format Forward Path reports 413
External data 416
Configure External Data Source 419
Convert to Journal Entry 420
Licenses 420
Inspect 421
Activate 423
Apply 424
Transfer 425
Administer 428
Users 428
Integrated Login 428
Add User 431
Import users from Active Directory 432
Login settings 432
Roles 433
© 1999-2020 Citrix Systems, Inc. All rights reserved. 10
AppDNA 1906
Task locks 433
Sites 434
Add a site 435
Edit and Delete 436
Import and Export 437
Databases 438
Create an AppDNA database 438
Add an existing AppDNA database 440
Web site 441
Change Web site Credentials 442
Web site credentials 443
Change Port 444
Upgrade from PWS to IIS 445
Fingerprints 446
Configure AppDNA Environment wizard 446
Configure Client 447
Web Server 448
Web Site Configuration 448
Choose Database 449
Database Creation 450
License Database 450
Add Existing Database 451
Existing Configuration 452
Edit Configuration 453
© 1999-2020 Citrix Systems, Inc. All rights reserved. 11
AppDNA 1906
License Management 454
Transfer License 455
Export Transfer Token 456
Export License 457
Import Transfer Token to Unlock Database 457
Reallocate License File 457
Import License 458
Advanced Licensing 459
Configuration progress 459
Migrate 460
Migrate Windows desktop and server applications 460
Migrate to XenDesktop 7.0 468
Migrate Windows applications to App-V 5.0 480
Migrate applications without install routines 492
SDK 505
Troubleshoot 505
System Check issues 512
Active Directory and Configuration Manager issues 514
Install Capture issues 515
Virtual Machine Configuration Check 516
Virtual Machine Does Not Start 517
Before Snapshot Does Not Run 520
Installation Fails 521
Aer Snapshot Does Not Run 522
© 1999-2020 Citrix Systems, Inc. All rights reserved. 12
AppDNA 1906
AppDNA 1906
June 17, 2019
AppDNA is the application migration component of Citrix Virtual Apps and Desktops Premium edition
(formerly XenApp and XenDesktop Platinum edition). AppDNA enables enterprises to discover, au-
tomate, model, and manage applications for application migration, virtualization, and streamlined
application management.
For example, AppDNA helps accelerate application migrations to Windows 10 and Windows Server
2016 by predicting potential issues and showing a clear path to application compatibility on the new
operating system.
You can download and install AppDNA from https://www.citrix.com/downloads/appdna/.
For enhancements and new features in this release, see What’s New.
Import, analyze, and report
AppDNA performs automated analysis of the compatibility of applications with a variety of platforms.
Each supported platform is represented by a separate report that contains a set of algorithms that
validate the suitability and performance of applications in a specific target environment.
Import - Applications are the raw material for AppDNA - so before you begin, you need to import
them. When you do this, AppDNA interrogates each application’s files, registry entries, and API us-
age to expose the application’s “DNA”. AppDNA then loads this into a SQL Server database. You can
import desktop and Web applications of any type - whether internally developed or supplied by an
independent soware vendor (ISV).
Learn more: Import applications
Analyze - When you start the analysis process, you select the reports that correspond to the platforms
against which you want to test yourapplications. AppDNA combines all of the information it has about
the application portfolio and runs the report algorithms against the application DNA and produces
and stores the reporting data.
© 1999-2020 Citrix Systems, Inc. All rights reserved. 14
AppDNA 1906
Learn more: Analyze applications
Report - Aer the import and analysis processes have completed, you can view the reporting results.
AppDNA presents the results of the analysis in a set of report views that provide the information that
you need to plan, fix, and test your application portfolio.
Learn more: Report views
What’s new
May 5, 2020
AppDNA 1906
AppDNA 1906 does not include any new features. For information about bug fixes, see Fixed issues.
IIS configuration for AD Integrated Login
Changes are required to the way IIS is configured if you are using AD Integrated login. For more infor-
mation, see Integrated Login.
New product and component version numbers
In this release, the AppDNA version number is displayed in the user interface and documentation in
the same numeric format as Citrix Virtual App and Desktops (1906). The file version continues to use
the 7.x format (7.21). For a full description of this format, see New product names and version numbers.
Fixed issues
June 17, 2019
• 10 GB file on OS image causes incomplete OS snapshot. [APPDNA-1770]
• Exception when importing App-V files using AppDNA 7.16 client. [APPDNA-1789]
• Algorithm OSV_001 does not correctly check the service pack level on some OS Snapshots.
[APPDNA-1794]
• Quoted paths for install capture are not handled correctly. [APPDNA-1795]
© 1999-2020 Citrix Systems, Inc. All rights reserved. 15
AppDNA 1906
• Some internal errors cause User group info collection to be incomplete. [APPDNA-1796]
Known issues
June 17, 2019
The following warning applies to any workaround that suggests changing a registry entry.
Warning:
Editing the registry incorrectly can cause serious problems that may require you to reinstall your
operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Reg-
istry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry
before you edit it.
• When the IIS Web server is set up to require Windows Authentication, clicking the Download
button for the OS Snapshot Manager results in an “Unauthorised” message.
To workaround this issue, either 1) manually copy the MSI from the AppDNA Webserver
(C:\Program Files\Citrix\AppDNA\Server\Download\snapshotmanager.exe), or 2) temporar-
ily allow Anonymous Authentication in the Internet Information Services (IIS) Manager.
[AppDNA-1797]
• AppDNA reports assess the suitability of XenApp and XenDesktop, and Citrix Virtual Apps and
Desktops, as deployment mechanisms for your applications. However, reporting modules, so-
lutions and algorithm remediation texts refer only to XenApp and XenDesktop. Similarly, vari-
ous references throughout the user interface and product documentation do not refer to Citrix
Virtual Apps and Desktops.
• During App-V solution configuration, when using the Fix option to fix the VM, the installation gets
stuck at installing App-V Sequencer step for Windows 10 build 1703 with the configured built-in
sequencer. To work around this issue, cancel the “Go to Microso website” action and warning.
The VM configuration can then finish successfully. [APPDNA-1685]
• The AppDNA web server processes depend on .NET 4.5.1 as a minimum version. If the web server
has .NET 4.6 or later installed, the AppDNA IIS process can stop working unexpectedly. This issue
produces unhandled exceptions and failed import or analysis tasks. Error messages are likely to
contain a statement that refers to w3wp.exe. For example, “DotNet Framework exception Error
w3wp.exe [4520]”.
To resolve the issue, install the Microso update for your server environment:
https://support.microsoft.com/en-us/kb/3088955 (Windows Server 2012 and Windows 8)
https://support.microsoft.com/en-us/kb/3088956 (Windows Server 2012 R2 and Windows 8.1)
© 1999-2020 Citrix Systems, Inc. All rights reserved. 16
AppDNA 1906
https://support.microsoft.com/en-us/kb/3088957 (older Windows versions) [# APPDNA- 1475]
• The App-V Solution cannot use Windows 10 AU (Version 1607 and 1703) or Windows Server 2016
platforms to create App-V packages. [APPDNA-1636]
• The error message, “DirectedSpider.exe is not a valid Win32 application”, is displayed when
launching the Directed Spider on Windows XP SP3.
To work around the issue, use an older version of AppDNA (AppDNA 7.9 or earlier). [APPDNA-
1371]
• When the client side parts of the import process take an unusually long time to complete, can-
celation requests may not be responded to in a timely manner.
To work around this issue, close AppDNA. This will stop the import. [AppDNA-432]
Deprecation
June 17, 2019
The announcements in this article are intended to give you advanced notice of platforms, Citrix prod-
ucts, and features which are being phased out so that you can make timely business decisions. Citrix
monitors customer use and feedback to determine when they are withdrawn. This list is subject to
change in subsequent releases and might not include every deprecated feature or functionality.
The following platforms, Citrix products, and features are deprecated. This does not mean that they
are removed immediately. Deprecated items will be removed in a Current Release following the next
Long Term Service Release (LTSR). Alternatives for deprecated items are suggested where possible.
For details about product lifecycle support, see the Product Lifecycle Support Policy article.
Item Announced in Removed in
Support for AppDNA server
and client on: Microso
Windows Server 2012;
Microso Windows Server
2008 R2 SP1; Microso
Windows 10 RTM; Microso
Windows 10 1511; Microso
Windows 8.1; Microso
Windows 7 SP1
7.16 7.18
© 1999-2020 Citrix Systems, Inc. All rights reserved. 17
AppDNA 1906
Item Announced in Removed in
Support for Install Capture
platforms and Install Capture
supported hypervisors:
Microso Hyper-V Server
2012; Microso Hyper-V
Server 2008 R2; Microso
Windows 8.1 Hyper-V
Client;Microso Windows 8
Hyper-V Client; Microso
Windows 10 RTM; Microso
Windows 10 1511; Microso
Windows 8.1; Microso
Windows 8; Microso
Windows 7 SP1; VMware
Workstation (all versions);
supported on Install Capture
platform only
7.16 7.18
Microso SQL Server 2008 R3
(all SPs)
7.16 7.18
AD Data Collector tool
support on: Microso
Windows Server 2012;
Microso Windows Server
2008 R2 SP1; Microso
Windows 10 RTM; Microso
Windows 10 1511; Microso
Windows 8.1; Microso
Windows 7 SP1
7.16 7.18
AppDNA VM tools support on:
Microso Windows 8.1
7.16 7.18
AppDisks support 7.15
AppDNA standalone licensing 7.14 7.16
Upgrades from 7.6.2990.2378
and 7.5.26.239473
7.14 7.16
App-V 4.6 support and
analysis
7.14 7.16
© 1999-2020 Citrix Systems, Inc. All rights reserved. 18
AppDNA 1906
Item Announced in Removed in
AD Data Collector tool
support for SCCM 2003 or
SCCM 2007
7.14 7.16
Support on Microso
Windows Vista or Microso
Windows 8.0 for: AppDNA VM
tools; Directed Spider tool; AD
Data Collector tool
7.14 7.14
System requirements
June 17, 2019
This article lists the supported systems and prerequisites for the AppDNA server and client. Read the
Prepare to install article before installing AppDNA.
Quick links to topic sections:
•Hardware requirements
•Supported operating systems
•AppDNA server requirements
•AppDNA client requirements
•Citrix License Server requirement
•Report requirements
•Requirements for optional features
Hardware requirements
For a complete installation (server and client)
For small proof-of-concept deployments: A Windows laptop with at least 4 GB of RAM is usually sui-
cient.
For production deployments
• Server-class physical or virtual machine with at least 12 GB of RAM
© 1999-2020 Citrix Systems, Inc. All rights reserved. 19
AppDNA 1906
Additional memory might be required for the Interoperability solution if you choose to analyze a large
number of applications. The amount of additional memory is dependent on the number of applica-
tions and size of the application DNA. In testing, a portfolio of 2,500 applications required 12GB RAM
for optimum performance during interoperability analysis.
• To support up to 200 applications:
–Dual core 2Ghz processor
–One hard drive with at least 80GB free disk space
• To support over 200 applications:
–2 x dual core 2Ghz processor
–150GB+ free disk space
–The database (.mdf file) should be installed on a separate high performance (10K/15K)
physical hard disk from the operating system and when possible the database log file (.ldf)
should be moved to a separate physical hard disk.
For a client only installation
• Pentium 4 or better processor
• At least 2GB memory with 1GB free memory (running under typical conditions)
–If using VMware Workstation for Install Capture: At least 3GB memory with 2GB free mem-
ory
• At least 5GB free disk space
–For Install Capture: Up to at least 80GB free on one hard drive
Screen resolution
A screen resolution of 1024 x 768 or higher is recommended. At a screen resolution lower than 1024 x
768, you may not be able to see some controls (for example, Import Applications > Import).
Supported operating systems
The AppDNA server and client are supported on the following OS platforms (64-bit only):
• Microso Windows Server 2016
• Microso Windows Server 2012 R2
The AppDNA client is supported on the following desktop platforms (64-bit only):
• Microso Windows 10
© 1999-2020 Citrix Systems, Inc. All rights reserved. 20
/
