December 23, 2013

Configure Citrix Receiver for HTML 5 1.1 and Storefront 2.1

I was assisting a customer today with installing & configuring the Citrix Receiver for HTML 5 version 1.1 using Storefront 2.1 and found CTX134948. Which was mostly accurate, given it covers Citrix Receiver for HTML 5 version 1 and Storefront 2.1 but there are some slight differences with the look and feel from one to the other. Even though the procedure is the same I decided to post an update with the new
"Downloads" look and feel.

Complete the following steps to configure local access:
1. Download and install the XenApp 6.5 HRP01 for Windows Server 2008 R2 and Group Policy Updates on your XenApp 6.5 server.
2. Enable the ICA WebSockets Connections Computer Policy on a Citrix XenApp 6.5 server in the farm.
3. Restart the XenApp 6.5 server.
4. Download and install the Receiver for HTML5 HDX Engine Setup on your StoreFront 2.1 server.
5. Add the Receiver for Web site URL in the Citrix HTML5 HDX Engine Configuration tool.

Configuring XenApp
1. Log in with your Citrix login credentials and browse to Citrix Downloads.

2. Select XenApp and Product Software then click Find from the Find Downloads drop-down.

3. Select the release of XenApp 6.5 Feature Pack 1.

4. Under Components select the XenApp 6.5 HRP01 for Windows Server 2008 R2 (you will find it is superseded by HRP02) and Group Policy Updates section click Download.

You will see "Get License" instead of "Download" on the Group Policy Updates, which threw me off but I clicked on it and it took me to the download.

5. Extract the downloaded XenApp 6.5 HRP02 for Windows Server 2008 R2 zip file and run it to install on you XenApp 6.5 server then reboot.
Note: Don't worry if the server is sitting for 5-10 minutes showing Logging Off after installing the HRP. It will restart, so be patient.

6. Extract the downloaded file and run the CitrixGroupPolicyManagement_x64.msi on your XenApp 6.5 server.

7. Open the AppCenter console and choose Policies. Click on the Computer tab and click Edit.

8. Click the Settings tab under ICA category. Click WebSockets, and then Add for WebSockets connections.

9. Select Allowed option and click OK.

10. Reboot each of your XenApp 6.5 servers after installing Group Policy Updates to apply the changes. I found that I had to reboot each XenApp server for it to open the port utilized for the Receiver for HTML 5. Default TCP port is 8008.

Configuring StoreFront
1. Browse to Citrix Downloads.

2. Select Citrix Receiver and Receiver for Other Platforms then click Find from the Find Downloads drop-down.

3. Under the Receivers for Other Platforms category, select Receiver for HTML5 1.1.

4. Click Download.

5. Run the Citrix_HTML5_HDX_Engine_Setup_1.1.msi on your StoreFront 2.1 server.

6. Click the checkbox to accept the License Agreement, click Install and click Finish.

7. Open the StoreFront console, select Receiver for Web, and copy the Website URL.

8. Open the Citrix HTML5 HDX Engine Configuration tool available at Start > All Programs > Citrix > Citrix HTML5 HDX Engine > Citrix HTML5 HDX Engine Configuration.

9. Click Add.

10. Paste the Receiver for Web site URL in the dialog box. Click OK.

Edited from CTX134948 for the current Receiver for HTML 5 version 1.1 and Storefront 2.1

Below is added for testing purposes
1. Open a command prompt and use netstat to confirm TCP port 8008 is open and listening/waiting on all XenApp 6.5 servers.
2. Login from a Chrome book to your Storefront 2.1 server website and launch a published resource.

Again I hope this helps someone out there in the field!

Additional troubleshooting

End of last week I setup HTML 5 Receiver for a customer with XD 7.1 running on Server 2008 R2 SP1, when I ran into an issue. The issue was the HTML 5 Receiver port (8008 default) wasn’t open or opening on the VDA after checking with registry, Citrix policy (Web Sockets Enabled), a netstat, and several reboots.

VDA not opening port 8008

1. Registry - check if you are able to see these entries in your VDA "Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Citrix\ICAPolicies"
i. AcceptWebSocketsConnections dword 1
ii. WebSocketsPort REG_NONE data is zero-length binary value

Note: If you don’t see the above then you will have to run the VDA setup again.

2. Programs and Features - Select Citrix Virtual Desktop Agent 7.1 and change (this was our fix however the above mention came from a CTX)
i. Select Customize Virtual Delivery Agent Settings
ii. Accept all default
iii. Review and confirm Summary has port 8008 listed under Firewall
iv. Reconfigure

No comments:

Post a Comment