Basic Troubleshooting for AppDisk

Basic Troubleshooting for AppDisk

book

Article ID: CTX215789

calendar_today

Updated On:

Description

This is a quick guide to help with evaluating and troubleshooting issues that may arise while using the AppDisk Feature of XenApp and XenDesktop.


Instructions

AppDisks Review
 
AppDisks separate applications from their base operating system mages, easing administrative overhead. Creating an AppDisk adds a new volume attached to the base image. Applications are installed to this volume and it must be sealed when complete. Once sealed, AppDisks can be assigned to Delivery Groups and can be made available within desktops and as published applications. If updates to an application are required, a new version of the AppDisk is created. The new AppDisk must be assigned to a Delivery Group before the new version of the application is available to users.
  • AppDisks separate applications and base OS images
  • AppDisks are assigned to Delivery Groups
  • AppDNA can analyze compatibility issues
  • Be aware of storage and compatibility considerations
  • Troubleshoot using AppDNA, CDFControI, Diagnostic Tool
 AppDisks Considerations:
  • Not all applications are suitable candidates for AppDisks.
  • AppDisks are supported on XenServer and versions of VMware greater than 5.1.
  • All machines in a Delivery Group with AppDisks must be from catalogs all linked to the same hosting resources.
  • When using AppDisks with Provisioning Services, only one maintenance operation should be performed at a time for a particular catalog or device collection.
  • Machine Creation Services has no restriction.
  • AppDisks are limited to pooled random and assigned VDI and RDS catalogs - dedicated catalogs do not support this technology.
  • AppDisks cannot be used in conjunction with the  Personal vDisk feature.
  • Between ten to thirteen AppDisks are allowed per virtual machine.
  • Ensure the hypervisor tools are installed on all images prior to creating or using AppDisks
  • Administrators have the ability to manually create AppDisks themselves as well as manage AppDisks using the SDK
  • Storage requirements must be considered when using AppDisks because the number of volumes can rapidly increase.
  • See XenApp and XenDesktop 7.8 documentation for more information.
 
AppDisks Troubleshooting

• Review AppDNA analysis: If an AppDisk application is not available when launching a resource, review the detailed analysis to confirm the application is suitable for AppDisk delivery.  

 User-added image

Change priority order for dependencies: If multiple AppDisks are assigned to a Delivery Group, change the priority within a Delivery Group to see if it has any effect on the behavior.
 
User-added image

CDF tracing is available for the AppDisks feature - make sure to include the modules shown here:
  CDF modules AppLibrary*, MachineCreation*, Broker* , DesktopStudio
User-added image

• PowerShell:  The PowerShell command below can be used to obtain detailed information about a failure state.
 
    Get-AppLibAppDisk -AppDiskName <appdiskname>
 

User-added image

• CtxAppDisksDiag.exe : Finally. the AppDisk driver on each VDA includes a diagnostic tool which gathers the service logs written during creation and delivery, the DaFsLogFile, metadata for each AppDisk System and Application event logs and MSlnfo output. All of this information may be useful during a troubleshooting scenario.
 
User-added image
 

Environment

The above mentioned sample code is provided to you as is with no representations, warranties or conditions of any kind. You may use, modify and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the sample code may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the sample code fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the sample code. In no event should the code be used to support ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SAMPLE CODE, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Although the copyright in the code belongs to Citrix, any distribution of the sample code should include only your own standard copyright attribution, and not that of Citrix. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the sample code.

Issue/Introduction

This is a quick guide to help with evaluating and troubleshooting issues that may arise while using the AppDisk Feature of XenApp and XenDesktop.

Additional Information

AppDisk Product Documentation:
https://docs.citrix.com/en-us/xenapp-and-xendesktop/7-8/install-configure/appdisks.html

AppDNA 7.8 Documentation:
http://docs.citrix.com/en-us/dna/7-8.html