Belden HIRSCHMANN OpEdge User manual

OpEdge Technical Support
Industrial Edge Gateway – Release 01.0.00 – 10/2022 https://hirschmann-support.belden.com
User Manual
Configuration
Industrial Edge Gateway
OpEdge

OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
The naming of copyrighted trademarks in this manual, even when not specially indicated, should
not be taken to mean that these names may be considered as free in the sense of the trademark
and tradename protection law and hence that they may be freely used by anyone.
© 2022 Hirschmann Automation and Control GmbH
Manuals and software are protected by copyright. All rights reserved. The copying, reproduction,
translation, conversion into any electronic medium or machine scannable form is not permitted,
either in whole or in part. An exception is the preparation of a backup copy of the software for
your own use.
The performance features described here are binding only if they have been expressly agreed
when the contract was made. This document was produced by Hirschmann Automation and
Control GmbH according to the best of the company's knowledge. Hirschmann reserves the right
to change the contents of this document without prior notice. Hirschmann can give no guarantee
in respect of the correctness or accuracy of the information in this document.
Hirschmann can accept no responsibility for damages, resulting from the use of the network
components or the associated operating software. In addition, we refer to the conditions of use
specified in the license contract.
You can get the latest version of this manual on the Internet at:
https://www.doc.hirschmann.com
Hirschmann Automation and Control GmbH
Stuttgarter Str. 45-51
72654 Neckartenzlingen
Germany
For professional users in the European Union
If you wish to discard electrical and electronic equipment (EEE), please contact your dealer or supplier
for further information.
Prop 65 Warning – Cancer and Reproductive Harm – www.P65Warnings.ca.gov

Page 3of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022

Page 4of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
Open Source Information
Open Source Software used in the product
The product contains, among other things, Open Source Software files, as defined below, developed by third parties
and licensed under an Open Source Software license. These Open Source Software files are protected by copyright.
Your right to use the Open Source Software is governed by the relevant applicable Open Source Software license
conditions. Your compliance with those license conditions will entitle you to use the Open Source Software as foreseen
in the relevant license. In the event of conflicts between other Hirschmann Automation and Control GmbH license
conditions applicable to the product and the Open Source Software license conditions, the Open Source Software
conditions shall prevail. The Open Source Software is provided royalty-free (i.e. no fees are charged for exercising the
licensed rights). Information about used Open Source Software is available in the graphical user interface under Help (3
ellipses on top right) > License Information. You can find the Open Source Software and their respective licenses on
the DVD shipped with the product. For products shipped without DVD use the written offer (located in the graphical user
interface under Help > License Information) to request the DVD. The DVD contains the necessary elements and
instructions to rebuild your own version of the Open Source Software.
If Open Source Software contained in this product is licensed under GNU General Public License (GPL), GNU Lesser
General Public License (LGPL), Mozilla Public License (MPL) or any other Open Source Software license, which
requires that source code is to be made available and such source code is not already delivered together with the
product, you can order the corresponding source code of the Open Source Software from Hirschmann Automation and
Control GmbH - against payment of the shipping and handling charges - for a period of at least 3 years since purchase
of the product. Please send your specific request, within 3 years of the purchase date of this product, together with the
name and serial number of the product found on the product label to:
Hirschmann Automation and Control GmbH
Head of R&D
Stuttgarter Str. 45-51
72654 Neckartenzlingen
Germany
Warranty regarding further use of the Open Source Software
Hirschmann Automation and Control GmbH provides no warranty for the Open Source Software contained in this
product, if such Open Source Software is used in any manner other than intended by Hirschmann Automation and
Control GmbH. The licenses listed below define the warranty, if any, from the authors or licensors of the Open Source
Software. Hirschmann Automation and Control GmbH specifically disclaims any warranty for defects caused by altering
any Open Source Software or the product’s configuration. Any warranty claims against Hirschmann Automation and
Control GmbH in the event that the Open Source Software contained in this product infringes the intellectual property
rights of a third party are excluded. The following disclaimer applies to the GPL and LGPL components in relation to the
rights holders:
“This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
and the GNU Lesser General Public License for more details.”
For the remaining open source components, the liability exclusions of the rights holders in the respective license texts
apply. Technical support, if any, will only be provided for unmodified software.

Page 5of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
Contents
1Start Here 7
1.1 About OpEdge .........................................................................................................7
1.2 Information sheet .....................................................................................................7
1.3 Installation Guide .....................................................................................................7
2Initial Configuration 8
2.1 Connecting to the OpEdge Webpage.......................................................................8
3Registration in Belden Horizon 17
3.1 Registration Using Activation Key ..........................................................................18
3.2 Activation Errors.....................................................................................................20
4Overview 21
4.1 OpEdge Webpage Navigation................................................................................21
4.1.1 Search Bar .............................................................................................................22
4.1.2 […] Button ..............................................................................................................22
4.1.3 Apply Button...........................................................................................................23
4.1.4 Sidesheet Launcher ...............................................................................................23
4.1.5 Side Menu Scrolling ...............................................................................................24
4.2 Overview Tab.........................................................................................................25
4.2.1 Status.....................................................................................................................26
4.2.2 Device Summary....................................................................................................26
4.2.3 Ports.......................................................................................................................27
4.2.4 Temperature ..........................................................................................................29
4.2.5 Storage Available...................................................................................................29
4.2.6 Networking .............................................................................................................30
5Configuring the OpEdge 33
5.1 System Tab............................................................................................................33
5.1.1 Device Info .............................................................................................................33
5.1.2 User Access...........................................................................................................34
5.2 Interfaces Tab ........................................................................................................36
5.2.1 Ethernet Ports........................................................................................................37
5.3 Networking Tab......................................................................................................38
5.3.1 WAN Configuration ................................................................................................39
5.3.2 LAN Configuration..................................................................................................41
5.3.3 NTP........................................................................................................................44
5.3.4 Static Routes..........................................................................................................45
5.3.5 SNMP.....................................................................................................................46
5.3.6 Firewall...................................................................................................................47
5.3.7 NAT........................................................................................................................50
5.4 Protocols Tab.........................................................................................................51
5.4.1 File Relay ...............................................................................................................51
5.4.2 File Transfer to Belden Horizon .............................................................................53
5.5 Tunneling / VPN Tab..............................................................................................55
5.5.1 Belden Horizon ......................................................................................................55
5.6 Applications Tab ....................................................................................................56
5.7 Activity Tab ............................................................................................................57
5.7.1 System Logs ..........................................................................................................57

Page 6of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
6Applications 59
6.1 Containers..............................................................................................................59
6.1.1 Creating a Container..............................................................................................60
6.1.2 Container Status ....................................................................................................69
6.1.3 SSH Connectivity to Containers.............................................................................71
6.2 Container Volumes.................................................................................................72
6.2.1 Adding a Volume....................................................................................................73
6.2.2 Deleting a Volume..................................................................................................74
6.3 Images ...................................................................................................................75
6.3.1 Push Docker Image to Registry .............................................................................76
6.4 Virtual Machines ....................................................................................................77
6.4.1 Creating a Virtual Machine.....................................................................................78
7Diagnostics 89
7.1 Factory Reset – Configuration Webpage ...............................................................89
7.2 Factory Reset – Command Line Interface..............................................................91
7.3 Updating Firmware.................................................................................................94
A. Abbreviations 95
B. Appendix 96
B.1 Syslog Description ....................................................................................................................96
B.2 Maintenance .............................................................................................................................96
C. Troubleshooting the OpEdge 97
D. Further support 99

Page 7of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
1 Start Here
1.1 About OpEdge
OpEdge is an industrial gateway designed for secure remote connectivity and Industrial Internet
of Things (IIoT) applications.
OpEdge enables highly secure and reliable device-to-device and device-to-cloud
communications. The gateway includes a serial (RS-232) port and multiple Ethernet ports,
allowing for local connectivity to devices like PAC/PLCs, RTUs, DCS systems, smart instruments,
electronic billboards, and communication towers.
OpEdge can be configured and managed through the webpage or via the Belden Horizon
platform. Belden Horizon is a secure and intuitive cloud native platform that supports multiple
applications like on-demand (secure machine access) or always-on (persistent data network)
connectivity, data monitoring and alert notification.
OpEdge provides cloud connectivity to Belden Horizon via the Ethernet port.
1.2 Information sheet
The Hirschmann Safety and general information sheet and the OpEdge information sheet are
provided in the OpEdge packaging. They provide basic installation and configuration information.
1.3 Installation Guide
The OpEdge Installation Guide provides detailed power, wiring, cables, and diagnostics
information. It can be downloaded from www.doc.hirschmann.com.

Page 8of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
2 Initial Configuration
This chapter covers the initial configuration of the OpEdge via the webpage. Once the OpEdge is
registered on Belden Horizon, the OpEdge can be maintained via Belden Horizon (See Chapter 3
for more details).
The initial configuration includes setting up the LAN port. These steps must be followed, even if
the OpEdge is going to be registered via Belden Horizon for cloud connectivity.
2.1 Connecting to the OpEdge Webpage
Perform the following steps to connect to the OpEdge webpage:
1 Ensure that the module is connected to the network to Ethernet port 1, and apply power to
the module.
NOTE: The PC must be on the same subnet as the OpEdge’s default IP address settings.
2 Open a web browser and log in to the OpEdge configuration webpage. The default IP
address is: https://192.168.0.250:8080. If the PC is on a different subnet, temporarily set
the IP address of the PC to 192.168.0.xxx with a subnet of 255.255.255.0.
The login page is displayed.

Page 9of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
3 Enter the login credentials. The default username and password are admin and
password.
NOTE: The user is prompted to change the password after the first login. Provide a new password and apply
the changes. After successful login with the new password, further password changes are done from the
System tab on the webpage.
4 The Initial Setup dialog allows the following operations:
•Change Default Login Credentials
•Configure Basic Settings
•Import Configuration
•Manual Configuration

Page 10 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
A. Change Default Login Credentials: To change the default login credentials for the
OpEdge webpage:
i. Close the Initial Setup dialog to display another dialog as shown below:
ii. Enter the new login credentials.
NOTE: The password must be minimum 8 characters, including one lowercase character, one
uppercase character, one special character, and one number.
iii. Click SAVE to save the changes.

Page 11 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
B. Configure Basic Settings: To perform basic configuration settings:
i. In the Initial Setup dialog, click CONFIGURE BASIC SETTINGS.
ii. In the Login Details dialog, change the default login credentials and click NEXT.

Page 12 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
iii. In the Gateway Config dialog, provide the module name. Click NEXT.
iv. In the Assign LAN IP dialog, select a mode (Static or Dynamic). Enter the
OpEdge’s IP Address, Subnet Mask and Gateway.
v. Click SAVE to save the configuration changes.

Page 13 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
C. Import Configuration:
NOTE: For information on exporting the configuration to a .tar.gz file, please see page 22.
NOTE: During the initial module configuration, the default Username and Password must be changed.
To import a configuration file:
i. In the Initial Setup dialog, click IMPORT CONFIGURATION.
ii. In the Login Details dialog, change the default login credentials and click NEXT.

Page 14 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
iii. In the Import Configuration dialog, drag and drop a .tar.gz configuration file in the
dialog or click CHOOSE FILE FROM COMPUTER to browse and upload a file.
iv. Click IMPORT to import the selected configuration file.

Page 15 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
D. Exit from Initial Setup Dialog to Manually Configure:
NOTE: During the initial module configuration, the default Username and Password must be changed.
i. Click ‘X’ to bypass the initial setup process.
ii. Log in to the OpEdge.

Page 16 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
5 After a successful login, the Overview tab is displayed and contains the following
information:
•Status (such as Online, Tunneling, or Belden Horizon)
•Device Summary (such as Gateway Name, Description, Location, Firmware, System
Time and MAC)
•Ports (Ethernet)
•Networking (such as Status for LAN and WAN)
•Device temperature
•Available storage
•Other features
NOTE: The status of each parameter will vary.
NOTE: The user is automatically logged out after 15 minutes of inactivity.

Page 17 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
3 Registration in Belden Horizon
Belden Horizon is a secure and intuitive cloud-native platform. It supports multiple applications
like on-demand (secure machine access) or always-on (persistent data network) connectivity,
data monitoring, and alert notification. The OpEdge can be managed in Belden Horizon once
registered. This includes making configuration changes and scheduling firmware changes.
Before using the OpEdge, it must be registered in Belden Horizon by entering an Activation Key.

Page 18 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
3.1 Registration Using Activation Key
Use the following procedure to obtain the activation key from the OpEdge, and to register the
OpEdge with Belden Horizon:
NOTE:The OpEdge must be connected to the Internet through the WAN port. See WAN Configuration on page 39 for
more details.
1 Establish a default connection to the OpEdge and perform the initial setup as described in
the Initial Configuration section on page 8.
2 In the Overview tab > Status tile, click the ACTIVATE link under the Belden Horizon label.
NOTE: If the OpEdge is already connected to a Belden Horizon account, the link reads “Deactivate”.
3 The OpEdge securely retrieves an alphanumeric activation key from Belden Horizon that
is only valid for three hours. Record this activation key.
4 Open a new tab in a web browser, enter www.belden.io in the address bar, and press
ENTER.
5 On the Belden Horizon Login screen, enter the Belden Horizon login email and click LOG
IN, or click SIGN UPto create a new account. Login credentials are not interchangeable
between Belden Horizon and the webpage.
6 Once logged in, follow the prompts to create a project.

Page 19 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
7 Click the Gateways tab, and then click ADD GATEWAY.
8 The user will be prompted for the activation key recorded earlier. Click ACTIVATE.
9 Upon successful activation, the OpEdge appears on the Gateways tab.

Page 20 of 100 OpEdge
Industrial Edge Gateway – Release 01.0.00 – 10/2022
3.2 Activation Errors
The following error messages correspond to failed registration issues:
Error
Description
Solution
Key is corrupted.
The key is invalid.
Please make sure this is the correct
key.
Device Activation record was
found for activation key.
Failed to find an activation record in
the Belden Horizon database.
Please try another activation key.
Found a Device Activation
record in ACTIVATED state
for device.
The device is already activated.
Please try another activation key.
Activation key has expired.
This activation key has expired and a
new one has been generated.
Please check device for the latest
activation key.