1 / 60

SUM302: Implementing and troubleshooting Storefront and Receiver for Windows

SUM302: Implementing and troubleshooting Storefront and Receiver for Windows. Frank Hammer. Principal Escalation Engineer. October, 2012. Agenda. About Storefront Services Requirements and Installation Deployment and Configuration Customization Troubleshooting Resources Questions.

hart
Télécharger la présentation

SUM302: Implementing and troubleshooting Storefront and Receiver for Windows

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. SUM302: Implementing and troubleshooting Storefront and Receiver for Windows Frank Hammer Principal Escalation Engineer October, 2012

  2. Agenda • About Storefront Services • Requirements and Installation • Deployment and Configuration • Customization • Troubleshooting • Resources • Questions

  3. About Storefront Services

  4. About Storefront Services • Included in CloudGateway Express 2.0 and Enterprise 2.0 XenDesktop Windows VDI Windows Apps Enterprise App Store Receiver Storefront Services FREE! XenApp for all XenApp & XenDesktop customers

  5. CloudGateway Enterprise XenDesktop • Adds Controls for Mobile, Data & SaaS Apps Enterprise App Store Windows VDI Windows Apps Access Gateway Web/SaaS Mobile Receiver Storefront Services XenApp Data

  6. Why Storefront Services? • Formerly called Delivery Services and it evolved to Storefront Service 1.2 currently • Will replace Web Interface in the future, as Web Interface is End of Life in June 2015 • J# 2.0 will be EOL 2015 by Microsoft • 10 Year old

  7. Why Storefront Services?

  8. Old way to access content… Web Interface PN Agent Dazzle

  9. Same experience on any device… Windows PC Windows self-service (formerly Dazzle) Android Mac laptop

  10. Installation Requirements

  11. Storefront Service Requirements Supported only on Windows 2008 R2 SP1 Internet Information Services (IIS) 7.5 SQL Database SQL 2008 R2 (Express/Enterprise) SQL 2012 (Express) .NET Framework 3.5 SP1 No need for J# 2.0 anymore...

  12. Storefront Service Installation

  13. Storefront Service Installation

  14. Storefront Service Installation - Logs •  C:\Program Files\Citrix\Receiver Storefront\Admin\logs DbgView  www.sysinternals.com

  15. Storefront Service Installation • Can happily co-exist with Web Interface on the same machine • No need for new hardware

  16. Deployment and Configuration

  17. Single Server Deployment Internet DMZ LAN Access Gateway (optional) StoreFront Services XenApp/ XenDesktop

  18. Multiple Server Deployment StoreFront Services (Primary) NetScaler XenApp/ XenDesktop StoreFront Services (Secondary) Internet DMZ LAN

  19. Multiple Server Deployment - Checklist • Minimum of 2 servers setup • Prepare remote database by using scripts (Check E-Docs!!) • Make sure to have a configured hardware (or software) load balancer • Install StoreFront Services on primary server and configure Authentication, Store and Receiver for Web • Install StoreFront Services on secondary server and join it to the Server Group • (Optional) Preferably use a wildcard certificate for all devices

  20. Multiple Server Group Deployment – (Primary Server) Single server deployment Multi-server deployment Join a pre-built deployment

  21. Multiple Server Group Deployment – (Primary Server) • Enter the hostname (FQDN) of the load balancer • Enter the Database server IP, hostname or FQDN • Enter the Database name

  22. Multiple Server Group Deployment – (Secondary Server) Single server deployment Multi-server deployment Join a pre-built deployment

  23. Multiple Server Group Deployment – (Secondary Server) • From Secondary Server…

  24. Multiple Server Group Deployment – (Secondary Server) • From Primary Server…

  25. Multiple Server Group Deployment – (Secondary Server) • From Secondary Server…

  26. Multiple Server Group Deployment – (Secondary Server) • From Primary Server…

  27. Multiple Server Group Deployment – (Secondary Server) • From Primary Server…

  28. Multiple Server Group Deployment – (Secondary Server) • From Primary Server…

  29. Multiple Server Group Deployment – (Secondary Server) • From Primary Server…

  30. Multiple Server Group Deployment – (Secondary Server) • Once “Propagate Changes” is complete check the following on Secondary Server: • Verify Authentication Service URL • Verify Stores • Verify Receiver for Web • (Optional) – Verify Gateways

  31. Storefront Services Architecture Storefront Services Tier XenApp Farms 1 Browser XML Service Adaptors Web Receiver List My Apps XenDesktop Sites Launch App Future Citrix Adaptors Store Services 3rd Party Web App Controller Internal Web Apps List All Apps Thin Clients 3rd Party Adaptors Subscribe SaaS Apps Access Gateway “Value Adds” Password Mobile Devices Mobile Apps Kerberos Authentication Service Smartcard ? Extension MAC & Windows ... 3rd Party Apps Update Service (Merchandising Server) 2 Other Services

  32. Store Services 1 • Uses REST Services* • XML messages over HTTP(S) protocol • Authentication via a header token • Root service is ‘Resources’ • This then references Images, Windows Icons etc. XML Service Adaptors List My Apps Launch App Future Citrix Adaptors Store Services List All Apps 3rd Party Adaptors Subscribe

  33. Authentication Service • Based on WS-Federation* • Allows Single Sign On • Between different StoreFront services • To other Citrix services (other boxes) • Extends in many directions • Federation-In (SAML) • Access Gateway SSO • SSO to App Controller (and beyond) Password Kerberos Authentication Service Smartcard Extension 2

  34. Storefront Services - Communication Flow Active Directory Server Data Collector Server XML Server Client Device StoreFront Services server XenApp Server

  35. Storefront Services - Communication Flow Active Directory Server Data Collector Server XML Server Client Device StoreFront Services server XenApp Server

  36. Customization

  37. Config file differences between WI and StoreFront

  38. Customization • No UI customization via Console • CSS customization • contrib\custom.style.css • JavaScript customization • contrib\custom.script.js • String customization • contrib\custom.wrstrings.<lang-code>.js • New language pack • Load extra culture files in custom.script.js

  39. Customization • Logon Screen • Logo • Hyperlink in Footnote • Text in Header

  40. Other Features of Storefront • Legacy Mode for PNAgent • Beacons • Multi Store Provisioning • Integrate with Citrix Online

  41. Other Features of Storefront • Subscription Database • Auto-Provision Applications • Apps and Desktops • KEYWORDS:Auto • KEYWORDS:Featured

  42. Troubleshooting

  43. Receiver Troubleshooting • [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix] • "ReceiverVerboseTracingEnabled"=dword:00000001 • [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Dazzle] • "Tracing"="true" • "DefaultTracingConfiguration"="global all -detail" • [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager] • "LoggingMode"="verbose" • "TracingEnabled"="True" • “SDKTracingEnabled”=“True” • Please use the corresponding Wow6432Node for x64 machines

  44. Receiver Troubleshooting • Output • %userprofile%\AppData\Local\Citrix\AuthManager\Logs\AuthManLog.txt • %userprofile%\AppData\Local\Citrix\AuthManager\Tracing\AuthManSvr.txt • %userprofile%\AppData\Local\Citrix\AuthManager\Tracing\Auth-timestamp.txt • %userprofile%\AppData\Local\Citrix\AuthManager\Tracing\AuthManagerSDK_Runtime-timestamp.txt

  45. Event Logs on Storefront • StoreFront Services record events on Event Viewer on Windows • It is no longer under Event Viewer > Applications • New location: Event Viewer > Applications and Services Logs > Citrix Delivery Services

  46. Useful Tools • Microsoft Event Viewer • IIS Logs • Microsoft .NET tracing • Microsoft DbgView • Fiddler • Live HTTP Headers • Wireshark • Microsoft NetMon

  47. IIS Logs • Check HTTP response codes • http://support.microsoft.com/kb/943891

  48. Extra Logging / Tracing – Authentication / Store • It uses Microsoft .NET tracing • You can enable tracing on different components • Tracing can be enabled on either Authentication Service or Store • Locate the <system.diagnostics> section in the Web.config file • In the <switches> section, enable tracing in the sources you need to monitor

  49. Alternative with Powershell • Add-PSSnapin Citrix.DeliveryServices.Framework.Commands • Set-DSTraceLevel -All -TraceLevel Verbose *Use account with adequate permissions on the Receiver Storefront server

  50. Extra Logging / Tracing – Receiver for Web • Enabled in web.config in C:\inetpub\wwwroot\Citrix\StoreWeb • Remove Comments

More Related