1.  OpEdge device is installed and configured.

2. OpEdge device is activated on Belden Horizon.

3. You have the required licenses for BHDO.

1. Login to Belden Horizon & select the “APPLICATIONS” tab. Locate the BHDO application and click on “Deploy”



2. Select your OpEdge gateway & click on “Next”



3. Check the Application Summary screen & click on “Deploy Application”



Review the summary (Memory, Cores, Ports, Volumes etc.).

*Important*: Make a note of the Container Path and Volume. When you re-deploy the app (after corruption or deletion), this will preserve the licenses and configuration. Refer Section 3 for more details.

4. Now the application deployment is "In Progress".



When the Status changes to “Deployed”, click on “Finish”.



BHDO application is installed and running on the OpEdge gateway.



 2. Click on “+Add”, pop-up page will be displayed as below. Click on “Upload Application”



3. Choose the file from local file system and click on “Import”.



4. Once the upload is complete, below screen will be displayed, add the application “Name” & click on “Next”.



5. Toggle the “Enable Network” and select “Bridge” from the drop down. Click on “+Add Port” and map Container port to Host post as below:

443 to 4443 (Web UI)

4840 to 4840 (OPC UA Server)

1883 to 1883 (BHDO's native MQTT broker)

8086 to 8086 (BHDO's built in InfluxDB database)

Then click on “Next”.



6. Allot the RAM (4096 MB) and CPU cores (2). Click on “Next”.



7. Container path and Volume mapping is not required for the 1st time deployment. Click on “Next”.



8. The following environment variables are required in order for certain features within BHDO to work properly.

Variables for ping utility:

Name: sysctl.net.ipv4.ping_group_range

Value: 0 2147483647

Variables for BHDM activation:

Name: --cap-add1

Value: NET_ADMIN



9. Advanced Mode is not required, Click on “Next”



10.   Review the Summary and Click on “Create”.



11.   Now you can see the container is created and Running in the Applications tab.

12.   You can see the details of running container: Click on three dots symbol under “Other” tab then from drop down click on “Edit container details”.



You can see the details of running container application.  Scroll down to “Advanced Settings” section. Here you can see the Container Path to Volume mapping.

Same can be seen by clicking on “Storage” tab under Applications section.

*Important*: Make a note of the Container Path and Volume. When you re-deploy the app (after corruption or deletion), this will preserve the licenses and configuration. Refer Section 3 for more details.

1. Now you can access the BHDO app via local interface by inserting [https://[IP address of OpEedge-8D]:4443 in your web browser. For the first time login default Username is “admin” and Password is “password”.



2. Accept the End User License Agreement. Then you will be prompted to Change the Password. Change the password and click “Reset Password”.

3. Now when you login you will be directed to the license key page, select “Advanced Options” and look for the “Node-Locked License” section. Click on “Add License” Insert the License Activation Key provided to you and Click on “Submit”.

4. Once the License Key/Keys are registered then you can start using the app.

If your application container is corrupted or deleted.  You can re-deploy the Application and it will pick up from where you left. (Preserving the licenses and any configuration).

NOTE: Before proceeding further please delete the corrupted container from the OpEdge device either through local UI or through Belden Horizon.

Option 1: Deployment through Belden Horizon

Follow the same steps from Section 1 > Option 1

Now follow same steps in Section 2: BHDO Application Web UI

You can access the BHDO app via local interface by inserting [https://[IP address of OpEedge-8D]:443 in your web browser.  You can directly login with same Username and Password. Your licenses and configuration will be preserved. You can start from where you left.

Option 2: Local Deployment

Follow the same steps from Section 1 > Option 2

1. Open OpEdge device’s local UI in web browser via link as https://<Device IP Address:8080>. Login the device & then click on “Applications” & then “Container”.



2. Click on “+Add”. Now instead of uploading the application from local file system you can make use of the available image stored on the OpEdge device. Click on “Use Existing Image”.

3. Select the BHDO application Image and click on “Next”



4. Once the upload is complete, below screen will be displayed, add the application “Name” & click on “Next”.

5. Toggle the “Enable Network” and select “Bridge” from the drop down. Click on “+Add Port” and map Container port to Host Port as below:

443 to 4443 & 4840 to 4840.

Then click on “Next”.



 6. Allocate the RAM (4096 MB) and CPU cores (2). Click on “Next”.



 7. Now add the container Path “/var” and select the available Volume from the drop down. This is the Path and Volume mapped when you initially deployed the application on OpEdge device. This step will make sure you pick up from where you left (Preserving the licenses and configuration).



8. Environment Variables are not required click on “Next”.

9. Advanced Mode is not required, Click on “Next”

10.   Review the Summary. Notice the Container Path and Volume mapping. Click on “Create”



11.   Now you can see the container is created and Running in the Application tab.



Now follow same steps in Section 2: BHDO Application Web UI

You can access the BHDO app via local interface by inserting [https://[IP address of OpEedge-8D]:443 in your web browser.  You can directly login with same Username and Password. Your licenses and configuration will be preserved. You can start from where you left.

 This section describes the the process of adding simulated Devices and Tags. You can add them manually or use a JSON template if you have one.

Open the BHDO dashboard. Click on the “Systems” icon on the left side panel then select the last option “Templates“. Now Click on “Upload Template“.

Now browse the JSON file you want to upload and open it. BHDO will start the upload process. Once the upload is complete you will get the “Upload Successful“ message.

Navigate to BHDO Dashboard and here you can see the number of Devices and Tags have updated. Along with that you can see “Message Broker and Routing” number is also increasing.

2. Adding Devices and TAGs Manually

You can add Devices and TAGs manually through “Device Hub”

Open the BHDO Dashboard. Click on “Device Hub“ on the left side panel. Then click on the “+“ sign to add a Device.

Connect Device screen will open. Now select the “Device Type“, “Drive Name“. In below case we are using Simulator device with Generator Drive. Name the device add description. Click on “Add Device“.

Similarly, you can add multiple devices. The new device will be in “CONNECTED“ state. There will be 4 option on each device Refresh, Edit, Stop, and Delete.

Now on the same screen select “Tags“ option. Tags screen will open. Select the device for which you want to add TAG/TAGs. Now select the “+“ sign on top right hand side and select “Add a Tag“ option.

Add Tag screen will appear. Fill in the details and click on “Add Tag”.

Now you can see the Tag will reflect on selected device’s Tag list. Similarly, you can add multiple Tags on a device.

3. OPC UA Server

Select the OPC option from left hand side panel. In the “Hierarchy” section click on Import from device Hub option.

This will import the Devices and Tags from Device Hub.

Now select the “Management“ option from left hand side panel. Make sure the Policy Management and Authentication Management all selected as “None“.

Click on “Configure” on the top right corner. Fill in the details as shown in below screenshot. Uncheck the “Allow Nodes Under Root” box. Then click “Save“.

Now start the OPC UA server by clicking on “Start“ option on the top right hand corner. Confirm to “Yes“.

The OPC UA server is running.

4. OPC UA Client

Here we are using the free UaExpert Client software. Download and install on your machine.

Open the UaExpert software, Click on the “+“ to add the server. In Add Server box under the “Custom Discovery” option double click to add server.

Enter URL box will open. Enter the address as “opc.tcp://IP address of your edge device on which BHDO is running:4840” Click on “OK”

The client server connection is complete. You can see Edge Devices under Address Space. You can drag them to Data Access Vie pane to monitor Tags.