Hilscher NetFIELD OnPremise Manuel utilisateur

User manual

netFIELD OnPremise

Hilscher Gesellschaft für Systemautomation mbH

www.hilscher.com

Table of contents 2/152

Table of contents

1 Introduction .............................................................................................................................. 5

1.1 About this document ........................................................................................................5

1.1.1 Description of the contents ............................................................................... 5

1.1.2 List of revisions ................................................................................................. 5

1.1.3 Conventions in this document........................................................................... 6

1.2 Terms and abbreviations..................................................................................................7

2 Brief description ...................................................................................................................... 8

2.1 Intended use ....................................................................................................................8

2.2 Key features .....................................................................................................................8

2.3 netFIELD OS: Industrial IoT Operating System ...............................................................9

2.4 Depiction of netFIELD OnPremise SW architecture ......................................................12

3 Safety ...................................................................................................................................... 13

3.1 General note ..................................................................................................................13

3.2 Personnel qualification ...................................................................................................13

3.3 Device destruction by exceeding the allowed supply voltage ........................................13

4 Hardware description ............................................................................................................ 14

4.1 Device drawings.............................................................................................................14

4.1.1 Positions of the interfaces............................................................................... 14

4.1.2 Dimensions ..................................................................................................... 16

4.2 Interfaces .......................................................................................................................17

4.2.1 Power supply .................................................................................................. 17

4.2.2 LAN connectors .............................................................................................. 17

4.2.3 Real-Time Ethernet connectors ...................................................................... 17

4.2.4 USB connectors .............................................................................................. 18

4.2.5 Serial interfaces COM1 and COM2 ................................................................ 18

4.2.6 Wi-Fi................................................................................................................ 20

4.2.7 Monitor connectors ......................................................................................... 20

4.3 LEDs ..............................................................................................................................21

4.3.1 Positions of the LEDs on the device ............................................................... 21

4.3.2 Device status LEDs......................................................................................... 22

4.3.3 LEDs of the LAN interface .............................................................................. 23

4.3.4 LEDs of the Real-Time Ethernet interface ...................................................... 23

5 Commissioning and first steps ............................................................................................ 24

5.1 Overview ........................................................................................................................24

5.1.1 netFIELD Portal user ...................................................................................... 24

5.1.2 Standard Docker user ..................................................................................... 25

5.2 Mounting ........................................................................................................................26

5.2.1 Attaching LED sticker (optional)...................................................................... 26

5.2.2 Mounting ......................................................................................................... 27

5.2.3 Connecting Voltage suppy .............................................................................. 28

5.3 Establish LAN connection and login to Local Device Manager......................................29

5.3.1 Overview ......................................................................................................... 29

5.3.2 Using DHCP server......................................................................................... 30

5.3.3 Establishing one-to-one connection to device (without DHCP server) ........... 33

5.3.4 Login to Local Device Manager ...................................................................... 34

netFIELD OnPremise | User manual

Table of contents 3/152

5.4 Set system time..............................................................................................................37

5.5 "Onboard" (register) device in netFIELD Portal .............................................................39

5.5.1 Overview ......................................................................................................... 39

5.5.2 Onboarding using the “Basic” method ............................................................ 40

5.5.3 Onboarding using the “Advanced” method ..................................................... 43

6 Local Device Manager ........................................................................................................... 50

6.1 Overview ........................................................................................................................50

6.2 System ...........................................................................................................................52

6.3 Networking .....................................................................................................................55

6.3.1 Overview ......................................................................................................... 55

6.3.2 Firewall............................................................................................................ 60

6.3.3 Network Proxy settings ................................................................................... 69

6.4 Networking Services ......................................................................................................76

6.4.1 Wi-Fi................................................................................................................ 76

6.4.2 DHCP Server .................................................................................................. 88

6.5 Onboarding (and offboarding) ........................................................................................92

6.6 Standard Docker ............................................................................................................95

6.7 IoT Edge Docker ..........................................................................................................102

6.8 Accounts ......................................................................................................................108

6.9 Certificate .....................................................................................................................111

6.10 General Settings ..........................................................................................................112

6.10.1 Overview ....................................................................................................... 112

6.10.2 Web Server (Port) Settings ........................................................................... 113

6.10.3 Default MQTT Client Settings ....................................................................... 114

6.10.4 Docker Network Settings .............................................................................. 116

6.10.5 OT Interface (Using the cifx0 interface or RTE)............................................ 119

6.10.6 Remote Access............................................................................................. 121

6.11 Terminal .......................................................................................................................123

6.12 System Update.............................................................................................................124

6.13 Logs .............................................................................................................................128

7 Good to know... .................................................................................................................... 129

7.1 Device recovery via USB .............................................................................................129

7.1.1 Overview ....................................................................................................... 129

7.1.2 Requirements................................................................................................ 129

7.1.3 Step-by-step instructions .............................................................................. 130

7.2 Useful CLI commands and parameters in Terminal.....................................................138

7.2.1 Network Manager.......................................................................................... 138

7.2.2 Show interface status.................................................................................... 138

7.2.3 Activate interface .......................................................................................... 138

7.2.4 Docker Compose Support for Standard Docker environment....................... 138

7.2.5 Manage Standard Docker ............................................................................. 138

7.2.6 Manage IoT Edge Docker ............................................................................. 138

7.2.7 Enable/disable SSH Daemon (release port 22) ............................................ 138

7.2.8 External storage support using iSCSI ........................................................... 139

7.2.9 Follow the system log via terminal CLI ......................................................... 139

8 Technical data ...................................................................................................................... 140

9 Decommissioning, dismounting and disposal ................................................................. 142

netFIELD OnPremise | User manual

Table of contents 4/152

9.1 Putting the device out of operation...............................................................................142

9.2 Removal of battery .......................................................................................................142

9.3 Disposal of waste electronic equipment.......................................................................143

10 Legal notes ........................................................................................................................... 144

List of figures ....................................................................................................................... 148

List of tables......................................................................................................................... 151

Contacts................................................................................................................................ 152

netFIELD OnPremise | User manual

Introduction 5/152

1 Introduction

1.1 About this document

1.1.1 Description of the contents

This user manual describes the hardware and the web-based management

GUI (Local Device Manager) of the netFIELD OnPremise device (NIOT-E-

TIJCK-GB-RE/NFLD) from Hilscher. Instructions on how to commission the

device are also provided in this document.

1.1.2 List of revisions

Index Date Author Revision

1 2020-12-10 MKE Document created.

2 2021-06-29 MKE Document revised and updated to netFIELD OS 2.2:

Section Brief description [}page8] updated.

Section LAN connectors [}page17] updated.

Section LEDs of the Real-Time Ethernet

interface [}page23] updated.

Section Establish LAN connection and login to Local

Device Manager [}page29] updated.

Section "Onboard" (register) device in netFIELD

Portal [}page39] updated.

Section Firewall [}page60] updated.

Section Using the cifx0 interface (RTE) removed

(substituted by section OT Interface (Using the cifx0

interface or RTE) [}page119]).

Section Networking Services [}page76] added.

Section Standard Docker [}page95] revised.

Section IoT Edge Docker [}page102] revised.

Section OT Interface (Using the cifx0 interface or

RTE) [}page119] added.

Section Remote Access [}page121] added.

Table1: List of revisions

netFIELD OnPremise | User manual

Introduction 6/152

1.1.3 Conventions in this document

Notes, instructions and results of operating steps are marked as follows:

Notes

Important:

Note:

Instructions

1. Operational step

ØInstruction

2. Operational step

ØInstruction

Results

Intermediate result

Final result

netFIELD OnPremise | User manual

Introduction 7/152

1.2 Terms and abbreviations

Term Description

IIoT Industrial Internet of Things

IT network Information technology network

OT network Operational technology network

netFIELD App netFIELD application container from Hilscher, deployable via

netFIELD Platform and running in the IoT Edge Docker of the

netFIELD OS

netFIELD OS Cross-platform capable operating system with connection to the

netFIELD Platform

netFIELD Edge Devices or systems running the netFIELD OS

netFIELD Platform Internet-hosted platform providing APIs for cloud-to-cloud and

cloud-to-edge communication. Basis for the netFIELD Portal

netFIELD Portal Web-based user interface for the netFIELD Platform services

netFIELD Cloud netFIELD Platform and netFIELD Portal

netX Multi-protocol communication controller for OT networks

Table2: Terms and abbreviations

netFIELD OnPremise | User manual

Brief description 8/152

2 Brief description

2.1 Intended use

netFIELD OnPremise is an Edge Device hosting the netFIELD OS for

connecting an OT network – like e.g. PROFINET – with an IT network, the

netFIELD Cloud or other custom IIoT services or applications.

2.2 Key features

·Physical separation of OT network and IT network by using two

controllers:

– Primary controller: Edge computing, IIoT functions and cloud

connectivity are processed by the security-enhanced Yocto-Linux-

based netFIELD OS on the main CPU.

– Secondary controller: OT network connectivity (e.g. PROFINET) is

processed by the netX 100 communication controller.

·Applications for data acquisition, analytics, processing or connectivity

(to cloud or other enterprise systems) do not run natively under the

netFIELD OS, but as “containers” in a Docker runtime. netFIELD OS

provides two Docker runtimes that are running simultaneously on the

device:

–IoT Edge Docker for remote and automatic deployment and

maintenance of containers. These containers are deployed (“pulled”)

and managed over the netFIELD Platform. This requires your device

to be onboarded in the netFIELD Portal. Note that you need an

account/subscription for the netFIELD Portal

(https://www.netfield.io) for this.

–Standard Docker for manual and local deployment and

maintenance of containers.

Those containers can be pulled from official registries like Docker

Hub (https://hub.docker.com) or any locally hosted Docker registry.

In case you do not participate in the netFIELD device registration

and onboarding process, the standard Docker is the only way to pull

and run container applications on your device.

·The netFIELD OS features the Local Device Manager, which is a web-

based GUI for local device parameterization.

netFIELD OnPremise | User manual

Brief description 9/152

2.3 netFIELD OS: Industrial IoT Operating System

The netFIELD OS, as a part of our technology portfolio, supports scalable

field device hardware depending on the customer's use case. In order to

achieve this, applications do not run directly on the host system but instead

as containers in a Docker runtime. Our OS is very lean and only supports

the essential services required by the customer's network infrastructure.

Features

·Run containers: Containers are revolutionizing connected IoT devices,

and netFIELD OS is the perfect match to run them.

·Manage device: Manage your device locally with a web-based

interface. It is easy to administer storage, configure networks, and

more.

·Build to last: Build to survive in harsh environments like unexpected

shutdowns with security in mind.

·Easy to port: Based on Yocto Linux for easy porting to most capable

device types across various CPU architectures.

Architecture

Hilscher netFIELD OS is a secure operating system that makes it easy to

program, deploy, connect and manage Edge Devices. Hilscher netFIELD

OS extends the Linux kernel, with software libraries to securely connect

operation technology like PLC, MES, Historians, Files or other on-premise

systems with IT services like the netFIELD Portal. Our OS lets you innovate

faster embracing container technologies managed by the netFIELD Portal

from a central point or locally at the edge.

Figure1: netFIELD OS architecture

netFIELD OnPremise | User manual

Brief description 10/152

Core Services

The netFIELD OS core services include the support of hardware interfaces,

the network environment, secure communication and system logging. In

order to support the customer in setting up the gateway configuration, the

Local Device Manager is coming along with the core services. With the

open plug-in mechanism, the functionality of the Local Device Manager can

be easily extended with the help of containerized applications.

Container Management

Application containers can run in the IoT Edge Docker or Standard Docker

environment and do contain business logic such as for data acquisition,

analytics, processing or connectivity to cloud or enterprise systems.

The container management provides the functionality to pull and run

containers on the device itself. Before a container can be run, its image

needs to be pulled from a certain container registry. After that the container

is created, the application can be then controlled by using the start / stop

commands or by enabling the autostart option. Also, the deletion of

containers and images is a part of container management. In order to

enable the field devices for off- and online scenarios, netFIELD OS

provides two Docker runtime environments at the same time.

The IoT Edge Docker environment is managed by the netFIELD.io platform

remotely. That is why there is no need to have direct access to the

netFIELD Device, as long as the device can hold his connection to

netFIELD.io. Administrators can be anywhere and have full management

access to the device with the stored images and has the ability to control

the application containers remotely. Otherwise, the Standard Docker can

be used locally if the netFIELD device is not connected to netFIELD.io. In

this case, the Standard Docker runtime environment can be managed by

the Local Device Manager, by the netFIELD OS command line interface or

by a web application like portainer.io, which can be deployed as container.

Figure2: netFIELD OS container management

netFIELD OnPremise | User manual

Table des matières

Autres manuels hilscher Matériel réseau

hilscher

hilscher netRAPID Chip Carrier Manuel utilisateur

hilscher

hilscher PKV 50 Series Guide d'application

hilscher

hilscher NFD-3090-PNS-IOLM/W Manuel utilisateur

hilscher

hilscher netHOST NHST-T100 Mode d’emploi

hilscher

hilscher NETX50-BSL Manuel utilisateur

hilscher

hilscher NXHX 52-JTAG Manuel utilisateur

Manuels Matériel réseau populaires d'autres marques

Matrix Switch Corporation

Matrix Switch Corporation MSC-HD161DEL Manuel utilisateur

B&B Electronics

B&B Electronics ZXT9-IO-222R2 Manuel utilisateur

Yudor

Yudor YDS-16 Manuel utilisateur

D-Link

D-Link ShareCenter DNS-320L Manuel utilisateur

Samsung

Samsung ES1642dc Instructions d'utilisation

Honeywell Home

Honeywell Home LTEM-PV Instructions de montage

evertz

evertz 7700 Series Manuel utilisateur

D-Link

D-Link ShareCenter DNS-343 Manuel utilisateur

Asante

Asante AsanteBridge 1012 Manuel utilisateur

FireBrick

FireBrick FB2700 Manuel utilisateur

Audiovox Electronics

Audiovox Electronics ARWH2T Manuel utilisateur

ADC

ADC DSX-1 Manuel

NetComm

NetComm NF2 Manuel utilisateur

Alcatel-Lucent

Alcatel-Lucent 5620 Manuel utilisateur

Dell EMC

Dell EMC XC6420 Series Manuel utilisateur

Lanner

Lanner NCA-1020A Manuel utilisateur

Allied Telesis

Allied Telesis AT-TN121-A Manuel utilisateur

Arista

Arista CCA-ETM-Q12 Manuel utilisateur

hilscher netFIELD OnPremise Manuel utilisateur

Manuels Matériel réseau populaires d'autres marques