Opening a Sox tunneling session

The following illustration shows an example of a successful Sox tunneling session.

Figure 5. Sox tunneling session established


Sox tunneling session established

There are several ways to establish a Sox tunneling session from Workbench. You can use the main menu and related dialog boxes or you can use one of the context-sensitive popup (right-click) menus in the nav tree. In addition, if you have previously established a Fox connection that is disconnected, the connection node in the nav tree only dims when you disconnect. You can right-click on the dimmed node and quickly reconnect by selecting the “Connect” menu item.

These methods are described in the following procedures.

Before establishing a Sox tunnel session you must have network access to a NiagaraAX station with the following features or conditions:

Open a Sox tunnel session from the Workbench main menu

To establish a Sox tunneling session from Niagara Workbench, do the following:

  1. From the Workbench AX-3.7 or later main menu, select File->Open-> Open Device

     or

    from the Workbench AX-3.6 or later main menu, select File->Open-> Open Sedona (sox)

    The Open Sedona dialog box displays.



  2. In the Open Sedona dialog, select the Tunnel (IP) option from the Host option box.

    The Open Sedona dialog box now displays a Tunnel to field.

  3. In the Open Sedona dialog box, complete the following fields and click OK:

    • Host (IP)

      Enter the IP address or name of the station platform that you are trying to use for tunneling.

    • Port

      By default, this is port 1876. Change this if you know that the SoxTunnel service on the tunneling platform is set to a different port.

    • Tunnel to

      Enter the IP address of the Sedona device that you are trying to reach.

    • Credentials

      Type in the Username and Password for the Sedona Framework device that you are trying to reach.

      NoteIf the Authenticate with User Service is set to true in the SoxTunneling service on the tunnelling station, then the users Credentials in the station and in the device app must match.

    If the connection is successful, the session is established, the device Nav Container view displays and an active “tunneled session” node appears in the nav tree.

Open a Sox tunnel session from a device node in Workbench nav tree

In Workbench, if you have a station open with networked Sedona Framework devices (SedonaNetwork or SedonaJen6lpNetwork), you can quickly establish a Sox tunnel connection to one using the popup menu, as described below:

  1. In the Workbench nav tree, right-click on the device under the desired Sedona network node and select Open Sox-Tunnel Session from the popup menu.



    The Authentication dialog box displays.

  2. In the Authentication dialog box, enter your credentials and click the OK button.

    If the connection is successful, the session is established, the device Nav Container view displays and an active “tunneled session” node appears in the nav tree.

Open a Sox tunnel session from a station node in the nav tree

(AX-3.6 only) If you have a host station (JACE or supervisor) visible in the Workbench nav tree, you can open a Sox tunneling connection to a device under it using the following steps:

  1. In the Workbench nav tree, right-click the desired station and select the Open Tunnel Sedona (sox) menu item from the popup menu.



    The Open Tunnel Sedona dialog box displays.



  2. In the Open Tunnel Sedona dialog box, enter values in the following fields and click the OK button.

    • Port

      Verify the Port number or change the port number, if necessary.

    • Credentials

      Enter Username and Password

    • Tunnel to

      Enter the tunnel route information. See Sox tunneling syntax for related details.

    If the connection is successful, the session is established, the device Nav Container view displays and an active “tunneled session” node appears in the nav tree.

Open a Sox tunnel session from a “disconnected” node in the nav tree

In Workbench, if you “disconnected” from a Sox tunnel connection without “Closing” the node in the Workbench nav tree, then the node continues to display as dimmed in the nav tree (this is standard display behavior in the Workbench nav tree).

You can quickly re-establish a Sox tunnel connection to a Sedona device using the following steps:

  1. In the Workbench nav tree, right-click on the desired (dimmed) disconnected node and select Connect from the popup menu.



    The Authentication dialog box displays.

  2. In the Authentication dialog box, enter your credentials and click the OK button.

    If the connection is successful, the session is established, the device Nav Container view displays and an active “tunneled session” node appears in the nav tree.