Navigation
- Planning
- SQL Database
- Server Prerequisites
- Server Installation
- Configuration Wizard
- Launch and Login
- Welcome Wizard
- Users
- Direct Import
- Install Capture
- Self Provisioning
- Solutions
Planning
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.
SQL Server:
- SQL 2008 R2, 2012, or 2014. 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 docs.citrix.com.
- 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.
SQL Database
- Create a new SQL database.
- On the Options page, the Collation must be Latin1_General_CI_AS.
- Add a service account to SQL logins.
- On the Server Roles page, add the service account to the bulkadmin role.
- Give the service account db_owner permission to the AppDNA database.
Server Prerequisites
- On the AppDNA Server, open Computer Management. Edit the Administrators group and add the service account.
- In Server Manager, start the Add Roles and Features Wizard.
- In the Server Roles page, select Web Server (IIS) and click Next.
- In the Select features page, select .NET Framework 3.5 (and 4.5). Click Next.
- In the Select role services page, select HTTP Redirection. Scroll down.
- Scroll down and under Health and Diagnostics select Request Monitor.
- Scroll down and under Performance select Dynamic Content Compression.
- Scroll down and under Security select Basic Authentication, IP and Domain Restrictions, URL Authorization, and Windows Authentication.
- Scroll down and under Application Development select everything except CGI and WebSocket Protocol.
- Scroll down and check the box next to IIS 6 Management Compatibility, which includes IIS 6 Metabase Compatibility.
- Also select IIS Management Scripts and Tools and Management Service. Click Next.
- In the Confirm installation selections page, click Specify an alternate source path.
- Browse to the sources folder on the Windows Server 2012 R2 DVD and click OK.
- Click Install.
Server Installation
- Run the downloaded AppDNA 7.6.5 (Citrix-AppDNA.msi).
- In the Welcome to the Installation Wizard for Citrix AppDNA 7.6.5 page, click Next.
- In the License agreement page, select I accept the terms and click Next.
- In the Citrix AppDNA Installation Type page, select Complete and click Next.
- In the Citrix AppDNA installation locations page, click Next.
- In the Ready to install Citrix AppDNA page, click Install.
- In the Installation Wizard Completed page, click Finish.
Configuration Wizard
- The Configuration wizard launches.
- If you see a Prerequisites page, click Enable.
- In the Configure AppDNA page, click Next.
- In the Database creation page, enter the SQL server name, enter the database name, and click Next.
- In the AppDNA web site credentials page, enter the credentials of your service account and click Next.
- In the License database page, enter the address of a Citrix License server that has XenApp/XenDesktop Platinum Licenses and click Next.
- In the System check page, click Configure.
- It will probably take several hours to populate the database.
- Click Close when done.
- See Optimize AppDNA > Optimize IIS at docs.citrix.com.
Launch and Login
- Launch AppDNA from the Start Menu.
- Login as administrator and apps3cur3.
Welcome Wizard
- In the Welcome page, click Next.
- 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.
- Then click Configure.
- And click Close.
Users
- Open the Administration menu and click Users.
- In the toolbar, click Import from AD.
- Select your Citrix Admins group and click OK.
- On the right, notice that Administrators role is selected by default.
- Open the File menu and click Exit.
- Launch AppDNA again.
- On the login page, click Options.
- You can check the box next to Integrated Login and click Log On.
- Go back to Administration > Users.
- Edit the administrator account.
- And change its password.
Direct Import
- Switch to the Import & Analyze workspace.
- On the left, under Import, click Applications.
- On the right, switch to the Direct Import tab.
- Click Browse in the toolbar. Then browse to an .MSI file.
- The .msi files are shown in the list. Use the checkboxes on the left to select the applications.
- Then on the top right click the Import & Analyze button to begin analysis.
- A progress bar is displayed next to the application.
- Analysis begins immediately. You can change the analysis modules by going to Configure > Modules > Wizard.
- After analysis is complete, select a report you want to view and click Finish on the top right.
- You can also view reports for applications that have already completely analysis by switching to the Reports: Applications workspace.
- On the left, select a report you want to view.
- You might be prompted to select applications. If you want to change this selection later, there’s a Change Selection button on the toolbar.
- 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
- Create a share on the AppDNA machine. The captured data is stored in this share.
- The operating system of the Install Capture machine should match the operating system version you are migrating from.
- On the Install Capture machine, make sure Remote Desktop is enabled.
- On the Install Capture machine, browse to the AppDNA server in the C$\Program Files (x86)\Citrix\AppDNA\Tools folder and run Citrix AppDNA VM Configuration.msi.
- In the Welcome to the Installation Wizard for Citrix AppDNA VM Configuration page, click Next.
- In the License Agreement page, select I accept the terms and click Next.
- In the Ready to Install the Program page, click Install.
- In the Installation Wizard Completed page, click Finish.
- Click Yes when prompted to reboot.
- You can either take a snapshot now or AppDNA will do it for you.
Configure AppDNA for Install Capture
- In the AppDNA Console, open the Edit menu and click Settings.
- On the left, switch to the Install Capture page.
- On the right, click New.
- In the Virtual Machine Configuration Wizard page, click Next.
- In the Virtual machine details page, give the configuration a name.
- Select vSphere and click Next.
- In the vSphere Host Details page, in the Single Sign-on Server field, enter the Platform Services Controller hostname and :7443.
- In the vCenter Server field, enter the hostname of the vCenter server.
- Enter credentials that can snapshot and perform power operations on the Install Capture machine. Click Test and then click Next.
- In the vSphere Virtual Machine page, in the list of machines, select the Install Capture machine and click Next.
- In the vSphere Snapshot selection page, if there are no snapshots, click Take Snapshot.
- Click Test. At least confirm that the machine can be reverted to snapshot. Don’t worry if the console doesn’t open. Click Next.
- 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.
- In the Capture output location page, enter the UNC path to the file share on the AppDNA server and click Test. Then click Next.
- In the Virtual machine state page, make a selection and click Next.
- In the Virtual machine configuration summary page, click Finish.
- Click Save to close the Settings window.
Perform Install Capture
- Switch to the Import & Analyze workspace.
- On the left, under Import, click Applications.
- On the right, switch to the Install Capture tab and click Browse.
- If you have more than one Install Capture machine, use the drop-down to select the one you want to use.
- On the top right click Import & analyze.
- The virtual machine configuration check window is displayed.
- The Install Capture VM will be started.
- Eventually you’ll be prompted to RDP to the Install Capture machine.
- The capture process begins with a snapshot of the Install Capture machine.
- Then the application is installed. This should happen automatically.
- Then a differencing snapshot is taken and uploaded to AppDNA Server.
- Once the Capture process is complete, Analysis begins immediately.
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
- Make sure AppDNA VM Configuration is installed first.
- 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.
- In the Welcome to the Installation Wizard for Citrix AppDNA Self Provisioning Client page, click Next.
- If you see the Pre-Requisites Check page, stop the installer, install the AppDNA VM Configuration Client and then restart this installer.
- In the License Agreement page, select I accept the terms and click Next.
- In the Destination Folder page, click Next.
- In the Ready to Install the Program page, click Install.
- In the Installation Wizard Completed page, click Finish.
- Take a snapshot of the Self Provisioning machine.
Perform Self Provisioning Capture
- In the AppDNA Console, switch to the Import & Analyze workspace.
- On the left, click Applications.
- On the right switch to the Self Provisioning tab.
- Then click the Configuration icon in the toolbar.
- In the Self Provisioning page, enter the UNC path to a share that both machines (AppDNA server and Self Provisioning machine) can access.
- In the toolbar click Browse and browse to the application installer.
- Click Publish to push the files to the file share.
- Click in the PublishedFile column to access the full path and copy it to the clipboard.
- On the Self Provisioning machine, run the Self Provisioning Client from the Start Menu.
- Paste in the path and click Start.
- After the snapshot is taken, click the Start button and install the application.
- Once the install is complete, another snapshot will be taken and the results will be uploaded to the share. Click Close.
- Back in the AppDNA console, click Refresh Status and make sure the status changes to Complete.
- Make sure the application is selected and then on the right side of the toolbar click Move to Import.
- This moves the application to the Direct Import tab where you can select the application and click Import & Analyze.
Solutions
CitrixTV XenApp Upgrades with AppDNA demonstrates the Solutions feature of AppDNA 7.6 including: XenApp upgrades, operating system image upgrades, and application interoperability. This is also detailed at Configure solutions at docs.citrix.com.
- 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..
- In the Import & Analyze workspace, on the left click Operating Systems.
- On the right, click Download Snapshot Manager. Run this on a operating system image that you want to import.
- Then click Import from MSI to import the MSI file generated by the Snapshot Manager.
- Switch to the Solutions workspace.
- On the top left click Add solution.
- In the Solutions Templates page, select a solution and click Next.
- In the Solution name page, give the solution a name and click Next.
- In the Platform name page, choose the platform you are migrating from and click Next.
- In the Applications page, select the applications you want to analyze and click Next.
- In the Solution platforms page you can change the Target platforms or add more platforms.
- Click Build.