April, 2013 Troubleshooting Excalibur – XenDesktop7 Mick Glover Worldwide Support Readiness

© 2013 Citrix | Confidential – Do Not Distribute Tracing & Logging Very little has changed… Out of the box…  CDF Tracing enabled for all services  Clear text logging disabled for all services Configured through.NET service config files  One for each controller service

© 2013 Citrix | Confidential – Do Not Distribute.NET Service Logging Available logging mechanisms Managed under the section of each.Config file "LogToCDF" - if present and set to 1, will log to CDF using the supplied CDF trace module  Present and set to 1 for all Controller services "LogFileName" - if present, will log to the specified file name  "OverwriteLogFile" - if present, will overwrite existing log file if it already exists Note: More than one mechanism can be specified…

© 2013 Citrix | Confidential – Do Not Distribute.Net Service Logging - Manual Configuration Enabling clear text logging - Example 1.Edit WorkStationAgent.exe.Config (Now called BrokerAgent.exe.Config) 2.Add the lines in Green below to enable and control clear text logging 3.Set appropriate NTFS permissions 4.Restart Citrix Desktop Service (BrokerAgent.exe.Config)

© 2013 Citrix | Confidential – Do Not Distribute.Net Service Logging - Auto Configuration Logging Enabler (Excalibur version to be confirmed) Latest version: v3  Log file location  Remote Logging Tool runs on XenDesktop DC and VDA but is only aware of the XD5 legacy services so provides limited functionality Full Supportability ETA with Excalibur needs to be confirmed with Sakthi Ganesh (Lead Escalation Engineer)  Support communication to follow…

© 2013 Citrix | Confidential – Do Not Distribute Making the process easier… Logging Enabler v3.0 (Controller and VDA)

© 2013 Citrix | Confidential – Do Not Distribute New Services = New.Config files 1/2 Control CDF\Clear Text Logging Environment Test Service  Citrix.EnvTest.exe.Config Configuration Logging Service  Citrix.ConfigurationLogging.exe.Config Monitor Service  Citrix.Monitor.exe.Config

© 2013 Citrix | Confidential – Do Not Distribute New Services = New.Config files 2/2 Control CDF\Clear Text Logging Storefront Service  Citrix.Storefront.exe.Config Delegated Admin Service  Citrix.DelegatedAdmin.exe.Config Citrix Desktop Service  BrokerAgent.exe.Config

© 2013 Citrix | Confidential – Do Not Distribute © 2012 Citrix | Confidential – Do Not Distribute Service config logging reference - XD5

© 2013 Citrix | Confidential – Do Not Distribute © 2012 Citrix | Confidential – Do Not Distribute Service config logging reference - XD7

© 2013 Citrix | Confidential – Do Not Distribute PorticaService Logging (picaSvc2.exe) Logging Mechanisms CDF  Disabled by default Clear text  Disabled by default Create PorticaConfig.XML and place under the following directory  C:\Program Files\citrix\ICAService\XML  XML directory must be manually created Note: Once PorticaConfig.xml has been created and placed in the correct directory, it must be configured…

© 2013 Citrix | Confidential – Do Not Distribute Configuring PorticaConfig.XML LogFile  Level 0,1,5,9 supported  0 = disabled CdfTrace  Level 1,5,9 supported FunctionTrace  Values 1,5,9 supported  Master flow control < 5 5 5

© 2013 Citrix | Confidential – Do Not Distribute PortICA clear text logs Restart PorticaService Logs files are automatically saved to the following locations  XP C:\Documents and Settings\LocalService\Local Settings\Temp  Win7 C:\Windows\ServiceProfiles\LocalSer vice\AppData\Local\Temp

© 2013 Citrix | Confidential – Do Not Distribute Validating service status Remaining Legacy Services Get-BrokerServiceStatus (Broker Service) Get-ConfigServiceStatus (Configuration Service) Get-HypServiceStatus (Host Service) Get-AcctServiceStatus (AD Identity Service) Get-ProvServiceStatus (Machine Creation Service) Get-LicServiceStatus (License Service)

© 2013 Citrix | Confidential – Do Not Distribute Validating service status New Services Get-EnvTestServiceStatus (Environment Test Service) Get-LogServiceStatus (Configuration Logging Service) Get-MonitorDBConnection (Monitor Service) Get-SFServiceStatus (Storefront Service) Get-AdminServiceStatus (Delegated Admin Service)

© 2013 Citrix | Confidential – Do Not Distribute Service status return values StatusMeaning OKThe broker is connected to a database that is valid, and the service is running. DBUnconfiguredThe broker does not have a database connection configured DBRejectedConnectionThe database rejected the logon from the Broker Service. This may be caused by bad credentials, or the database not being installed. InvalidDBConfiguredThe database schema is missing (possibly just the stored procedures in it). DBNotFoundThe specified database could not be located with the configured connection string. DBMissingOptionalFeatureThe broker is connected to a database that is valid, but it does not have the full functionality required for optimal performance. Upgrading the database is advisable. DBMissingMandatoryFeature The broker is connected to a database that is valid, but it does not have the full functionality required so the broker cannot function. Upgrading the database is required.

© 2013 Citrix | Confidential – Do Not Distribute Service status return values (cont...) StatusMeaning DBNewerVersionThanServiceThe broker is too old to use the database. A newer version is required. DBOlderVersionThanServiceThe database is too old for the Broker Service. Upgrade the database. DBVersionChangeInProgressA database schema upgrade is in progress. PendingFailureConnectivity between the Broker Service and the database has been lost. This may be a transitory network error, but may indicate a loss of connectivity that requires administrator intervention. FailedConnectivity between the broker and the database has been lost for an extended period of time, or has failed due to a configuration problem. The broker service cannot operate while its connection to the database is unavailable. UnknownThe Service's status cannot be determined

© 2013 Citrix | Confidential – Do Not Distribute PowerShell Ref: Load XenDesktop Snapins  asnp citrix* (alias for Add-PSSnapin) Return all available XenDesktop cmdlets  Get-command –module citrix.* Verify ability to run scripts  Get-ExecutionPolicy Enable the running of PoSH scripts  Set-ExecutionPolicy Unrestricted

© 2013 Citrix | Confidential – Do Not Distribute New Built-in Supportability Features\Tools XenDesktop 7 Configuration Tests Learn More Links Diagnostic Reporting & Export User Reporting and TAAS link-up Configuration Logging Reporting Director integrated EdgeSight functionality

© 2013 Citrix | Confidential – Do Not Distribute Configuration Tests Built-in functionality\Citrix Studio Functionality introduced through the Environment Test Service Includes report functionality  Success  Warnings  Failures Skip tests option included

© 2013 Citrix | Confidential – Do Not Distribute Configuration Tests Testing Reports.HTML format Provides guidance & Reduces need to hunt for configuration errors…

© 2013 Citrix | Confidential – Do Not Distribute

Configuration Tests Anytime Testing Quick launch Tab allows anytime testing of the following  Site Configuration  Machine Catalogs  Delivery Groups

© 2013 Citrix | Confidential – Do Not Distribute Learn more links Built-in functionality\Citrix Studio Active links will auto launch default browser and take admin to relevant documentation for specific task to be carried out Available throughout Studio configuration wizards…

© 2013 Citrix | Confidential – Do Not Distribute Diagnostic Reporting & Export features New Supportability Features\Tools

© 2013 Citrix | Confidential – Do Not Distribute User Reporting and TAAS link-up New Supportability Features\Tools

© 2013 Citrix | Confidential – Do Not Distribute

Configuration Logging Reporting

© 2013 Citrix | Confidential – Do Not Distribute Desktop Director Reset Profile management profile function Reset PvD VHD (mirror of c:\ (Application data)

© 2013 Citrix | Confidential – Do Not Distribute Excalibur Ready Tools TAAS Team Scout  XDPing  CDF Control  XDDBDIag All tools above are part of the current public version of Scout which is Excalibur Ready  New version of Scout released the same week as Excalibur with some added tweaks All KB articles will be updated for RTW (26 th June)

© 2013 Citrix | Confidential – Do Not Distribute XDDbDiag v4.x Part of Scout No Separate Download Contact: Rene Alfonso (Director, product Dev - TAAS) for more information

© 2013 Citrix | Confidential – Do Not Distribute Other well known Support tools Excalibur supportability still to be confirmed… XD Site Checker CDFMonitor CDFMarker CDFCheck HDX Monitor

Work better. Live better.