Scanning a Niagara Network

Installing an oBIX Driver

To allow a Connect MiniAgent to retrieve data from the JACE, an oBIX driver must be installed and enabled on the Niagara Station. There are 2 authentication types which will require the use of 2 different ports. Port 443 for the Login connection and any https port for the oBIX polling connection. Those 2 authentication types are N4 Digest and AX digest.

The Niagara system's Authentication Scheme assigned to the user will determine the port used for login. For example, if (N4 Digest) or (AX Digest) is the user’s assigned scheme then port 443 (HTTPS), is mandatory. In the Niagara System WebService page, the HTTPS port must be set to 443 and HTTPS ONLY must be set to false. If (Basic) is the user’s assigned scheme then any port may be used except 443. The selected HTTP port in the Niagara System WebService page will determine the port number used for both oBIX and Login.

The MiniAgent oBIX polling connection by default, will attempt to connect to oBIX using port 80. The MiniAgent may connect utilizing other ports by adding a ":" and the port number. For example, if oBix was being reached via port 85 (HTTP), then the suffix ":85" should added to the IP of the JACE (192.168.1.254:85) in the Niagara Connection Settings.

Follow these steps to install an oBIX driver on the Niagara Station:

1. Connect Niagara Workbench tool to the IP address of the Niagara Station.
2. Open the Platform and enter the username, password, and appropriate port.
3. Choose Software Manager. Install or confirm the installation of following jar files and driver:

   • Niagara4 

• • • obix-rt
    • obixDriver-rt
    • obixDriver-wb
    • web-rt

OR

• • NiagaraAX 

• • • obix
    • obixDriver
    • web

1. Scroll down to the oBIX driver, choose it, and choose Install. If the oBIX driver has already been installed, you can skip this step.
2. Open the Station and enter the correct username, password, and appropriate port information.

3. From the palette, drag ObixNetwork to the Drivers node in the navigation tree.  

Scanning the Niagara Network

Now that the oBIX driver is successfully installed, use the following steps to help successfully scan the Niagara network.

1. In Connect, choose the Configuration Explorer icon and choose Agents.
2. Right-click on the Agent.

3. Choose Properties. 

4. In the Edit Agent window, choose Edit to the right of the Connection field. 

5. Enter the IP address of the Jace and the Username and Password of the Niagara Station.

6. Choose the Authentication Type. 

   • Http Basic - Choose if the Jace's web service is set to use http.
   • NiagaraAX Digest - Choose if the Jace is Ax and the web service is set to use http.
   • Niagara4 Digest - Choose if the Jace is N4 and the web service is set to use http.
7. Choose OK.

8. Choose the Home icon, choose the Agent, and then choose Restart Agent. 

9. Choose the Configuration Explorer icon and then choose Scan.

10. Choose Scan Network. 

11. If the result returned Niagara devices, then the deployment was successful.