Citrix AppDNA 1906 User manual

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

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

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

Eort Calculator 129

AppDNA 1906

Variables 136

Eort 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

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

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

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

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

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 Eort 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

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

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

Aer Snapshot Does Not Run 522

AppDNA 1906

Import Fails 523

Remote Admin Connectivity 523

Access to the Shared Folder 525

Forward Path Script 527

Glossary 528

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 soware 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.

AppDNA 1906

Learn more: Analyze applications

Report - Aer 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]

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)

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

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

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 sui-

cient.

For production deployments

• Server-class physical or virtual machine with at least 12 GB of RAM

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

Page is loading ...

Citrix AppDNA 1906 User manual

Citrix AppDNA 1906 User manual

Related papers

Other documents