Web Notifications and Progress UC requirements

Both functionalities - Server.Socket external object, and Progress Indicator User Control - have the same requirements which are detailed below:

Client Requirements

• Internet Explorer 10
• Mozilla Firefox 7 or upper
• Google Chrome 14 or upper
• Safari 5
• Safari for iOS 4.2.1

Web Server Requirements

Java

In java, the implementation is based on JSR 356, Java API for WebSocket.

Required:

• Java 7
• Java EE 7–compliant application server (minimum required: Tomcat 7.0.67)
• Servlet server running on JVM 1.7
• In case of building a WAR deployment, you have to add the following jars: commons-io-2.2.jar and GXWebSocket.jar

.Net

Software requirements:

• IIS8 or higher (Window 8 or higher / Windows Server 2012 or higher)
• .Net Framework 4.5

• IIS8 'WebSocket' module installed. To install this module for Windows 8, do the following:
• In the control panel, click the Windows button
• Type: Turn windows features on or off
• Navigate to: Internet Information Services –> world Wide Web services –> Application Development Features
• Select “Websocket Protocol” + OK

Configuration requirements:

• "Compiler Path" .NET Generator property set to use .NET Framework v4.0 (typically under "C:\Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe")
• Application Pool in IIS must be configured for running with .NET Framework v4.0
• IIS Version Property = IIS8.
• The web application must be Smooth (full ajax) , that is Version Property "Web User Experience = Smooth

Troubleshooting:

1. Verify web.config:

<httpRuntime requestValidationMode="2.0" targetFramework="4.5" />

//The Following Lines must NOT be present:

<compilation>
  <assemblies>
    <remove assembly="GXWebSocket" />
    <remove assembly="Microsoft.WebSockets" />
  </assemblies>
</compilation>

2. If you compile with framework 2.0, run on ASP.net 2.x, you may get this:

FileLoadException: Could not load file or assembly 'log4net, Version=1.2.11.0, Culture=neutral, PublicKeyToken=669e0ddf0bb1aa2a' or one of its dependencies.
The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)
SuperSocket.SocketBase.Logging.Log4NetLogFactory..ctor(String log4netConfig) +0

Solution: Apply Requirements

3. If you haven't the Web Socket Protocol installed you see the following error (or similar) in the web console:

Firefox can’t establish a connection to the server at
ws://localhost/WebAppName/gxwebsocket.svc?6977921532b3f2ecd1022896025d931c6062249c.

4. If you have Tomcat connected with Apache, one possible solution to make the Web Notifications work is the following:

Define this entries in the Apache configuration file:

• ProxyPass /<webapp name>/gxwebsocket ws://127.0.0.1:8280/<webapp name>/gxwebsocket
• ProxyPassReverse /<webapp name>/gxwebsocket ws://127.0.0.1:8280/<webapp name>/gxwebsocket

Then enable the proxy_wstunnel module in Apache.