Creating a Reverse FrameWorX Connection

A reverse FrameWorX connection must be configured on both the source server (the one providing data) and the receiving server (the one reading the data).

To create a reverse connection:

  1. On the receiving server, perform the following steps:
    1. Open Workbench and in Project Explorer, expand your project > Servers and Redundancy, and double-click Server Connections.
    2. In the Connections pane, select Click here to add new item.

    3. In the Connection Settings form, enter the name of the connection, and then configure the remaining settings as follows.

      1. Select Open Tunnel for Reverse Connection.

      2. In Address, enter the IP address, computer name, or DNS name of the source server.

      3. In Protocol, select the preferred option. We recommend selecting the Secured (HTTPS) connection, which requires a valid certificate.

      4. In Port, enter the desired port number. If you change the default port number, take note of the address in Connection URL.

      5. If security is enabled on the receiving server, do one of the following:

        • If both the source and the receiving servers are in the same active directory domain, set Client Authentication to Integrated Windows Authentication.

          image.png

        • If the two servers are not in the same domain, check Use Credentials and enter the username and password of a user that exists in the receiving server's FrameWorX security.

          image.png

      6. When finished, click Apply & Close.

  2. On the source server, perform the following steps:
    1. Open Workbench and in Project Explorer, expand your project > Servers and Redundancy and double-click Server Connections.
    2. In the Connections pane, select Click here to add new item.

    3. In the Connection Settings form, enter the name of the connection, and then configure the remaining settings as follows.

      1. Select Create Reverse Connection.
      2. In Computer Name, enter the computer name of the receiving server.

      3. If security is enabled on the receiving server, select Use Credentials and enter the username and password of a user that exists in the receiving server's FrameWorX security.

        Integrated Windows authentication is not supported when creating a reverse connection.

      4. When finished, click Apply & Close.

    4. If you changed the port number in the receiving server configuration, edit C:\ProgramData\ICONICS\11\FwxAsyncServer.config.xml as follows:

      1. Find the WebSocketEndpoint line that matches your connection URL from the receiving server configuration. For example, if the connection URL is wss://:7443/fwxserverws/wss_anon/, find the line that contains https://+/fwxserverws/Wss_Anon/.

      2. Update the address to include the custom port number. Using the port number 7443 from the example above, the new line looks like this:

        <WebSocketEndpoint Address="https://+:7443/fwxserverws/Wss_Anon/" AuthenticationSchemes="Anonymous" />

      3. Save the file and restart the FrameWorX Server.