This session will provide an insight into the top 10 troubleshooting tools used by our Customers, Partners and Support engineers.
These tools are crucial in helping you troubleshoot the root cause of issues in your Citrix environment.
During this session you will learn:
- Why troubleshooting tools are crucial in a Citrix environment
- Overview of each troubleshooting tool
- When should I use a tool?
- Issues and their resolutions
New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Top 10 troubleshooting Tools for your Citrix Environment
1. April 25, 2013
Citrix Support Secrets
Webinar Series
Top 10 Troubleshooting Tools for your Citrix Environment
David McGeough, Program Manager, WW Services Marketing
+ Special Guests
I’m sure many of you can relate to this picture, I know I can. What do you do when your Citrix environment blows upNever mind your users (and boss) calling/queuing asking when the issue is being fixed. As products become more complex, more moving parts, locations, services, registry keys, figuring out what is wrong can be an enormous task.Finding the root cause of the issue is obviously the main diver of creating these tools.Keeping servers alive and awake, or at least ready to instantly spring into action whenever needed, is an ambition close to the heart of virtually all data center leaders.
We made an exception for 1 tool, you will see why!
The MedEvac tool is used to run checks against a XenApp server farm to verify environment health.Supports XenApp 4.5/5.0. We ran a XenApp migration webinar in March to coincide with the EOL of of XenApp 4.5/5.0 on Windows Server 2003, so not surprised this is in the top 10.By the way, many of you probably attended our migration webinar. During this webinar we didn’t really concentrate on migration from 4.5 to 6.5. You will be pleased to know we are scheduling another migration webinar in early May.This time we hope to have an extended format to include a lot of Q&A. Anyone who registered/attended this webinar will be notified.Click!This tool can be used to check the following components of a XenApp farm:XML Service health:Verifies that the XML Service is able to respond to an XML, Web Interface, XenApp Plugin or if anyone is using a REALLY OLD client, the Program Neighborhood requestsVerifies that the XML Brokers are able to contact the data collectorVerify data collector health:Verifies data collector is able to provide a least-loaded server for the specified applicationVerifies the IMA Service on the data collector is functioning properlyAlso a couple of other checks… <<move down to next section>>Verifies the IMA Service can read the data collector's local host cacheVerifies that the IMA Service can read its dynamic store dataVerifies at least one server in the farm has this application publishedleast-loaded server health:Verifies Terminal Services on the least-loaded server.Verifies the Remote Procedure Call (RPC) Service on the least-loaded server.Supports XenApp 4.5/5.0. We ran a XenApp migration webinar a few weeks back with the EOL of of XenApp 4.5/5.0 on Windows Server 2003, so not surprised this is in the top 10.
Just to give you an idea of what some of these test settings do, I will cover a couple of them. More information can be found on the Knowledge Center.XML Least Loaded Server test: This test retrieves the least-loaded server from the zone data collector using the XML Service of the server specified in the Servers field.XML Ticketing test: This test retrieves a ticket from the server specified in the Servers field.RPC test: This test checks RPC health on the server specified in the Servers field. It also checks Terminal Services health (if selected) on the least-loaded server returned from the Least Loaded Server test. Lastly, it checks RPC health (if selected) on the least-loaded server returned from the Least Loaded Server test.
Information Technology is the business of problem solving. From Email to Web Services, it is our job to identify the pain points and provide solutions to business needs in a timely and efficient manner.When the technology itself is the source of the problem, understanding the issue must precede proposing a resolution. In Critical Situations, where speed to resolution is paramount, there are several important challenges that must be met before the problem can even be understood. These Challenges include:What Data do I collect?How do I collect it?Where do I get the tools to collect this data?What contextual information is required?CDT is designed to meet these challenges and facilitate the rapid collection of both debugging and contextual information in order to effectively diagnose, mitigate and resolve these situations.
If you’ve ever worked hardware support, a good, organized toolkit was paramount to efficiently examining, repairing, or replacing hardware components and insuring rapid remediation and minimizing server downtime. The CDT aims to do for Software what this toolkit can do for hardware.* The CDT is not an application, but rather a deployment project for some of the most useful and common debugging applications. * It is not a tool, but rather a suite of individual applications, tools and/or utilities. It addresses the pain of organizing, configuring and executing complex data collection scenarios by automating and simplifying these steps and emulating the look and feel of a windows application and installer.* Think of it as an agility platform for you the software support specialist, system admin or IT professional. This is your toolkit.
The installer is the core technology that facilitates the CDT Solution.While CDT * Requires that it is installed to the local System Drive, * No reboot is required and neither * are any prerequisites.Lastly, it is designed to work on already broken boxes, so that we can minimize the need to reboot and standby for the issue to reoccur.
The Packager is the part of CDT designed to take everything we’ve collected to far and organize it into a an easy to distribute package for Citrix and other Vendors, such as Microsoft, Adobe, Symantec and others, to analyze.When you click the “Data Packager” or “Stop Tracing” commands, the packager will initiate.*Here we see the results of the packager. In addition to the * standard tracing that might be required, the packager also collects:* An Export of the Windows Application & System Event logs in CSV format* A Qwinsta command output to a .txt file. (XenApp & Receiver setups )* A Routeprint command output to a .txt file* It also creates an .NFO file leveraging MSinfo32.exe (useful in PVS, XenDesktop and Receiver related cases, provides in-depth system details like NIC make model and driver, Video and Audio codec and much more.)The packager then compresses the contents of the Data folder and clears the contents of the Data folder to reduce file sprawl and disk space consumption.(The Autosupport and upload page presentation functionality can be toggled by typing this command at the RUN line in START menu. -> taaslaunchoff / taaslaunchon – on by default.)The Upload folder will open once packaging is complete and display a zip file with all your data inside giving you’re the opportunity to remove any files or scrub the contents prior to sending to Citrix Support for analysis. Lastly a browser window pointing to the Auto Support (TaaS) site will be launched for your convenience and speedy upload of the data.
KB articles provide important usage details and have cross links to readme’s for included and 3rd party downloadable tools. Blog provides insight to the conceptual design behind CDT like, What was Frank thinking? What pain points is he trying to address with CDT?If you cant make it to Synergy to see Frank introduce CDT and watch him demonstrate its incredible time saving capabilities. Stay tuned to Citrix TV for the Post show recording of Frank Marzullo’s sessions SUM404 & SYN404.
The XenDesktop site checker tool uses the XenDesktop Powershell SDK to enumerate XenDesktop 5 site brokers, services, hosts, assignments, catalogs, and provisioning tasks and schemes. It checks whether or not services are running and service instances are registered, and provides the ability to enable logging for each service. It also provides advanced management tasks that aren’t available in Desktop Studio, and provides detailed information about each component that it checks, and logs any script that is executed by the tool.CLICKThis tool has always been meant to help identify and rectify common XenDesktop site issues, while also giving the user an ‘under the covers’ look at a XenDesktop 5+ sites. While the tool still has the ability to identify and fix unregistered service instances in a XenDesktop site, we’ve been working to add other checks and fixes as we identify them in support.
To use this tool, run the executable file on a XenDesktop 5 member DDC. After the site is enumerated, click any node in the right-hand tree view to view details about the node. Right-clicking different types of nodes will provide actions that can be performed, such as testing service instances, starting/stopping services, enabling service logging, or changing a hosting unit’s preferred DDC.You can send a ping request to any service instance, so if you right-click on the service instance and if the utility did not detect an issue with an instance and the instances must be reset, then you can select Reset Service Instances to force a reset.Also as you can see All powershell scripts used by the tool are shown in the ‘Log Viewer’ pane. Very useful to have for independent testing of the tool, if required.
The HDX Monitor tool is used to validate the operation and configuration of key features of XenDesktop's and XenApp's HDX stack including the latest HDX MediaStream for Flash and HDX RealTime features. Consequently, this tool can also help you diagnose and troubleshoot HDX issues. For example, it detects when multimedia redirection is in use and if your endpoint device supports it. It also can tell you what audio codec you are using and its bitrate.Note: If you are running in a console or RDP session, HDX data is not available.Some of the HDX technologies covered by this tool are:Thinwire (Graphics)Direct 3D (Graphics)Media Stream (aka RAVE)FlashAudioUSB Devices…and many others.
How to use the HDX Monitor 3.0• Install this tool on any machine in the domain and enter the name of the VDA or XenApp Server for the target.• In a published desktop, you can start the tool inside the desktop session to see all the collected data of this desktop session. The tool will default the target system to the local computer or you may target another VDA in the domain.
Citrix printing. Lets face it, it can give you nightmares when it doesn’t work!. At least for me!Yes, Citrix has made strides with their Universal Printer Driver, and things have gotten much better, but printing can still cause you problems. I’m sure all of you are quietly nodding your head right now!!!Print Detective is an information gathering utility that can be used for troubleshooting problems related to print drivers.
It enumerates all printer drivers from the specified Windows machine, including driver specific information. It can also be used to delete specified print drivers and allows for log file capabilities and provides a command-line interface as well.
CDFControl is an event tracing controller/consumer, geared towards capturing Citrix Diagnostic Facility (CDF) trace messages that are output from the various Citrix tracing providers. Now in its second version, CDFControl offers new capabilities such as real-time trace viewing and performance data collection.CDFControl can be run on any Microsoft Windows computer that is Windows 2000 or newer.It must be run as a user with Administrative privileges for all features to be functional.On Microsoft Windows Vista and Windows 2008, with User Account Control (UAC) enabled, only trace capture requires elevation. See the user guide (included with the download package) for more details.
Lets assume we have a focus issue with a local application and Citrix seamless published application, not unusual.In order to troubleshoot the issue we will want to run a trace at the server console and client side.Console Side Tracing:Run the CDFControl on the console of the Citrix ServerSelect the Trace Category (in this case “Seamless”). It will enable the modules which are required.At Tools -> Options select ‘circular log’ and a logsize of 1Mb.Specify the path and name where you want to where the tracefile should be stored.Select Save and now it’s time to start the Tracing.Client Side tracing:Used this article to determine which modules should be traced on the client side: http://support.citrix.com/article/CTX124934In this example the modules “IcaClient_DriversVd_Vdtwi_CtlGuid”, “IcaClient_Engine_wfica_CtlGuid” and “IcaClient_UIWindows+Wfccomm_CtlGuid” are required for tracing.Copied the ”IcaClientTraceProviders.ctl” from the ICA Client directory, to the CDFControl directoryRun the CDFControl on the clientAt Tools ->Load CTL File and select the copied .ctl fileSelect the required modules in de CDFControl windowAt Tools -> Options select ‘circular log’ and a logsize of 1MbSpecify the path and name where you want to where the tracefile should be stored.Select Save and now it’s time to start the Tracing on the client sides.The tracefiles are encrypted and should be send to Citrix.
Users may experience a malfunctioning clipboard chain (when they cannot copy and paste anymore between a local application and a session or between different applications in a session). Click!This occurs when a third-party program incorrectly inserts itself in the Windows clipboard chain on a local workstation or within a session.Click!The RepairCBDChain utility temporarily restores clipboard functionality. The order is restored by moving the ICA client to the beginning of the clipboard chain. If the offending application is launched after this repair utility has restored the clipboard order, the clipboard functionality may become corrupted again.
Simply, launch the tool on the user machine. Your presented with this.Tool was developed by Dmitry Vostokov. Some of you may know Dmitry from his work on Memory Dump Analysis
"Sometimes setting up a NetScaler may seem an impossible. What do you do when you hit a roadblock at an early stage?In this session, Ronan will step through the most common issues you can experience at an early stage of your NetScaler deployment, and how to diagnose them using on-box tools.During this session you will learn:- Troubleshooting basic setup issues- Health Checks- Introducing redundancy and removing single point of failure- Logging – what happened historically"
At Citrix Services - we’re Citrix consultants, teachers and support engineers and we’re all about one thing: making sure you succeed.With our help, you’ll deploy high-performance, robust virtualization and networking projects, faster – with dramatically lower risk and higher return.The best Citrix architects and administrators are the ones who never stop learning – and Citrix Education is here to help you learn those skills.Citrix Consulting gives you direct access to our most experienced virtualization and networking experts.When it’s complex; when it’s mission-critical; when it’s big; That’s when Citrix consultants can really help.On your virtualization journey, you’ll want always-on support from people who really care about your success.There’s no better insurance for your Citrix investment than with Citrix Support.