The following illustration shows an example of a successful Sox tunneling session.
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:
Sox tunneling licensed (see Licensing SoxTunnel service)
Sedona network connection between station and Sedona Framework device nodes
SoxTunnel service installed and configured (see Installing the SoxTunnel service)
Open a Sox tunnel session from the Workbench main menu
To establish a Sox tunneling session from Niagara Workbench, do the following:
From the Workbench AX-3.7 or later main menu, select
-> ->or
from the Workbench AX-3.6 or later main menu, select
-> ->The Open Sedona dialog box displays.
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.
In the Open Sedona dialog box, complete the following fields and click :
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.
If 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:
In the Workbench nav tree, right-click on the device under the desired Sedona network node and select
from the popup menu.The Authentication dialog box displays.
In the Authentication dialog box, enter your credentials and click the 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:
In the Workbench nav tree, right-click the desired station and select the
menu item from the popup menu.The Open Tunnel Sedona dialog box displays.
In the Open Tunnel Sedona dialog box, enter values in the following fields and click the 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:
In the Workbench nav tree, right-click on the desired (dimmed) disconnected node and select
from the popup menu.The Authentication dialog box displays.
In the Authentication dialog box, enter your credentials and click the 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.
Copyright © 2000-2014 Tridium Inc. All rights reserved.