Link to Free utilities compiled from VirtXpert Blog

Free utilities compiled from VirtXpert Blog

Hypervisors

  • VMware vSphere Hypervisor (ESXi):  The best platform, IMO, hopefully you can spring for at least Essentials plus
  • Citrix Xen Server:  Let’s face it, at a startup or SMB we may not be able to afford a commercial license, Xen provides Live Migration for free but good luck supporting it.
  • KVM:  Opensource platform, not for the faint of heart

Storage

  • Nexenta Community Edition:  Turn bare metal equipment into a fully functional NAS.  18TB limit on the community edition would be fine for most (all?) SMBs.
  • FreeNAS:  A very solid open source project with years off support and development behind it.
  • NAS4Free:  I haven’t used it, looks similar to FreeNAS without the name recognition, its still being maintained.
  • FalconStor Virtual SAN appliance:  Missing some features (snapshots and HA) but yet another storage solution.
  • QuadStor:  An open source application to turn a linux VM or physical machine into a very fully features storage appliance.  I really need to get this in my lab.  HA, Dedup, VAAI!
  • UberAlign:  A utility from Nicholas Weaver (@lynxbat) to help fix alignment issues for VMs.

Backup and Recovery

Monitoring

  • vCenter Operations Manager Foundation:  Another freebie when you purchase vSphere.  You paid for the awesomest hypervisor, why not take advantage of the tools you got included?
  • Veeam One:  You virtualized your infrastructure which is great, but you can’t just peak your head into the datacenter and see if everything is flashing green.  Veeam allows you to monitor your virtual infrastructure.
  • RVTools:  I haven’t had a chance to test this yet, lots of people swear by it.
  • Xangati:  Another handy tool to watch over your gear, free version is good for one server which, if you have one server, is actually great.
  • Nagios and Icinga:  The defacto open source monitoring tool and its fork.  Developers can’t get along forever.
  • Opsview:  Based on Nagios, provides a nicer GUI, though honestly its been 4 years since I used Nagios core.
  • op5 Monitor:  Another based on Nagios, open source code for unlimited monitoring and a free version with limited support for up to 20 devices.
  • Dell Foglight for Virtualization (Free):  A package of several free resources from Dell/Quest.  I am glad to see Dell is still maintaining the free products.  Vladan Seget has a nice write up here on the features.
  • Monitor.us:  Web based monitoring application, some limitations as all freemium products do.
  • ScaleXtreme:  Web based monitoring application, some limitations as all freemium products do.
  • vCheck:  A PoSH script by Alan Renouf that emails you status of your environment.
  • Netwrix VMware Change Reporter:  Similar to Alan’s script (not actually tested) but monitors changes to VM settings.
  • VirtualIQ Free:  For up to 2 hosts/5 CPU and 25 VM’s.
  • Indeni Health Check:  Free, light version of Indeni’s Dynamic Knowledge base.
  • IgniteFree:  Database monitoring tool from Confio for MS SQL and Oracle.  Wish there was a PostgreSQL version!
  • Event-O-Matic:  A PoSH/PowerCLI script generator that assists in the collection of specific log files from Luc Dekens
  • ExtraHop Discovery Edition:  Watch your apps for real time performance problems
  • SolarWindows Alert Central:  Helps you escalate alerts to certain individuals or groups versus sending to groups.
  • AlienVault OSSIM OpenSource:  Awful lot of free monitoring tools huh, this one attempts to correlate logs/monitoring from various open source tools to help you identify the cause of an issue.  This may also be the easiest Snort install you could do!
  • Tripwire SecureScan:  Free for up to 100 IP’s
  • Opvizor: Free edition supports a single cluster with up to 48 hours of data new2
  • Opvizor Snapwatcher: Free during beta, find and nuke snapshots, even corrupt ones new2
  • CloudPhysics:  Community edition of the powerful monitoring solution that backs alerts with aggregated data new2
  • DataDog:  Monitor up to 5 hosts with various dashboards.  Free version only keeps data for 1 day new2
  • VMTurbo Virtual Health Monitor:  Monitor your VM environment in real time new2

Logging

  • VMware Syslog Collector and Dump Collector:  Included in vCenter download – at some point there is going to be a problem/error and having your logs centrally collected will be nice.  Seems like busy work now but you will be glad when you need it.
  • Splunk:  Free version, as most do, has some limitations but as you grown you can remove these with a paid version.
  • GreyLog:  A new logging tool to the OS world, built on MongoDB.  Installation script from GitHub
  • Syslog-ng:  Moar syslog
  • nxlog:  You need a way to get your Windows logs to these cool syslog servers!
  • Nagios Log Monitor: Check out my write up here new2
  • ELK: A combination of opensource tools, check out the write up by Larry Smith Jr and his#vBrownBag presentation new2

Automation

  • VMware PowerCLI:  Free, included, have I mentioned all the stuff thats included with your paid vSphere license?  I think I did
  • vCenter Orchestrator:  Yea you guessed it, included when you buy
  • Windows PowerShell:  Installed with Windows – Its there, why click around when you can write a script (I am guilty of not doing this enough)
  • AutoIT:  Another popular scripting platform
  • Puppet:  I will start by saying I don’t know enough about it, I need to learn more, the Enterprise version is free for up to 10 nodes
  • Ansible:  Another configuration management tool, similar to Puppet yet so far easy to use.  Free for up to 10 nodes
  • Chef:  Another automation platform popular with the DevOps movement, a free and paid version like Puppet and Ansible
  • CloudBlot C2:  Claims to offer an easy to use IaaS tool, taking shots at vCAC.  Free for up to 100 VMs
  • ESX Deployment Appliance:  Free appliance to help automate the installation of ESX/ESXi
  • Ultimate Deployment Appliance:  Helps automate the installation of both deploy Windows and Linux
  • VMware WebCommander:  Part of the Fling labs, publish PowerShell and PowerCLI scripts via a self service portal to your users
  • Windows vCenter to VCSA Fling: Fling from VMware to migrate Window vCenter to the vCenter Virtual Appliance

Networking

  • Zen Loadbalancer:  Sometimes you need more than one server, web, View Connection etc but real load balancers get pricey
  • VyOS: The replacement for Vyatta new2
  • pfSense:  Another OS load balancer
  • Untangle:  Free firewall, really just several other OS projects packaged together but has a nice GUI and means you don’t have to package them together.
  • Smoothwall:  Yet another OS firewall
  • Endian :  Yet another OS firewall
  • PacketFence:  OpenSource Network Access Control
  • Sophos UTM Home:  Only really good for a home lab, but many of us have home labs so here’s a firewall
  • Open DayLight:  SDN is the future, why not get started here
  • Kemp Load Balancer: A seemingly free, yet full functional and optimized load balancer new2

VDI

Patching

  • Windows WSUS:  Think it goes without saying that Windows needs to be patched
  • RedHat Spacewalk:  Yes even Linux needs patches, you dont want a vulnerable Apache web server kicking around do you?
  • VMware Update Manager (VUM):  Something something, included vSphere something.  I wish VMware Go was still around, free and made patching a breeze

Training

  • VMware MyLearn:  Lots of great free classes from new features, DR training and even advanced topics such as vCloud Director.
  • VMware Learning:  An extension of MyLearn (IMO) with lots of free great videos, versus the slide/formal training style on MyLearn.
  • Local VMUG:  Great opportunity to meet new people and learn about the latest from the VMware community and vendors.
  • CodeAcademy:  Coding = automation.
  • #vBrownBag:  Community contributed podcasts primarily focused on VMware but also on various technology topics including OpenStack.
  • VMware Hands On Labs (HOL):  Free hands on training on various topics directly from VMware.
  • Virtual Design Master:  A free, live competition that puts aspiring architects skills to the test.  Currently in Season 2
  • Phil Wiffen’s TwistedEthics.com Free Training List:  Great list of free training resources Phil as curated

Community Contributed Certification Resources 

Misc

Collaboration

  • Slack:  A group messaging tool with search, paid versions retain more history
  • Asana:  A great task manager, share tasks with others as well
  • Trello:  A slightly different take on managing your todo items
  • MangoApps:  As with any free SaaS service, some limitations
  • SocialCast:  Free for up to 50 users with some limitations
  • Sharetronix:  Hey your still reading?  Cool, probably wondering what this is all about.  My other passion is collaboration, I hate email and “social” seems like a much better way to communicate
  • Zimbra OpenSource:  Open source edition of Zimbra for email and calendaring
Advertisements

Puppet Enterprise

More and more references to a configuration application called Puppet Enterprise. From what little I know about it, it is like SCCM but I may be way off base.  Free for 10 nodes.

This utility has me intrigued.

Puppet Homepage

“Puppet Enterprise helps you make rapid, repeatable changes and automatically enforce the consistency of systems and devices across physical and virtual machines, on premise or in the cloud.”

XenApp 6.0 Troubleshooting tools

Citrix Troubleshooting Tools

General
Advanced Access Control
Application Isolation Environment
Fatal Errors and Application Crashes

Citrix Access Gateway
Citrix Licensing

Citrix Password Manager

Clients

Content Redirection

CPU Utilization and Memory Optimization

Data Store Issues

Independent Management Architecture

Installation Manager

Installation/Migration

Load Balancing

Login/Authentication

NetScaler
Performance

Ports and Printing

Resource Manager

Seamless

Shadowing

Teros

Virtual IP (VIP)

Web Interface

General

-These tools can be used in most problem types.

What What it does More information
Citrix Utility AppEdit Simple GUI tool to allow quick management of published applications on a Citrix Server farm. Useful to quickly move and change published applications between servers to isolate a test environment or take a suspect server out of the possible causes. Can be used in conjunction with CHFarm to isolate a server.
Centralis Centinel Reboot Monitors connections to a Terminal Server and reboots it once all users are logged off or disconnected. Can also automatically run a script before reboot. This tool can be used to automate the implementation of a fix or registry hack and then reboot the server without causing any data loss for users.
CHFARM

-Available with the Citrix Presentation Server or XenApp 5 installation

Presentation Server Administration Guide – Appendix A

An administrator can use CHFARM to move a server from its current server farm. The server can be moved to an existing server farm or can be moved into a new farm which is created at the same time that the server is moved.

CHFARM can be used to isolate problems and prove whether the data store is involved, or causing the issue.

If the server you want to move provides information for a Resource Manager summary database, update the summary database before using chfarm.

CTX736659

Common Diagnostics Facility (CDF)

– Available with the Citrix Presentation Server/XenApp installation

The Common Diagnostic Facility (CDF) is a utility available as part of the Access Suite Console that allows administrators to collect traces for problem analysis/diagnosis.

Traces can be collected on all retail binaries from MetaFrame Presentation Server 3.0 onwards without the need for stopping and starting services or disrupting users. Traces can be started and stopped remotely through the Access Suite Console, and can be easily packaged and uploaded to Citrix Technical Support to assist in problem diagnosis and resolution.

Usage: Generally this tool is used on the advice of Citrix Technical Support in relation to a specific support case.

There are many articles on support.citrix.com detailing which “modules” to select for tracing particular types of problems.
[Document Not Found] CDF Viewer is a utility that allows you to view the output of a diagnostics log file that is created when a CDF trace session is completed using either the MetaFrame Access Suite Console or the CDF Viewer itself.
CDFControl CDFControl is a software debugging utility that captures Citrix Diagnostic Facility (CDF) trace output messages that are output from the various Citrix product modules. To get this tool you need to authenticate to our support site. Support.citrix.com
User Profile Deletion Utility Delprof is a command-line utility that you can use to delete user profiles on local or remote computers running Windows 2000, Windows XP, and Windows Server 2003. User profiles can grow large and may take up considerable disk space, especially if there are several users using one computer. Can be used in scenarios where there is only one user experiencing the problem or to clean local profiles off a Presentation Server.
WireShark Used to gather and analyze Network in several file formats. This tool can capture data “off the wire” or can read data saved in files from previous captures. Displayed data can be filtered to narrow down your search to traffic to and from a particular IP address. Understanding the protocol you are analyzing (such as TCP/IP) is a prerequisite to understanding the results of this tool. Example case studies: CTX110007
ExamDiff This tool is for comparing text files. Very useful for comparing good CDF traces with bad CDF traces. Capture two separate traces of any technical issue experience. Parse your output pointing to TMF files. Save the parsed output from CdfViewer to CSV format and use Examdiff to speed up the comparison of the output. Could also be used for comparing XML files for Web Interface setups.
fc.exe

– Native to Windows 2000, Windows 2003 and Windows 2008

Can be used to compare ntuser.dat files. fc /?
Process Monitor Permissions issues, such as user can not perform a task but an administrator can. Look for “File Not Found” or ”Permission Denied” on specific registry keys or values or search for .wav files for system beeps.

Example case studies: CTX109109

ICAPORT

-Installed with Presentation Server

Use icaport to query or change the TCP/IP port number used by the ICA protocol on the server. The default port number is 1494. The port number must be in the range of 0–65535 and must not conflict with other well-known port numbers. CTX101594
MessageHistory Simple GUI tool that traces window messages, like Spy++ or Winspector, but easier to use.

Consists of two executable files (32- and 64-bit). Simply start the exe, select via tick boxes which messages should be traced and click start.

Used to troubleshoot issues with GUI, Seamless, Clipboard, client, and so on.
MSGHOOK.EXE V4.0.1.0

– Presentation Server 4.x Server CD – Support – Debug: Windows 2003

MsgHook.exe (Message Hook) is an executable from Citrix Independent Management Architecture. MsgHook is a command line utility that displays all IMA traffic on a member server – Note: Execute msghook only if information is requested by a Citrix Technical Support representative or a Citrix engineer. When invoked, this command significantly reduces Presentation Server performance.
[Document Not Found] The PDBFinder Deluxe utility simplifies finding rare program database (PDB) or debug (DBG) files (symbols) or determine a hotfix corresponding to a given module name and date.
Process Explorer v15.23 Process Explorer shows information about which handles and DLLs processes have opened or loaded. Can be used for tracking down DLL-version problems or handle leaks, and provide insight into the way Windows and applications work. For Application Isolation Environment you can see if DLLs and Named Objects are virtualized.

For Virtual Memory Optimization issues, you can use Process explorer to highlight relocated DLLs.

PsExec v1.98 PsExec is a light-weight telnet-replacement that lets you execute processes on other systems, complete with full interactivity for console applications, without having to manually install client software. Can be used in combination with SystemDump.exe to execute a system dump remotely.
Qfarm (query farm)

– Installed with Presentation Server

Use this to display information about servers within an IMA based server farm. For Example: display the current load on each server with qfarm /load, list all currently active servers in the farm with qfarm /online. Presentation Server Administrator’s Guide – Appendix A
QRYClientIP Command line tool to query a session’s client IP. Used to allow one login script to process specific commands for specific IP addresses or IP segments.
QUERY PROCESS Displays information about processes running on a terminal server. You can use this command to find out which programs a specific user is running, and also which users are running a specific program.
QUERY SESSION Displays information about sessions on a terminal server. The list includes information not only about active sessions but about other sessions that the server runs.
QUERY TERMSERVER Displays a list of all terminal servers on the network.
QUERY USER Displays information about user sessions on a terminal server.
QueryDC

– Presentation Server installation CD – Support – Debug

The QueryDC utility is used to determine the data collector for a given zone. Without any parameters, Querydc defaults to the host server’s zone and returns the zone name and name of the current zone data collector.
[Document Not Found]

– Presentation Server installation CD – Support – Debug

Use this utility to display information about member servers in the farm. Executing queryhr with no parameters lists all servers in the farm. Queryhr obtains information from the local host cache.
Regshot This tool compares two registry snapshots. This tool can be used to troubleshoot issues with server configuration/custom registry settings
SHADOW Enables you to remotely control an active session of another user.
wbemtest.exe

– Native to Windows 2000, Windows 2003, and Windows 2008

Troubleshooting Issues that Involve WMI Data. This would mainly include issues with licensing, the Access Suite Console, Suite Monitoring and Alerting or the Presentation Server Management pack for MOM.

The tool can be used to test basic functionality of WMI providers.

BareTail(Pro), BareGrep(Pro) log file monitoring tool

file finding and text searching tool

Fiddler Fiddler is a HTTP Debugging Proxy which logs all HTTP traffic between your computer and the Internet. Fiddler allows you to inspect all HTTP Traffic, set breakpoints, and “fiddle” with incoming or outgoing data. Fiddler is designed to be much simpler than using NetMon or Achilles, and includes a simple but powerful JScript.NET event-based scripting subsystem.
MemProfiler .NET Memory Profiler is a powerful tool for finding memory leaks and optimizing the memory usage in programs written in C#, VB.NET or any other .NET Language.

It allows you to retrieve information about all instance allocations performed on the garbage collected heap (GC heap) and all instances that reside on the GC heap. The retrieved information is presented in real-time, both numerically and graphically. Using the new unmanaged resources tracker, information about unmanaged resources such as HBITMAP, HWND and unmanaged memory is also presented.

Microsoft Network Monitor (NetMon) A network protocol analyzer that captures network traffic for display. Useful when troubleshooting network issues related to performance, disconnects, etc.

Back to top

Application Isolation Environments

What What it does More information
AIERUN

– Available with the Citrix Presentation Server/XenApp installation

This is the command to launch an isolated application. Primarily for use in scripting environments. Aierun is an internal launcher used by Presentation Server during application launching.

Can be used to modify shortcuts in a desktop to launch an application in Isolation.

For troubleshooting purposes this could be used to test running the application in Application Isolation Environment without publishing it (remove a layer of complexity)Syntax Aierun AieName c:pathapp.exe

Presentation Server Administration Guide – Appendix A + Errata

Dependency Walker Dependency Walker (Depends) is a useful GUI tool for pointing to an executable on a system and listing all the DLLS required by that DLL, it will highlight any missing DLLs or conflicts. Dependency Walker (Depends) is a useful tool for trouble-shooting application errors, file registration errors, memory access violations, and invalid page faults.

Also useful for troubleshooting Application Isolation Environment issues.

Back to top

Fatal Errors and Application Crashes

– any fatal errors on servers, Dr Watson userdump

What What it does More information
How to Use the Citrix Symbol Server to Obtain Debug Symbols The Citrix Symbol Server can be used to obtain the symbol files necessary to debug Citrix products. The symbol server currently contains symbols for the CPS3.0 to XenApp5.0 products. You must use a debugging tool to connect to the Citrix Symbol Server
[Document Not Found] The Citrix DumpCheck tool helps to diagnose corrupt dumps. This tool is easier and quicker to use than launching WinDbg.exe and then loading the dump, and so on. Before sending dump files to another party, check that the file is not corrupt
[Document Not Found] The Citrix DumpCheck Utility helps diagnose corrupt dumps. This tool is easier and quicker to use than launching WinDbg.exe and then loading the dump, and so on. Unlike the Explorer extension described in CTX108825 – Citrix DumpCheck Explorer Extension version 1.4, it doesn’t require changing the environment. CTX108890
Dependency Walker Dependency Walker (Depends) is a useful GUI tool for pointing to an executable on a system and listing all the DLLS required by that DLL, it will highlight any missing DLLs or conflicts Dependency Walker (Depends) is a useful tool for trouble-shooting application errors, file registration errors, memory access violations, and invalid page faults.

Also useful for troubleshooting Application Isolation Environment issues.

Dr. Watson

– Available with the Windows 2003 installation

Collect the dump file when applications crash or suddenly exit. Enable Dr Watson by issuing the DrWtsn32.exe –I command at the command prompt. Further configuration options are available by issuing the command DrWtsn32.exe.

When enabled, Dr Watson generates a dump file and a log file in the Documents and SettingsAll UsersDocumentsDrWatson directory (by default). The log file can be used to determine basic information about the error, and the dump file can be analyzed with WinDbg.

Example case studies: CTX108312

LiveKD LiveKD allows you to run the KD and Windbg Microsoft kernel debuggers, which are part of the Debugging Tools for Windows package, locally on a live system. Execute all the debugger commands that work on crash dump files to look deep inside the system. See the Debugging Tools for Windows documentation and our book for information on how to explore a system with the kernel debuggers. Citrix Technical Support may request you to use LiveKD in certain circumstances
LoadOrder If you need to see the order in which the system loads device driver, this tool is for you! Can be useful in resolving device driver conflicts, exp when multiple drivers for the same device exist on the system.
[Document Not Found] The PDBFinder Deluxe utility simplifies finding rare program database (PDB) or debug (DBG) files (symbols) or determine a hotfix corresponding to a given module name and date.
[Document Not Found] The SystemDump GUI utility can force a server to generate a memory dump from the session or when a keyboard is not available or non-standard (fatal error).
UMDH UMDH dumps information about the heap allocation of a process and can be used to determine memory leaks. CTX104201
User Mode Process Dumper Version 8.1 You can use the Userdump.exe tool to generate a user dump of a process that shuts down with an exception or that stops responding (hangs). Before dumping a hanging process, it is helpful to take a screenshot of the Qslice.exe window. This output will assist in dump analysis. Microsoft Knowledge Base article 241215
WinDBG Use WinDbg to open crash dumps obtained from Dr. Watson, manually generated userdumps, or Windows crashes. Once the crash dump has finished loading, many commands can be used to provide helpful information about the error.

The command !analyze –v performs basic exception analysis, reporting the error that occurred and the module in which it occurred.

The command lmv can be used to show all of the modules loaded, including their full path and version information.

Search support.citrix.com for “WinDBG” to get a list of How To guides.
WinDBG 64-bit This is the Windows debugger for 64-bit platforms.

Back to top

Citrix Access Gateway

What What it does More information
[Document Not Found] Secure Access Client Remover is used to detect if any Secure Access Client modules or registry entries are left after uninstalling it. If the installation of the Secure Access client is suspected to cause a conflict with another application and has to be removed for testing.

CTX108092

Back to top

Citrix Licensing

What What it does More information
LMNEWLOG

– Installed on Citrix License Server

The lmnewlog utility switches the report log file by moving the existing report log information to a new file, then starting a new report log with the original report log file name. Advanced Concepts Guide
LMSWITCH

– Installed on Citrix License Server

The lmswitch utility switches the debug log file written by the Citrix vendor daemon by closing the existing debug log for that vendor daemon and starting a new debug log for that vendor daemon with a new file name. Advanced Concepts Guide

Back to top

Citrix Password Manager

What What it does More information
CTXDOMAINPREP.EXE

– Password Manager CD – Tools folder: Password Manager 4.0

A domain administrator can use the Active Directory Setup for the MetaFrame Password Manager utility to set the correct permissions for these objects. This tool is a utility, run from a command line, that sets the correct permissions for these objects on
CTXFILESYNCCLEAN.EXE

– Password Manager CD – Tools folder: Password Manager 4.0

CtxFileSyncClean.exe removes any folders in your central store that point to objects that were deleted. This ensures that your environment contains the most up-to-date information.
CTXFILESYNCPREP.EXE

– Password Manager CD – Tools folder: Password Manager 4.0

Delegating administration of a Citrix Password Manager central store to a group or user account that is not a domain administrator. By default, no permissions are allowed to propagate from root share to the child folders CentralStoreRoot and People.
CTXNWFILESYNCPREP.EXE

– Password Manager CD – Tools folder: Password Manager 4.0

If you plan to use a Novell NetWare folder as your central store, you must create (while logged on with supervisor rights) the shared folder and a folder named People inside the shared folder.
CTXSCHEMAPREP.EXE

– Password Manager CD – Tools folder: Password Manager 4.0

Delegating administration of a Citrix Password Manager central store to a group or user account that is not a domain administrator. The schema preparation tool must be run by a member of the Schema Administrators group for the target forest.

Back to top

Clients

What What it does More information
CHANGE CLIENT

– Available with the Citrix Presentation Server/XenApp installation.

Presentation Server Administration Guide – Appendix A

“Change client” changes the current disk drive, COM port and LPT port mapping settings for a client device.

“Change Client” or “CHGCDM” command

Can be used to query or refresh client setting or printer settings. May correct settings for a timing issue at connect time or clients reconnecting from a new device.
FTACLN The FTACLN utility can be used to clean up the file type associations in the Windows Registry on the device running the Program Neighborhood Agent.

After uninstalling the Program Neighborhood Agent Version 6.3x from a client device and restarting, some of the file types associated with the PNAgent can remain on the client device. This is evident, for example, when you double-click a .txt file in Explorer and the “Executable Cannot be Found” Windows message appears.

CTX101594

Can also be found on:

Presentation Server 4.x Server CD – Support – Debug

MessageHistory Simple GUI tool that traces window messages, like Spy++ or Winspector, but easier to use.

Consists of two executable files (32- and 64-bit). Simply start the exe, select via tick boxes which messages should be traced and click start.

Used to troubleshoot issues with GUI, Seamless, Clipboard, client, and so on.
MSI Installation Log

– Available with the Windows installation

The Microsoft Windows Installer Tool can generate a log of an MSI-based installation.

To enable this the MSI file must be installed using the MSEXEC command from the command prompt.

Microsoft Knowledge Base article227091
Repair Clipboard Chain 2.0.1 The RepairCBDChain utility temporarily restores clipboard functionality.

Run the RepairCBDChain utility on your workstation and/or inside the session desktop

[Document Not Found] The RepairCBDChain64 utility for x64 platforms.
TWCONFIG

– Installed with Presentation Server

Use twconfig to configure ICA display settings that affect graphics performance for clients. Presentation Server Administration Guide – Appendix A
WindowHistory 4.0 for 32-bit platforms The WindowHistory utility complements Spy++ and other tools. It constantly monitors windows in the system (session) and records all changes made to it. Information about windows can then be saved for further analysis.
[Document Not Found] This is the version of the WindowHistory tool that works on ARM processors.
WindowHistory64 4.0 for x64 Platforms This is the version of the WindowHistory tool that works on 64-bit platforms.
Winspector Winspector is a freeware that can be used instead of Spy++ with mostly the same functionality.

It captures all messages (keyboard input, mouse movements/click, changes in the window size and location, and so on) sent to a particular application for identifying issues with ICA clients, compare results inside a session and outside a session, keyboard mapping issues, and so on.

Useful for troubleshooting some Seamless Windows issues and allows distinguishing of the Window Class Name, which is then used to set an exception flag.

CTX101644

Back to top

Content Redirection

What What it does More information
FTACLN The FTACLN utility can be used to clean up the file type associations in the Windows Registry on the device running the Program Neighborhood Agent.

After uninstalling the Program Neighborhood Agent Version 6.3x from a client device and restarting, some of the file types associated with the Program Neighborhood Agent can remain on the client device. This is evident, for example, when you double-click a .txt file in Explorer and the “Executable Cannot be Found” Windows message appears.

CTX101594

Can also be found on:

Presentation Server 4.x Server CD – Support – Debug

Back to top

CPU Utilization and Memory Optimization

What What it does More information
ADSCleaner 2.0 Citrix Memory Optimization works by creating Alternate Data Streams on each of the optimized files. Disabling the feature or adding a file to the exclusion list does not remove the Alternate Data Stream. The ADSCleaner.exe utility lists and optionally deletes alternative data streams created by Citrix memory optimization code.
[Document Not Found] Citrix Memory Optimization works by creating Alternate Data Streams on each of the optimized files. Disabling the feature or adding a file to the exclusion list does not remove the Alternate Data Stream. The ADSCleaner64.exe utility lists and optionally deletes alternative data streams created by Citrix memory optimization code on x64 platforms.

Back to top

Data Store Issues

– database corrupted, database migration issue, database connection issues

What What it does More information
DSCHECK – XenApp Data Store Checker Tool Commands DSCheck provides a way to perform validation checks on a server farm’s data store. Results are displayed on the console and written to the event log. The /clean option deletes inconsistent records. Citrix recommends that you back up the data store before using the /clean option. Further information on using this tool can be found in Citrix Knowledge Base article CTX124406
DSMaint

– Available with the Citrix Presentation Server/XenApp installation

DSMAINT is used to configure the IMA data store database for a server farm. When using this command, user names and passwords may be case-sensitive, depending on the database product being used and the operating system it runs on.
DSView

– Available on the Support folder of the Server CD

DSView can be used when you need to look at the value or find a specific record in the data store or the local host cache. DSView works by capturing the data from the Binary Large Object (BLOB) and placing it in an order so it can be interpreted. CTX106232
fc.exe

– Native to Windows 2000, Windows 2003 and Windows 2008

Can be used to compare ntuser.dat files fc /?
[Document Not Found] This script will terminate all IMA connections to an SQL 2000 database. CTX106684
[Document Not Found]

– Presentation Server/XenApp installation CD – Support – Debug

Use this utility to display information about member servers in the farm. Executing queryhr with no parameters lists all servers in the farm. Queryhr obtains information from the local host cache.

Back to top

Independent Management Architecture (IMA)

What What it does More information
[Document Not Found] This script will terminate all IMA connections to an SQL 2000 database. CTX106684
IMAPORT

– Installed with Presentation Server

Use imaport to query, set or reset the IMA – TCP/IP port. Important: If you change port number 2513 on the first server in the farm on which you install MetaFrame Presentation Server, you cannot join additional servers to the server farm. Administrators Guide – Appendix A

Back to top

Installation/Migration

– any issue related to installation or migration of Presentation Server, unable to install/uninstall

What What it does More information
MSI Installation Log

– Available with the Windows installation

The Microsoft Windows Installer Tool can generate a log of an MSI-based installation.

To enable this the MSI file must be installed using the MSEXEC command from the command prompt.

Microsoft Knowledge Base article 227091
Wilogutl.exe

– Available with Microsoft Platform SDK

Wilogutl.exe assists the analysis of log files from a Windows Installer installation, and it displays suggested solutions to errors that are found in a log file.

Back to top

Load Balancing

What What it does More information
[Document Not Found] Because all of the dynamic information is stored in tables in the data collector’s physical RAM, this command-line utility is provided to query the current information on the local zone data collector. You can use QueryDS to determine which servers are currently available in a farm. It retrieves all information from the tables stored on the local zone data collector. For example, the PN_Table contains information about all available servers that are accepting Program Neighborhood connections.

Back to top

Login/Authentication

– any authentication issue such as Single Sign On, smart card authentication, Novell authentication

What What it does More information
ACRCFG

– Available with the Citrix Presentation Server/XenApp installation

Use ACRCFG to configure or enable automatic client reconnection settings for a server or a server farm.

acrcfg [/server:servername | /farm][/query | /q]

acrcfg /?

Troubleshoot client disconnects or not getting automatically reconnected.
AUDITLOG

– Available with the Citrix Presentation Server/XenApp installation

Auditlog generates reports of logon/logoff activity for a server based on the Windows NT Server security event log. To use auditlog, you must first enable logon/logoff accounting. You can direct the auditlog output to a file. Presentation Server Administration Guide – Appendix A
Limit Login The application adds the ability to limit concurrent user logins and to keep track of all login information in an Active Directory domain. LimitLogin capabilities include limiting the number of logins per user from any machine in the domain (including Terminal Server sessions), displaying the login information of any user in the domain according to specific criteria.

While the main purpose of LimitLogin is to enforce concurrent login quotas, it can also be used purely as a login data capture solution that lets you manage your Active Directory environment more effectively.

LogonSessions v1.21 When you want to see who is authenticated and is running a session on a server. It lists the currently active logon sessions and the processes running in each session. It lists the session ID, name of the user, the authentication type, SID, Logon Server and Domain of the user.
Netdiag Netdiag.exe is a command-line tool that you can use to test the network connectivity of the computer. Netdiag.exe performs a series of tests to determine the state and functionality of your network client computer. You can use the results of these tests, and the network status information that is provided by Netdiag.exe, to isolate network and connectivity problems on your Windows based workstation or server. Can be used for troubleshooting multihomed servers or client latency.
Nltest.exe Nltest.exe is a very powerful command-line utility that can be used to test trust relationships and the state of domain controller replication in a Windows NT domain. Can be used for multi domain farms where you suspect trusts to be an issue, when publishing applications to users or using Advanced Access Control.
MedEvac 2.5 The MedEvac tool is utilized to run checks against a Presentation Server farm to verify environment health. CTX108311
QueryDC The QueryDC utility is used to determine the data collector for a given zone. Without any parameters, Querydc defaults to the host server’s zone and returns the zone name and name of the current zone data collector.
[Document Not Found] Because all of the dynamic information is stored in tables in the data collector’s physical RAM, this command-line utility is provided to query the current information on the local zone data collector. You can use QueryDS to determine which servers are currently available in a farm. It retrieves all information from the tables stored on the local zone data collector. For example, the PN_Table contains information about all available servers that are accepting Program Neighborhood connections.
User Profile Hive Cleanup Service UPH Clean fixes issues with “stuck” user profiles. It kills any processes that have hooks open to the user’s profile after the user initiates the logoff process.

Issues with this are commonly encountered with roaming user profiles.

Microsoft Knowledge Base article 837115
Userenv.log

– Available with the Windows installation

The Userenv.log file is used for capturing logging and debugging information regarding the user profile and the Windows system policy processes, including registry accesses, during the logon process. This can be helpful for troubleshooting issues that occur during the logon to a Citrix server.

Because of the large amount of data logged, it should be enabled on an isolated server when possible.

Microsoft Knowledge Base article 221833

Back to top

NetScaler

What What it does More information
NSCONMSG

– Located in /netscaler/ on all NetScaler systems

Executed from SHELL in a NetScaler SSH session. Examples of the command are: (Note the capital K as a command switch!!)

nsconmsg -K /var/nslog/newnslog -d consmsg gives you all messages sent to the console during the timeline covered by the newnslog

nsconmsg -K /var/nslog/newnslog -d ? lists other arguments which can be used to gather more information.
SHOW

– Part of the NetScaler CLI, all versions of the NetScaler operating system

Run this command to view current configuration information. It extracts a snapshot of information from the NetScaler Kernel. Use this command if you are not familiar with the configuration or environment in which the NetScaler sits.

Back to top

Performance

– ICA session slow, server slow down, ICA session hangs, application hangs, server hangs

What What it does More information
[Document Not Found] The Automatic Farm Tuner utility is designed to tweak the advanced registry setting on the data collectors in a large farm and tune the data collectors to adapt to a large farm environment. With this utility in place, all manual performance tweaking on the data collectors can be automatically set. CTX108456
[Document Not Found] “Citrix Connection Test Tool” provides various connection methods for scalability test and other tests which require a number of sessions to be established. The tool enables testers to establish as many numbers of ICA sessions as they want by creating or duplicating session settings on Citrix Presentation Server Client. Useful for loading the server for trying to identify performance issues.
[Document Not Found] The Citrix Server Test Kit (CSTK) version 2.1 is an automated tool that can be used by administrators to configure and run various user load combinations. Can be used for loading servers for performance testing.

CTX091649

Netdiag Netdiag.exe is a command-line tool that you can use to test the network connectivity of the computer. Netdiag.exe performs a series of tests to determine the state and functionality of your network client computer. You can use the results of these tests, and the network status information that is provided by Netdiag.exe, to isolate network and connectivity problems on your Windows based workstation or server. Can be used for troubleshooting multihomed servers or client latency.
TWCONFIG

– Installed with Presentation Server/XenApp

Use twconfig to configure ICA display settings that affect graphics performance for clients.
Userdump You can use the Userdump.exe tool to generate a user dump of a process that shuts down with an exception or that stops responding (hangs). Before dumping a hanging process, it is helpful to take a screenshot of the Qslice.exe window. This output will assist in dump analysis. Microsoft Knowledge Base article 241215
WinDBG Use WinDbg to open crash dumps obtained from Dr. Watson, manually generated userdumps, or Windows crashes. Once the crash dump has finished loading, many commands can be used to provide helpful information about the error.

The command !analyze –v performs basic exception analysis, reporting the error that occurred and the module in which it occurred.

The command lmv can be used to show all of the modules loaded, including their full path and version information.

Search support.citrix.com for “WinDBG” to get a list of How To guides.
WinDBG 64-bit This is the Windows debugger for 64-bit platforms.

Back to top

Ports and Printing

– any cases related to port mapping and printing, printer autocreation, printer drivers, replications, and spooler issues/crashes

What What it does More information
StressPrinters 1.3.2 for 32-bit and 64-bit Platforms Use to test if a driver is suitable for multi-user environments. It should be configured with multiple instances simultaneously, simulating multiple sessions autocreating printers using the same print driver. This allows an admin to ensure a driver does not cause a fatal error on their server and autocreates successfully.
Print Detective Enumerates print drivers on local and remote machines. Displays driver details, provider, supporting files, and so on. Great for determining non-native print drivers and quickly removing them.
PRINTUI Built-in utility to perform many printing related tasks including pushing print drivers, adding and deleting printers, and more. PRINTUI Reference
CHANGE CLIENT

– Available with the Citrix Presentation Server/XenApp installation.

Change client changes the current disk drive, COM port, and LPT port mapping settings for a client device.

“Change Client” or “CHGCDM” command

Can be used to query or refresh client setting or printer settings. May correct settings for a timing issue at connect time or clients reconnecting from a new device.
Driver Deleter A utility for cleaning the registry after removing printer drivers.

The Driver Deleter utility is used to remove old driver files and registry entries before installing new drivers. After running this utility you must reboot your server for the effects to take place.

[Document Not Found] The ListPrinterDrivers tool allows you to list all printer drivers in a farm.
Portmon for Windows v3.03 Displays serial and parallel port activity on a system with the capability to filter the output for better overview. Useful to troubleshoot port problems, for example, using a device on the client’s serial port from a published application. Run the tool in the session and on the client and see which actual commands are being sent to the port.

Back to top

Resource Manager

What What it does More information
TSSHUTDN Enables an administrator to remotely shut down or reboot a terminal server. You can also choose to power off the server if the computer supports software control of AC power.

Back to top

Seamless

– any issue related to applications in Seamless only

What What it does More information
MessageHistory Simple GUI tool that traces window messages, like Spy++, but easier to use.

Consists of two executable files (32- and 64-bit). Simply start the exe, select via tick boxes which messages should be traced and click start.

Used to troubleshoot issues with GUI, Seamless, Clipboard, client, and so on.
WindowHistory 4.0 for 32-bit platforms The WindowHistory utility complements Spy++ and other tools. It constantly monitors windows in the system (session) and records all changes made to it. Information about windows can then be saved for further analysis.
[Document Not Found] This is the version of the WindowHistory tool that works on ARM processors.
WindowHistory64 4.0 for x64 Platforms This is the version of the WindowHistory tool that works on 64-bit platforms.
Winspector Winspector is a freeware that can be used instead of Spy++ with pretty much the same functionality.

It captures all messages (keyboard input, mouse movements/click, changes in the window size and location, and so on) sent to a particular application for identifying issues with ICA clients, compare results inside a session and outside a session, keyboard mapping issues, and so on.

Useful for troubleshooting some Seamless Windows issues and allows distinguishing of the Window Class Name, which is then used to set an exception flag.

CTX101644

Back to top

Shadowing

What What it does More information
SHADOW Enables you to remotely control an active session of another user.

Back to top

Virtual IP (VIP)

What What it does More information
QRYClientIP Command line tool to query a session’s client IP. Used to allow one login script to process specific commands for specific IP addresses or IP segments.

Back to top

Web Interface

What What it does More information
CTXXMLSS

– Available with the Citrix Presentation Server/XenApp installation

By default, the Citrix XML Service shares a port with IIS. The CTXXMLSS command can be used to change to a different port, or revert back to sharing with IIS CTX104063

Can be used to ensure that port conflicts are not seen on Presentation Servers with IIS. Try changing the XML port to a different port to see if problem persists.

Back to top