XenDesktop SiteDiag (aka Site Checker v2.0)

Introduction to XenDesktop SiteDiag featuring WorkerDiag

Latest stable build available for download here

SiteDiag is my reworking of the original Site Checker tool that I developed while I was working on the XenDesktop Global Escalation team at Citrix. The purpose of this tool is to provide administrators and consultants with a utility to help diagnose issues with, and configure advanced/PoSH-only settings of a XenDesktop 5.x Site.

SiteDiag

SiteDiag was designed to have a look and feel similar to that of Desktop Studio, though it lacks certain functionality such as provisioning or assigning cloned vms. Since its a multi threaded winform that runs powershell scripts in a pipeline runspace, it’s pretty quick to use, and certainly more responsive than Studio. The main purpose of this tool is to view and modify site settings that aren’t otherwise displayed in Desktop Studio.

SiteDiagXD7

Some of the advanced settings that aren’t available in Desktop Studio are:

  • Check and fix issues with XenDesktop Site Services on all DDCs in a site
  • Enable service logging for each service on every DDC
  • Delete VM & PVD Storage
  • View & Cancel power actions
  • Edit advanced desktop group settings (all idle pool settings, logoff/disconnect power actions, WillShutDownAfterUse, etc.)
  • Display all details about almost any object clicked in the TreeView (ADIdentity pools, provisioning schemes, etc.)
  • View active/disconnected sessions by state
  • Enumerate a site to text file
  • Search for any element in a site

The tool also provides the following functionality as Desktop Studio, but is a MUCH faster alternative to the XD5.x MMC snapin:

  • Execute power actions
  • Enable/disable maintenance mode
  • Cancel/clear provisioning tasks (can run bulk actions)
  • Disconnect active sessions, logoff disconnected sessions

I’m currently working with Carl Webster to finish up the XenDesktop 5.x PowerShell documentation script, after which I plan to include in this tool. Also, I recently added remote connect functionality, though it’s only been tested by myself to this point, and requires the PowerShell SDK and required domain rights to access the DDC server.

WorkerDiag

I came up with this tool for a specific environment I was working on where the customer was experiencing intermittent registration issues among 10000+ static-assigned VMs spanning four XenDesktop ‘hosts’. The main purpose of this utility is to display key data points about VMs, or ‘workers’, that are unregistered from the XenDesktop site.

WorkerDiag
XenDesktop WorkerDiag

The biggest advantage of using this tool over Desktop Director is that it queries up to date WMI data points that are combined with XenDesktop PowerShell SDK results. For example, being able to see why certain machines were powered off, and comparing that to the WMI uptime can help to characterize power issues in a larger environment. I also added items such as displaying the VM’s ‘ListOfDDCs’ registry value, and check to see if the perfmon counter library is corrupt. All of the colums are movable, sortable, and hideable, and the results can be exported to CSV for reporting.

I’ll continue to update this page as I modify & expand this tool’s features and add compatibility with the next version of XenDesktop. Please let me know if you have any questions, comments, or concerns about these utilities.

-Kenny

Advertisements

First post – A little bit about me

Greetings, and welcome to my blog! My name is Kenny Baldwin, and I work as a Senior Citrix Consultant with iVision in Atlanta GA. I spent the last few years prior to iVision working as an Escalation Engineer for Citrix Systems, during which time my main area of focus was troubleshooting advanced technical issues reported by enterprise customers and Citrix partners alike. I’m MCSE/CCIA/Security+ certified, and have been in the field for over 10 years. I’m an Atlanta native, and have a wife and two daughters (1 & 3).

I’ve been working with Citrix products since 2009, and was fortunate to be able to spend a lot of time working with source code to help isolate and resolve customer reported bugs. During my time at Citrix I learned about many advanced debugging and troubleshooting techniques, with a focus on XenDesktop and XenApp issues. I gained a deep understanding of the inner workings of HDX, brokering, session launch, and site architecture, developing tools and scripts along the way. Working at Citrix also helped me to increase my understanding of Windows internals, as well as administering and troubleshooting the various supported hypervisor platforms.

I presented at TechEdge 2010 on HDX Flash as well as troubleshooting XenDesktop, and was awarded the ‘Services Hero 2012’ distinction for providing ‘world-class’ technical support. If you’ve ever worked with XenDesktop 5.x, you might be familiar with the ‘Site Checker‘ tool, which I created mostly out of necessity while supporting the product. I’ve been a major contributor to the XenDesktop support forum and visit CitrixIRC.com much less often than I’d like to.

Now that I’m a consultant with a Citrix partner, my main focus will be designing and implementing Citrix solutions. I hope to combine my unique understanding of XenDesktop and XenApp with iVision’s field-proven delivery assurance model to provide world-class Citrix solutions to our customers.

My hope is that this blog will give me an outlet to share my experiences with XenDesktop and XenApp including various tips, tricks, scripts, how-to’s, and troubleshooting tools for other Citrix professionals.

Thanks for stopping by, and may you find some Zen in your Xen! 🙂

-Kenny