Try our conversational search powered by Generative AI!

Eric
Feb 23, 2016
  31937
(6 votes)

Fixing the WebSocket Protocol Support issue when upgrading to EPiServer UI 9.4.0

I experienced a small but annoying error today when I installed a brand new CMS website with latest updates and also upgraded a website to the latest version of episerver cms.

The error occurred inside edit mode but did not show in Internet Explorer. The error message in episerver was:

“A real-time connection could not be established with the server. This may be caused by incorrect configuration. Please see the User interface section in the user guide for further information.”

So something must have happened in the latest release since I did not have this message last week. Firebug did the trick and help with finding the error:

Firefox can't establish a connection to the server at wss://yoursite.com/EPiServer/Shell/socket/endpoint/.
socket = new WebSocket(this._path);

 

Fixing the problem is to install websocket support like below.

For Windows Server 2012

server_thumb3

 

And for Windows 8 and above:

win8_thumb3

 

Update (Thanks Stephan):

If you are using an older system IIS 7.5 or below you will need to disable WebSockets to get rid of the error message.

<add key="Epi.WebSockets.Enabled" value="false" />

You can find more information at:

http://world.episerver.com/documentation/Items/Developers-Guide/Episerver-CMS/9/User-interface/websocket-support/

http://www.iis.net/learn/get-started/whats-new-in-iis-8/iis-80-websocket-protocol-support

Feb 23, 2016

Comments

Arild Henrichsen
Arild Henrichsen Feb 23, 2016 10:53 PM

The release notes for Update 100 also states that in CMS.UI 9.4, Websockets is required on the server because of the Instant UI updates in the Projects feature.

(AFAIK, Projects is still disabled by default until it's activated in Admin > Settings, so it's a bit strange that Websockets is required up front.)

Good writeup nonetheless!

KennyG
KennyG Feb 23, 2016 11:00 PM

I saw it was a beta feature, so if your account isn't in the beta admin group will you even see the message?

KennyG
KennyG Feb 23, 2016 11:01 PM

FWIW, I just got done adding the websocket protocol. :)

Eric
Eric Feb 23, 2016 11:16 PM

Yes it was beta feature I got the message for user belonging to the groups webadmins and webeditors and administrators for an alloy website upgraded to the latest and also for the upgraded website from 8.x to this version.

And I have not enabled the projects features but was planning to for the alloy website since it will be a demo for a customer :) 

Feb 23, 2016 11:40 PM

Thx for sharing. That will be something a lot of us will run into and scratch our head about I think :)

Stephan Lonntorp
Stephan Lonntorp Feb 24, 2016 08:37 AM

I had this issue too, and found out it pays to read release notes for major versions. So if you're going to run a CMS 9 site on older versions of IIS, disable WebSockets



http://world.episerver.com/documentation/Items/Upgrading/EPiServer-CMS/9/Breaking-changes/

"Note: System Requirements have changed for CMS 9. Windows Server 2008/2008 R2 and Windows 7 are no longer supported due to missing websocket support."

Petra Liljecrantz
Petra Liljecrantz Feb 24, 2016 09:01 AM

The most annoying thing is that if you're using DXC where using Edgecast CDN is required, then WebSockets isn't supported (by Edgecast) so you will need to turn off WebSockets to get rid of the error message.

Well done, EPiServer.

Stephan Lonntorp
Stephan Lonntorp Feb 24, 2016 01:16 PM

@Petra, that could be circumvented if you set up your DXC environment with different domain for edit, and not route that through EdgeCast. Funnily enough, that would also circumvent the issues with upload file size that EdgeCast has.

Petra Liljecrantz
Petra Liljecrantz Feb 24, 2016 01:38 PM

Sure, that would be a workaround for live sites. In development or testing where that wouldnt be setup yet it's quite annoying though. I'm just fascinated that a feature is released (in beta and on by default) that's not supported fully by the services that DXC uses.

Stephan Lonntorp
Stephan Lonntorp Feb 24, 2016 01:53 PM

I'm entirely with you, I think it's unacceptable. However, a separate edit domain could be acheived in DXC Integration environments as well, it would just mean an extra strange domain to remember, instead of a regular strange domain :)

Petra Liljecrantz
Petra Liljecrantz Feb 24, 2016 02:06 PM

Haha, yeah. Another weird URL, just what we need :)

Feb 24, 2016 03:20 PM

Hi,

Adding some information to the thread.

We are working on resolving the issue with websockets in DXC as we speak. We have earlier conducted a proof of concept that was successful and we are working on ticking off the final boxes right now. This will be introduced as soon as possible and we will let you know.

We will make sure to coordinate these type of releases going forward.

Please feel free to e-mail me or support if you have questions.


-Daniel

Feb 24, 2016 03:26 PM

Hi,

The features included in CMS UI 9.4 are not in beta, we missed removing the beta from the names before releasing, which is why WebSockets is enabled by default in the UI.

We are using the underlying socket implementation inside the Projects gadget even though Project Mode may not be enabled. But the system will still work (except you will get no live updates in the projects components) if sockets are disabled on the server.

And as Daniel said we will make sure to coordinate these types of releases better in the future.

-Magnus

Thomas Schmidt
Thomas Schmidt Mar 8, 2016 10:22 AM

I must say I am abit concerned about the choice of websockets for this feature. This makes it very hard to make high availability sites as websockets have to make a persistent connection to a specific server, meaning rolling updgrades of servers with no downtime for the endusers is going to be extremely hard.

That is unless the client script using websockets has built in retry/reconnection functionality, is this in place? Also how does this affect servers that are not load balanced with sticky load balancing(imho you should never use that because of HA requirements) but using round robin or least connection load balancing? 

This also puts a new requirement for the load balancers or reverse proxies in use not to mention that not all CDNs support websockets.

Some of our clients require very high uptime SLA requirements so you don't just take all servers in a farm offline for code deploy or windows patches, you do rolling upgrades for zero downtime for the end user if at all possbile.

Eric
Eric Mar 11, 2016 10:49 AM

That was a great comment. Could @episerver or @magnus respond to this maybe? I will try to ping Magnus on skype so that we get an answer :)

Johan Kronberg
Johan Kronberg Mar 11, 2016 11:36 PM

If you're running on Azure there's an On/Off switch for Web sockets under General -> Application settings for your Web app.

Mar 15, 2016 05:09 PM

Hi Tomas,
Let's see if I can help with some of the questions:

1. The client does have reconnection functionality. It will try to reconnect at an increasing interval, warn about trying to reconnect after three attempts and finally give up after eight.

2. Should be ok with any load balancing strategy as long as long as remote events and session state is setup among the load balanced servers.

3. Yes, whatever is in front of the servers needs to be able to handle websockets.

/Erik

Mar 16, 2016 05:48 AM

And an update to answer 2... Session state is NOT needed for the websocket functionality. So no change in setup is needed for this.

/Erik

Mar 31, 2016 01:43 PM

Enyoing this thread!

There is one way of finding out if your infrastructure is supporting WebSocket before an upgrade.

http://www.websocket.org/echo.html

Ours did not =( so it will be  FTW untill I can convince IT dep to allow it to pass through the proxy.

/Daniel

Jun 6, 2016 04:51 PM

@Daniel Österhof: Can you provide an update to the resolution you mentioned for the DxC?

We would prefer to not have to disable features of the product in order to use the hosting provided by EPiServer.

Thanks!

Chris

Chris Magee
Chris Magee Jun 6, 2016 04:55 PM

@Petra Liljecrantz: I'm very interested in your comment mentioning a file upload size when using Edgecast CDN via DxC. Can you provide more information? I cannot find any documented limitations online.

Thanks!

Mattias Örtenblad
Mattias Örtenblad Sep 13, 2016 03:39 PM

My app is writing socket errors to log even though I set in web.config. How can I make epi stop trying?

Please login to comment.
Latest blogs
Optimizely and the never-ending story of the missing globe!

I've worked with Optimizely CMS for 14 years, and there are two things I'm obsessed with: Link validation and the globe that keeps disappearing on...

Tomas Hensrud Gulla | Apr 18, 2024 | Syndicated blog

Visitor Groups Usage Report For Optimizely CMS 12

This add-on offers detailed information on how visitor groups are used and how effective they are within Optimizely CMS. Editors can monitor and...

Adnan Zameer | Apr 18, 2024 | Syndicated blog

Azure AI Language – Abstractive Summarisation in Optimizely CMS

In this article, I show how the abstraction summarisation feature provided by the Azure AI Language platform, can be used within Optimizely CMS to...

Anil Patel | Apr 18, 2024 | Syndicated blog

Fix your Search & Navigation (Find) indexing job, please

Once upon a time, a colleague asked me to look into a customer database with weird spikes in database log usage. (You might start to wonder why I a...

Quan Mai | Apr 17, 2024 | Syndicated blog