Configuring the WebSocket Protocol in IISMgr

To configure the WebSocket protocol in IISMgr and enable the JadeWebSocketModule for the web site, run the Internet Information Services (IIS) Manager from the right panel of the Administrative Tools, accessed from the Control Panel

Although these instructions use the default web site, you can create a separate web site with one or more application pools.

To install the JadeWebSocketModule

  1. In the Connections panel at the left, select the web server; for example, CNWCHCS86.

    The middle panel then displays server‑name Home; for example, CNWCHCS86 Home.

  2. Make sure that the middle panel is in Features View rather than Content View.

    Switch between views by using the context menu of the web server in the left panel or the icons at the bottom of the middle panel.

  3. Double-click Modules in the middle panel.

  4. Select Configure Native Modules from the context menu in the middle panel and then click the Register button in the Configure Native Modules dialog.

  5. In the Register Native Module dialog, use JadeWebSocketModule for the name and then locate the jadeWebSockets_IIS.dll in the JADE bin directory for the path.

  6. Click OK to register the DLL and then enable the JadeWebSocketModule by checking the JadeWebSocketModule check box in the Configure Native Modules dialog.

To enable the JadeWebSocketModule for the web site

  1. In the Connections panel at the left, select the web site under your web server; for example, Default Web Site.

    The middle panel then displays web‑site‑name Home; for example, Default Web Site Home.

  2. Double‑click Handler Mappings in the middle panel.

  3. Select Add Module Mapping from the context menu in the middle panel or click Add Module Mapping in the Actions panel at the right.

  4. Complete the module mapping in the Add Module Mapping dialog, as follows.

    1. In the Request path text box, enter the URL path you want to be handled by the module; for example, *.ws.

    2. In the Module drop-down list, select the JadeWebSocketModule that you configured in the previous instruction in this topic that installed the JadeWebSocketModule.

    3. Leave the Executable control blank; it is not needed.

    4. In the Name text box, enter JadeWebSocketHandler.

  5. Click Request Restrictions and then work through the tabs as follows.

    1. Mapping - disable (that is, uncheck) the Invoke handler only if request is mapped to check box.

    2. Verbs - select All verbs.

    3. Access - select Script.

 

VERSION 2018.0.01  |  Copyright © 2018  Jade Software Corporation Limited.  All rights reserved.