appdna installation guide

AppDNA 6.1

Installation Guide

© 2012 Citrix Systems, Inc. All rights reserved. Terms of Use | Trademarks | Privacy Statement

http://www.citrix.com/site/aboutCitrix/legal/secondLevel.asp?level2ID=2209

http://www.citrix.com/English/aboutCitrix/legal/secondLevel.asp?level2ID=2210

http://citrix.com/English/aboutCitrix/legal/secondLevel.asp?level2ID=2208

2

Contents

AppDNA Installation Guide........................................................................................................... 4

AppDNA Platform Requirements .................................................................................................. 5

Supported Operating Systems ............................................................................................................ 5

Pre-Requisites ..................................................................................................................................... 6

Additional Requirements .................................................................................................................... 7

Installing to a Virtual Machine ............................................................................................................ 8

Installing IIS and ASP.NET.................................................................................................................... 8

Installing AppDNA ...................................................................................................................... 11

Install AppDNA .................................................................................................................................. 12

Configure a Complete Installation .............................................................................................. 16

Configure a Client Installation .................................................................................................... 23

Upgrading AppDNA .................................................................................................................... 25

Check list ........................................................................................................................................... 25

Changed requirements ................................................................................................................. 26

Upgrading a single-machine or server installation ........................................................................... 26

Upgrading a client installation .......................................................................................................... 26

Upgrade a database .......................................................................................................................... 26

Upgrading the AppDNA Tools ........................................................................................................... 28

Install Capture ............................................................................................................................... 28

Self Provisioning ............................................................................................................................ 28

Web Application Capture .............................................................................................................. 28

Logging into AppDNA for the First Time ...................................................................................... 29

Appendix ................................................................................................................................... 30

Setting the location of the database files ......................................................................................... 30

Additional configuration for Windows Server 2003 ......................................................................... 31

Add the user to the IIS_WPG group .............................................................................................. 31

Restart the AppDNAAppPool in IIS Manager ................................................................................ 31

Contents

3

Installing AppDNA from a Command Prompt ................................................................................... 32

Syntax ................................................................................................................................................ 32

Examples ........................................................................................................................................... 32

Getting More Help ..................................................................................................................... 33

4

AppDNA Installation Guide

This guide is designed to be used in conjunction with the AppDNA Setup and Optimization Best

Practice Guide, which discusses the various configuration options and provides hardware

recommendations.

This guide covers the following:

Citrix® AppDNA™ platform requirements

Installing IIS and ASP.NET

Step-by-step instructions for installing AppDNA

Step-by-step instructions for upgrading AppDNA

Configuring new and upgraded installations

Note: Using the Configure AppDNA Environment wizard for other tasks (such as to create a new

database, transfer a license, and reconfigure an AppDNA Web site) is covered in the AppDNA

Administration Guide.

5

AppDNA Platform Requirements

This section provides information about the operating systems that AppDNA is supported on, as well

as the essential pre-requisites. For more detailed recommendations, see the AppDNA Setup and

Optimization Best Practice Guide.

Supported Operating Systems

AppDNA is a client-server application. The AppDNA server is supported on the following OS

platforms:

Microsoft Windows 7 SP1 (32-bit and 64-bit editions)

Microsoft Windows Server 2003 SP2 (32-bit and 64-bit editions)

Microsoft Windows Server 2008 SP2 (32-bit and 64-bit editions)

Microsoft Windows Server 2008 R2 SP1

Note: Citrix recommends installing the AppDNA server component on Microsoft Windows Server

2008 R2 SP1 when it is being used in a production capacity.

The AppDNA client is supported on all of the server platforms and also:

Microsoft Windows XP SP3 (32-bit and 64-bit editions)

Microsoft Windows Vista SP2 (32-bit and 64-bit editions)


6

Pre-Requisites

Pre-requisite Installation type

Microsoft .NET Framework 3.5 Service Pack 1 AppDNA server

Microsoft .NET Framework 3.5 AppDNA client

Microsoft SQL Server 2005 SP3,

Microsoft SQL Server 2008 SP3,

Microsoft SQL Server 2008 R2 SP1, or

Microsoft SQL Server 2008 R2 SP1 Express Edition (built-in 10GB limit on database size)

AppDNA server only – The SQL Server installation can

be on the same or a different machine as the AppDNA

server.

The SQL Server instance must be configured for

Latin1_General_CI_AS collation

To install the AppDNA database, you need an account

with the sysadmin server role.

During the configuration of AppDNA, you need to

specify a user account for the AppDNA Web site to use

when connecting to the database. This account must

have the bulkadmin server role and the db_owner

database role. If you use Windows authentication, this

user account must have administrator privileges on the

machine on which the AppDNA Web server is running,

or, if that is not possible, the permissions on the

AppDNA Web site folder must be relaxed to give read-

write permissions to the user account.

In addition, if the AppDNA server is installed on

Windows Server 2003, this user account must be in the

IIS_WPG group.

Microsoft Internet Information Services (IIS) AppDNA server only (production systems). See instructions for installing IIS below.

The name of the machine on which you install the AppDNA server must conform to the IIS requirements for domain names: it must consist only of Latin characters a through z, A through Z, digits 0 through 9, or the hyphen character (-). The name must not start or end with a hyphen and must not contain an underscore (_) character.

For an evaluation or proof of concept (POC) single-user system, you can optionally use the built-in AppDNA personal Web Server (PWS) instead. This does not require IIS.


7

Pre-requisite Installation type

Internet Explorer 6 or later AppDNA client and server

JavaScript and unencrypted forms must be enabled.

Important: The AppDNA server cannot be installed on a machine on which the Citrix license

server is already installed.

Additional Requirements

The following AppDNA features are dependent on additional software:

Install Capture – This requires the use of a virtual machine based on one of the supported desktop

virtualization technologies – VMware Workstation 7.1, VMware Server 2.x or Microsoft Virtual

Server.

If you have a Production Manager license, the capture process can create App-V sequences, XenApp

profiles or installable MSI files instead of (or as well as) MSI files simply for importing into AppDNA.

This requires additional software to be installed on the virtual machine. For example, in order to

create App-V sequences the App-V sequencer must be installed. Similarly, in order to create XenApp

profiles, the XenApp profiler must be installed. This additional software does not come with

AppDNA. See the AppDNA Install Capture Configuration Guide for more information.

Organization Reports – This supplementary feature requires access to Microsoft Active Directory

and Microsoft System Center Configuration Manager (SCCM) data, which is imported into AppDNA

statically. Exporting the data from Active Directory and SCCM requires administrator access to the

Active Directory and SCCM servers. However, AppDNA provides a stand-alone tool that

administrators can run on the Active Directory domain controller and SCCM server. AppDNA 6.1

supports SCCM 2003 and SCCM 2007. See the AppDNA Integration Guide for full details.

Discover Applications – This optional feature depends on access to the Lakeside SysTrack database.

See the AppDNA Integration Guide for full details.

Word exports – Some of the report views (such as the Effort Calculator) provide an option to export

the results as a Word document. This requires Microsoft Word 2007 or Microsoft Word 2010 to be

installed on the client machine.

PDF exports – The application issues report view has an option to export a report in the form of a

PDF document. This requires Adobe Reader to be installed on the client machine.


8

Installing to a Virtual Machine

You can install AppDNA 6.1 to a virtual machine. However, this has implications for Install Capture.

Install Capture is used to import applications for which you do not have a Windows installer (MSI)

file or the SFT file of an App-V application and to package applications. Install Capture requires the

use of a virtual machine that is configured so that it can communicate with the AppDNA host

machine and vice versa. The details of configuring the Install Capture virtual machine vary depending

on the virtualization technology that you are using. See the AppDNA Install Capture Configuration

Guide for detailed information on this.

Some of the supported technologies (VMware Workstation and Microsoft Virtual Server) require

AppDNA to be installed on the virtual machine’s host machine. This is not possible when AppDNA is

itself installed in a virtual machine. However, Install Capture can be used when AppDNA is running in

a virtual machine if the virtualization technology provides full remote control (such as VMware

Server).

The AppDNA Self Provisioning feature provides an alternative mechanism for Install Capture tasks

and is suitable for use when AppDNA is installed in a virtual machine. See the AppDNA Advanced

Feature Guide for an overview of Self Provisioning.


This section describes how to install Microsoft Internet Information Services (IIS) and ASP .NET. The

details of how to do this vary between Windows Server 2008 and the other supported versions of

Windows. However, with one or two exceptions, you need to select the same features.

Note: IIS is required on the AppDNA server only. For complete installations on a single machine –

for example, for evaluation or POC purposes – you can optionally use the built-in AppDNA

personal Web Server (PWS) instead, which is not dependent on IIS.

On Windows 7:

1. Open the Control Panel and then select Programs and Features.

2. Select Turn Windows Features On or Off. This opens the Turn Windows Features on or off

dialog, which shows optional features in a tree view. There may be a delay while the tree

view is populated.

3. Look for the Internet Information Services feature. Expand the item in the tree view and

ensure that the sub-features listed below are selected.


9

On Windows Server 2008:

1. Open the Control Panel and then select Programs and Features.

2. Select Turn Windows Features On or Off.

3. Right-click the Roles item and select Add Roles.

4. On the Before You Begin screen, click Next.

5. On the Select Server Roles screen, select Web Server (IIS) and Application Server and click

Install.

6. Add the additional features listed below. To do this, expand Roles, then right-click Web

Server (IIS) and select Add Role Services, then ensure that the sub-features listed below are

selected.

Windows 7 Turn Windows features on or off dialog box (see below for full list of features that need to be selected)

Ensure that the following sub-features under Internet Information Services are selected:

– Internet Information Service

– Web Management Tools

– IIS Management Compatibility

– IIS Metabase and IIS 6 Configuration Compatibility (Windows Vista and higher only)

– IIS Management Console

– IIS Management Scripts and Tools

– IIS Management Service

– World Wide Web Services

– Application Development Features

– .NET Extensibility

– ASP

– ASP .NET

– ISAPI Extensions

– ISAPI Filters


10

– Server-Side Includes

– Common HTTP Features

– Default Document

– Directory Browsing

– HTTP Errors

– HTTP Redirection

– Static Content

– Health and Diagnostics

– HTTP Logging

– Request Monitor

– Performance Features

– Dynamic Content Compression

– Static Content Compression

– Security

– Basic Authentication

– Request Filtering

– Windows Authentication

11

Installing AppDNA

AppDNA is a client/server application. The server includes a Web server and a SQL Server database.

These can be on the same or different physical machines. In production systems, Citrix recommends

that you use the full IIS-based Web server. In evaluation or proof of concept (POC) installations, you

can use the built-in AppDNA personal Web server (PWS), which does not require IIS.

Note: Before installing AppDNA for use in a production capacity, Citrix recommends that you

refer to the AppDNA Setup and Optimization Best Practice Guide. This provides detailed

hardware and software recommendations for different scenarios.

There are two installers for AppDNA:

Citrix AppDNA.msi – This is the standard installer. Use this for all client installations, upgrades,

and the installation of the AppDNA server for production systems.

Citrix AppDNA Quick DB Installation.msi – This is identical to the standard installer, except that

it includes a backed up database, which makes the initial server set up faster. However, the

database has a fixed name, which cannot be changed. In addition, you can restore the database

only if the SQL Server installation is on the same machine as the AppDNA server. This installer is

suitable for new installations for evaluation and POC purposes only. This installer takes longer to

download than the standard installer.

Use the installer that is most appropriate to your needs. The installation is the same for both

installers, with a minor difference in the configuration stage, which is noted in the instructions that

follow.

Important: If you are upgrading AppDNA from a previous release, see Upgrading AppDNA.

Installing AppDNA

12

Install AppDNA

Note: These steps apply to upgrading AppDNA as well as installing for the first time. However, if

you are upgrading, Citrix recommends that you read Upgrading AppDNA before you carry out

these steps.

1. To begin the AppDNA installation, run the AppDNA installer.

2. On the Welcome Screen, click Next.

3. Click I accept the terms in the license agreement, and then click Next.

Installing AppDNA

13

4. Select one of the following options:

Client only – This installs the AppDNA client only. This is an installation of the AppDNA

application, which connects to an AppDNA Web site and database that are located on another

machine (sometimes the database is on a different machine from the AppDNA Web site). At the

end of the installation, the Configure AppDNA Environment wizard walks through the steps to

configure the client to point to the AppDNA Web site and database.

Complete (server + client) – This installs the AppDNA server and client files together on the

same machine. At the end of the installation, the Configure AppDNA Environment wizard walks

through the steps to create (or upgrade) the SQL Server database and configure the AppDNA

Web site. The database can be installed and configured on the local machine or on a machine

located on the network.

5. Click Next to continue with the installation.

If the pre-requisites are not installed on the machine, a dialog will open informing you that these

are missing. If this happens, click Cancel to exit the installation. Then install the pre-requisites.

(These are documented in AppDNA Platform Requirements.) Then start the AppDNA installation

again.

Installing AppDNA

14

6. Specify the location for the AppDNA client files, and for the server files if you are doing a

complete installation. Citrix recommends that you use the default locations:

Platform Client Server

32-bit C:\Program Files\Citrix\AppDNA C:\Program Files\Citrix\AppDNA\Server

64-bit C:\Program Files (x86)\Citrix\AppDNA C:\Program Files (x86)\Citrix\AppDNA\Server

7. Click Next to continue with the installation.

8. Click Install to begin the installation.

This starts the installation. When the installation has finished, the Installation Wizard Completed

dialog opens.

By default, the option to launch the Configure AppDNA Environment wizard is selected. You use

this to configure the installation. You need to do this before you can use AppDNA.

Installing AppDNA

15

9. Click Finish to finish the installation and (if selected) launch the Configure AppDNA Environment

wizard. The wizard varies according to the type of installation or upgrade you are doing:

If you are See

Installing a complete installation Configure a Complete Installation

Installing or upgrading a client installation Configure a Client Installation

Upgrading a complete or server installation Upgrade a database

Note: You can launch the Configure AppDNA Environment wizard later. To do this, choose Citrix

AppDNA > Management Tools > AppDNA Configuration from the Windows Start > Programs

menu.

16

Configure a Complete Installation

This section provides step-by-step instructions for using the Configure AppDNA Environment wizard

to configure a complete new AppDNA installation (for example, for an evaluation of AppDNA) or a

server installation for a production system.

Note: The AppDNA Configuration Wizard creates the new database files in the default database

file location set in SQL Server. If you want the database files to be stored in a different location,

you need to change the default location in SQL Server before you run the wizard. See Setting the

location of the database files for more information.

The wizard opens by default when you finish the installation step. (To open the wizard later, choose

Citrix AppDNA > Management Tools > Configure AppDNA from the Windows Start menu.)

1. Select Configure new installation and then click Next.

Note: If you need more information at any time when working through this wizard, click Need

help? in the lower left corner.


17

2. This step has two options, but only one is enabled - depending on whether Microsoft Internet

Information Services (IIS) is installed on your machine.

Production Web server – This option creates an AppDNA Web server based on IIS. This is

recommended and is a requirement if you are configuring a production AppDNA system. You

can also use this option for an evaluation or trial installation.

If this option is not enabled, it means that IIS is not installed on your machine. If you want to

use this option, cancel out of the wizard and install and configure IIS (for instructions, see

Installing IIS and ASP.NET). Then, start this wizard again, and this option will be selected.

Single machine Web server – This option uses the AppDNA built-in personal Web server

(PWS). This option is automatically selected if you do not have IIS installed on your machine.

This option is suitable if you are configuring AppDNA for an evaluation and you are not able

to install IIS. This option does not support multiple AppDNA clients.

3. Click Next to move to the next step.


18

4. AppDNA uses a Microsoft SQL Server database to store the data in. Specify the name of the new

database, the location of the SQL Server instance and the connection details:

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 – The name of the new database. This must be unique within the SQL Server

instance. Generally, this defaults to AppDNADB, but you can change it.

Note: If you used the Citrix AppDNA Quick DB installer, the database name defaults to AppDNA

and a note appears under the Database name box. Accept this default name if the SQL Server

installation is on the local machine and you want to restore the database included in the

installer. This is faster than creating a new database. Otherwise, change the name to create a

new database.

Database authentication – In this section you enter the credentials for connecting to SQL Server

when creating the database. Regardless which authentication method is in use, the user account

must have the sysadmin server role.

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 set.

SQL Server authentication – This opens two additional prompts:

o User name – Enter the user name to use to connect to SQL Server and create the

database and database tables.


19

o Password – Enter the account password.


Note: This step does not appear if you are using the AppDNA built-in personal Web server (PWS).

When you use this option, by default AppDNA uses the logged on user's credentials when

connecting to the AppDNA database after it is created. If you want AppDNA to connect to the

database using SQL Server authentication, you need to run this wizard again and change the

credentials as explained in the AppDNA Administration Guide.

6. In this step, you specify the credentials that the AppDNA Web site is to use when connecting to

the database after it is created. Citrix recommends that in a production system you use an

AppDNA-specific service account that has a password that does not expire instead of the

account used in the previous step to create the database.

Authentication – This determines the authentication mechanism for connecting to SQL Server

when the AppDNA Web site connects to the database. Regardless which authentication method

is in use, the user must have the bulkadmin server role and the db_owner database role.

Windows authentication – This type of authentication uses the logged on Windows user

account when connecting to the database. Specify the user name and password of the

account you want the AppDNA Web site to run under. Citrix recommends that, in a

production system, this is a service account that has a password that does not expire. In an

evaluation or trial system, you can typically use the currently logged in user account.

This account must have local administrator privileges or, if that is not possible, the

permissions on the AppDNA Web site folder must be relaxed to give read-write permissions


20

to the user specified here. (By default, the AppDNA Web site folder is C:\Program Files

(x86)\Citrix\AppDNA\Server on a 64-bit system or C:\Program Files\Citrix\AppDNA\Server on

a 32-bit system.)

In addition, if the AppDNA server is installed on Windows Server 2003, this user must be in

the IIS_WPG group (see Additional configuration for Windows Server 2003 for more

information).

The Windows user account must have a password set.

SQL Server authentication – This type of authentication uses specific SQL Server login

details, which you enter below.

User name – If you chose SQL Server authentication, enter the user name that the AppDNA Web

site is to use to connect to SQL Server. If you chose Windows authentication, specify the domain-

qualified Windows username – for example, domain\username.

Password – Enter the account password.


8. In this step you can choose to activate a commercial AppDNA license or run AppDNA in

evaluation mode for up to 30 days:

Activate now – Select this option if you want to activate your license now. You now need to log

into http://www.mycitrix.com and allocate and download your license file (see

http://support.citrix.com/article/CTX126167 for step-by-step instructions).

When you do this, you must enter the name of the machine that hosts the AppDNA license

server. Click Copy to copy this to the clipboard for pasting into http://www.mycitrix.com.

http://www.mycitrix.com/

http://support.citrix.com/article/CTX126167



21

License server machine name – This shows the name of the AppDNA license server machine.

This is the same machine as the AppDNA server.

Location of license file – After you have downloaded your license file, enter its name and

location here. This must be a license issued from http://www.mycitrix.com and not an old

AppDNA license (.clf) file. If necessary, you can log into http://www.mycitrix.com and

download new Citrix licenses that match your existing entitlements.

Note: AppDNA handles licensing differently from other Citrix products – so if you have

purchased multiple Citrix products, Citrix recommends that you download your AppDNA

license(s) separately from the licenses for the other products.

Run in evaluation mode – Select this option if you want to run AppDNA in trial mode for up to

30 days. This allows the import of 10 applications and the analysis of five applications against all

of the available reports while you evaluate the product.


10. This page checks your system. Click Need Help? in the lower left corner for more information

about the checks and what to do if they fail.

11. Click Next to start the configuration of AppDNA and the creation of the database. This takes

some time.

Note: If you chose the Production Web server option, this also performs an IIS reset. This will

make any other Web sites hosted by IIS on this server unavailable for a brief interval.




22

12. When the process has finished, the wizard provides a summary page.

13. Click Close to exit the wizard.

You are now ready to get started using AppDNA. See Logging into AppDNA for the First Time for

more information.

23

Configure a Client Installation

The Client installation installs the AppDNA client. This is an installation of the AppDNA application,

which connects to an AppDNA Web site and database that are located on another machine

(sometimes the database is on a different machine from the AppDNA Web site). At the end of the

installation, the AppDNA Configuration wizard walks through the steps to configure the client to

connect to the AppDNA Web site and database.

This section provides step-by-step instructions for using the AppDNA Configuration wizard to

configure an AppDNA client installation.


Citrix AppDNA > Management Tools > Configure AppDNA Client from the Windows Start menu.)

1. Enter the URL of the AppDNA Web site – for example, http://server:8199/AppDNA, where server

is the name of the AppDNA server machine, 8199 is the port number, and AppDNA is the name

of the AppDNA Web site.

2. Click Next to move to the system text page. This page checks your system. Click Need Help? in

the lower left corner for more information about the checks and what to do if they fail.

3. Click Close to exit the wizard.

Configure a Client Installation

24

You are now ready to get started using AppDNA. See Logging into AppDNA for the First Time for

more information.

Note: The wizard creates a site for each AppDNA database that is connected to the AppDNA

Web site. You use the site when you login to AppDNA to specify which database you want to

connect to.

25

Upgrading AppDNA

Check list

Should I uninstall my old version before upgrading? No, do not uninstall the previous version

before installing and configuring AppDNA 6.1. The installer will then automatically delete any

unnecessary old files whilst preserving your settings and configuration options.

How long will the upgrade take? Upgrading a database to AppDNA 6.1 from AppTitude 5.1 and

earlier can take a long time, particularly if you have a large application portfolio. On an AppDNA

recommended system the upgrade time is expected to be approximately one hour per 500

applications if all modules are enabled. Upgrading from AppDNA 6.0 is not expected to take as long.

Disk space – In AppDNA 6.0 and later, the results of the analysis of the application DNA are stored in

the database in a format optimized for report generation. This means that generating reports is now

significantly faster than in AppTitude 5.1 and earlier. However, it also means that the size of your

database will increase by approximately 15% when you upgrade from AppTitude 5.1 or earlier. You

therefore need to ensure that you have sufficient disk space available before you upgrade.

Default OS images are now installed into the database for all relevant versions of Windows. This

requires significant additional disk space (2 – 3GB) if you previously chose to install only a subset of

them.

Web site name – The upgrade process renames the AppTitude Web site to AppDNA, preserving the

configuration files and moving them to the new location.

Licensing – The licensing system in AppDNA 6.1 has changed to integrate with the Citrix licensing

system. All new AppDNA licenses are now issued through http://www.mycitrix.com. However, if you

are upgrading from previous versions of AppDNA, your old licenses will be upgraded automatically to

the new licensing scheme.

Note: If your AppDNA license server is located on a separate machine from the AppDNA Web

server, you need to upgrade it before you upgrade the AppDNA database. To do this, download

Citrix AppDNA License Server.msi and run it on the machine that hosts the AppDNA license

server.


Upgrading AppDNA

26

Changed requirements

Supported operating systems – Although Windows XP and Windows Vista are supported as

platforms for the AppDNA client, they are no longer supported as platforms for the AppDNA server.

Microsoft .NET Framework – The AppDNA 6.1 server requires Microsoft .NET Framework 3.5 SP1

and AppDNA 6.1 client machines require Microsoft .NET Framework 3.5. This is unchanged from

AppDNA 6.0.

SQL Server – SQL Server 2005 Express is no longer supported.

See AppDNA Platform Requirements for the full list of requirements.

Upgrading a single-machine or server installation

1. Run the installer as described in Installing AppDNA. Do not uninstall before installing.

2. Use the Configure AppDNA Environment wizard to upgrade each database as described in

Upgrade a database.

3. Upgrade the AppDNA tools as described in Upgrading the AppDNA Tools.

4. If there are any remote AppDNA clients, upgrade each one as described in Upgrading a client

installation.

Upgrading a client installation

1. Run the installer as described in Installing AppDNA. Do not uninstall before installing.

2. Configure the client to connect with the server as described in Configure a Client Installation.

3. Upgrading the AppDNA Tools.

Upgrade a database

This section provides step-by-step instructions for using the Configure AppDNA Environment wizard

to upgrade your database. If you need more information at any time when working through this

wizard, click Need help? in the lower left corner.

Note: If you have multiple databases, you need to run through these configuration steps for each

database.


Citrix AppDNA > Management Tools > Configure AppDNA from the Windows Start menu.)

Upgrading AppDNA

27

1. Select Upgrade installation and click Next.

Note: When necessary, this option performs an IIS reset. This will make any other Web sites

hosted by IIS on this server unavailable for a brief interval.

2. From the Database drop-down list, select the database you want to upgrade.

3. Optionally select Backup (recommended) and then click Next. This opens the System Check

page.

Upgrading AppDNA

28

4. This page tests your system. Click Need Help? in the lower left corner for more information

about the checks and what to do if they fail.

5. Click Next to start the database upgrade. This takes some time.

Upgrading the AppDNA Tools

When you upgrade to AppDNA 6.1, you also need to upgrade your Install Capture, Self Provisioning

and Web Application Capture tools.

The installers for the tools are installed with AppDNA 6.1:

Citrix AppDNA Self Provisioning Client.msi

Citrix AppDNA VM Configuration.msi

Citrix AppDNA Web Application Capture.msi

By default they are installed to the following folder.

Platform Location of stand-alone installers

32-bit C:\Program Files\Citrix\AppDNA\Tools

64-bit C:\Program Files (x86)\Citrix\AppDNA\Tools

Install Capture

If you use Install Capture, you need to create a new virtual machine snapshot that has the new

version of the Citrix AppDNA VM Configuration MSI installed within it. For information about

configuring the virtual machine for Install Capture, see the AppDNA Install Capture Configuration

Guide.

Self Provisioning

If you use Self Provisioning, you need to install the new versions of the Citrix AppDNA Self

Provisioning Client and Citrix AppDNA VM Configuration MSIs on the Self Provisioning client

machine. Uninstall the previous version of the tools before installing the new ones. For more

information, see the AppDNA Self Provisioning Guide and the AppDNA Advanced Feature Guide.

Web Application Capture

If you use the stand-alone Web Application Capture tools, you need to uninstall them and then

install the new version of the Citrix AppDNA Web Application Capture MSI. For more information

about these tools, see the AppDNA Web Application Capture User Guide.

29

Logging into AppDNA for the First Time

Start AppDNA by choosing Citrix AppDNA > AppDNA from the Windows Start > All Programs menu.

This opens the Login to AppDNA screen.

Username and Password – Enter your user name and password. By default, AppDNA comes with an

administrator account that can be used to log in and set up additional accounts:

Username: administrator

Password: apps3cur3

If you are working in a multi-database environment, you select the database from the Site drop-

down list (which becomes available when you click Options).

For more information about the options in the login screen, see the AppDNA Basic User Guide.

When an administrator logs into AppDNA for the first time, the Configure Modules wizard opens to

walk you through the steps of configuring AppDNA to meet your needs. For more information, click

Need help? in the lower left corner of the wizard or refer to the AppDNA Advanced Feature Guide.

Note: If the login fails and you are using Windows Server 2003, follow the steps described in

Additional configuration for Windows Server 2003.

30

Appendix

Setting the location of the database files

The AppDNA Configuration Wizard creates new databases in the default database file location set in

SQL Server. If you want the database files to be stored in a different location, you need change the

default location in SQL Server before you run the wizard. To do this:

1. Open Microsoft SQL Server Management Studio.

2. Right-click the server instance and choose Properties. This opens the Server Properties dialog.

3. Click the Database Settings tab.

4. Under the Database default locations section, set the default location for the database data and

log files.

5. Click OK.

Appendix

31

Additional configuration for Windows Server 2003

If you are using an IIS-based AppDNA Web server on a Windows Server 2003 platform and you are

using Windows authentication, the user you enter in the AppDNA Web Site Credentials step (step 6)

must be part of the IIS_WPG group. The Configure AppDNA Environment wizard attempts to set this

up for you. However, sometimes this may not be successful. You will then find that you cannot log

into AppDNA. To resolve this issue, add the user to the group manually as explained below.

Add the user to the IIS_WPG group

1. Open the Windows Control Panel.

2. In the Administrative Tools group, open Computer Management.

3. In the tree view on the left side, expand Local Users and Groups.

4. In the tree view on the left side, click Groups. This lists the groups in the middle panel.

5. Right-click the IIS_WPG group, and from the shortcut menu, choose Add to group.

6. Click Add in the lower part of the dialog box.

7. In the Enter the object names to select box, enter the domain qualified user name.

8. Click Check Names to confirm that you entered the user name correctly.

9. Click OK twice to save your changes and close the dialog boxes.

You now need to restart the AppDNAAppPool in IIS Manager – otherwise attempting to log into

AppDNA will fail.

Restart the AppDNAAppPool in IIS Manager

1. In the Windows Start > Run box, enter inetmgr.

2. In the list of results, click inetmgr. This opens IIS Manager.

3. Expand the tree view on the left side, and click Application Pools. This displays the application

pools in the pane on the right side of the window.

4. In the pane on the right side, click AppDNAAppPool.

5. On the toolbar, click Stop.

6. On the toolbar, click Start.

Appendix

32

Installing AppDNA from a Command Prompt

You can optionally run the AppDNA installer from a command prompt. This section describes the

syntax.

Note: Installing AppDNA from a command prompt requires administrative privileges. On

Windows Vista and Windows Server 2008 and later, you must request User Account Control

elevation. To do this, right-click the command prompt on the Windows Start > Programs menu

and choose Run as administrator.

Syntax

The items enclosed in brackets ([ ]) are optional. When including these options, omit the brackets.

msiexec /i "package" /qn [INSTALLDIR="installdir"] [SERVER="serverdir"] [SETUP="type"]

Element Description

package Required. This is the name and location of the MSI installer.

/qn Signifies a silent installation.

installdir Optional. This defines the installation folder. If this is not specified, the default location is used: %ProgramFiles%\Citrix\AppDNA on a 32-bit machine and %ProgramFiles(x86)%\Citrix\AppDNA on a 64-bit machine.

serverdir Optional. This defines the installation folder for the server components. If this is not specified, a Server subfolder is created within the main installation folder.

type Optional. This specifies the installation type. It can have the value “Complete” or “Client”. If this is not specified, the value, “Complete” is used.

Examples

Perform a complete install silently using the default options:

msiexec /i "C:\Users\fishan\Downloads\Citrix AppDNA.msi" /qn

Perform a client install silently using the default options:

msiexec /i "C:\Users\fishan\Downloads\Citrix AppDNA.msi" /qn SETUP=”Client”

33

Getting More Help

The features available in AppDNA are documented in separate user guides so that the information is

tailored to different tasks. User guides are available for download from the Resources and Support

page in the AppDNA section of the Citrix Web site (http://www.citrix.com/appdna).

Note that there is context-sensitive help available on every AppDNA screen. To open the Help, just

press F1 or click the Help link at the top right of the screen. Some dialogs also have context-sensitive

help – just click the Help button. You can also open the help system from the Help menu.

AppDNA Basic User Guide

This guide helps you get started using the basic features, including:

Getting started with AppDNA

Logging into AppDNA

The key features of the user interface

Importing Windows applications

Analyzing applications

The features of the Application List

Creating application groups

The key features of the various report views

Viewing and exporting reports

Glossary

AppDNA Installation Guide

This guide walks you through installing AppDNA:

Pre-requisites


Step-by-step instructions for installing and upgrading AppDNA

Configuring your AppDNA environment after installation or upgrade

AppDNA Setup and Optimization Best Practice Guide

This is a comprehensive guide to the setup and optimization of AppDNA:

Setup requirements for the different installation types

Microsoft SQL Server optimizations

AppDNA configuration optimization

http://www.citrix.com/appdna

Getting More Help

34

Windows Internet Information Services (IIS) settings

Anti-Virus configuration

AppDNA import optimizations

AppDNA performance and scalability testing

AppDNA Integration Guide

This guide walks you through integrating your applications and operating system DNA data with

information from Active Directory and System Center Configuration Manager (SCCM) and using data

from Lakeside SysTrack to discover which applications are actually used in your organization.

Configuring the connection with the SysTrack database

Discovering which Windows applications are actually used within your enterprise

Importing discovered applications into AppDNA and linking them with applications that are

managed through Active Directory and SCCM

Importing data from Active Directory and SCCM

Importing packages deployed through Active Directory or SCCM into AppDNA

Linking deployed packages with applications already imported into AppDNA

Creating groups for your applications based on Active Directory and SCCM entities

Viewing reports based on division, department, users and other structures discovered from

Active Directory and SCCM

AppDNA Install Capture Configuration Guide

This guide provides information about configuring AppDNA and the virtualization technology for

Install Capture:

Configuring a VMware Workstation virtual machine

Configuring a VMware Server virtual machine

Configuring a Microsoft Virtual Server virtual machine

Configuring the host machine

Install Capture configuration settings

Execution profiles

Replaceables

Install Capture troubleshooting

AppDNA Advanced Feature Guide

This guide covers some of the advanced features available in AppDNA, including:

Initial module configuration

Creating and managing families and suites

Using the journal

Importing and configuring operating system images

Getting More Help

35

Module management

Configuring algorithms (including setting custom RAGs)

Action administration

Creating and editing custom reports

Searching and browsing application files and settings

Self Provisioning administration

AppDNA Administration Guide

This guide covers a variety of admin features, including:

User management

Role management

Configuring external data

Applying licenses to unlock applications

Application fingerprints

Tasks

Site management

Configure AppDNA Environment wizard

Creating a new database and adding an existing database

License management

Web site configuration

General troubleshooting

AppDNA Web Application Capture User Guide

This guide covers importing Web applications into AppDNA, using:

The Web application import feature within AppDNA

The stand-alone Web application capture tools

AppDNA Self Provisioning User Guide

This guide walks expert users through the process of using the stand-alone Self Provisioning tool:

Launching the Self Provisioning Application Capture Wizard

Browsing to the supplied instruction file or package

Proceeding through the wizard steps to capture the application

Getting More Help

36

AppDNA Effort Calculator Guide

This guide covers using Effort Calculator to report on the time, cost and effort associated with

migrating a portfolio to a new platform:

Effort calculator worksheet

Setting variables

Generating and exporting the report

AppDNA Forward Path Planning Guide

This guide walks you through configuring the Forward Path business decision engine:

Creating the Forward Path logic

Creating a task script

appdna installation guide

Documents

upgrading appdna

install appdna

appdna tools

client installation

appdna platform requirements

server installation

complete installation

additional requirements