Container

icom SmartBox

Introduction

INSYS icom provides ready-made containers for the icom SmartBox of the MR router series (Smart Devices) for use and further development free of charge. The rights of the individual Open Source components must be respected by the user. INSYS does not assure any certain function for these containers.

The containers listed here have "demo" status. They serve as example for applications, for demonstrating technologies as well as a basis for developments and adaptations by our customers or third parties; the examples are not tested or released for productive use.

In case of any questions regarding the functionality of the programs or libraries contained in the containers, please refer to the respective (open source) project or appropriate bulletin boards.

Containers of the "build" type are compiled and published by INSYS with a documented status of the components contained. The build scripts used for this are provided by INSYS: https://github.com/insys-icom/M3_Container/tree/master/scripts

Containers of the "static" type have an "as is" status at the time when the container was created. Contact us in case you need a specific version of components in a container.

1. Application containers

Application containers contain executable Device Apps that can be configured and modified.

Eclipse 4diac Soft PLC (IEC 61499 / IEC 61131)
Status	Demo
Type	Build
Description	Container with runtime environment FORTE (Eclipse 4diac-RTE 1.8.4) IEC 61499 / 61131 compatible soft PLC For Eclipse 4diac FORTE (runtime) and 4diac IDE in container contained libraries for function blocks IEC 61131 Convert (converting file types) Reconfiguration I2C Dev (communication via I2C) Utils For Eclipse 4diac FORTE (runtime) and 4diac IDE available function blocks INSYS function blocks for MRX/MRO CLI (command line interface, generic; also for establishing VPN tunnels for remote maintenance) E-mail (dispatch) INFO LED (controlling the INFO LED) Digital inputs Digital outputs Restart SMS (dispatch) The following communication protocols are implemented for the runtime in the container: Modbus (RTU/TCP client) Serial Ethernet FBDK MQTT OPC UA (in the pipeline) Exemplary projects, e.g. LED control, MQTT communication, RAM usage monitoring
Download image	Container: forte_container.tar (2.6 MB) INSYS function blocks for 4diac IDE: insys_interfaces.zip (7.4 KB) INSYS function blocks for 4diac FORTE (runtime) – for developers, if 4diac runtime will be self-compiled: libForteControls-1.0.tar.gz (380 KB) INSYS library for MRX/MRO interfaces – for developers, if 4diac runtime will be self-compiled: libmrx_control-1.0.tar.gz (160 KB) 4diac IDE: https://eclipse.org/4diac/en_dow.php
Documentation	Execute the quick start wizard on a Smart Device in default settings. Further information about the installation and use of the exemplary projects are available here: HowTo_Forte-4DIAC_1_Intro
Build script / package overview	create_container_forte.sh
Related links	4Diac / INSYS icom report in SPS Magazin 05/2017 4Diac project page

MQTT Broker
Status	Demo
Type	Build
Description	MQTT is a very efficient protocol for IoT communication Various Device Apps on INSYS Smart Devices (e.g. Monitoring App, icom Data Suite) and other MQTT terminal devices like smartphone apps for example can communicate as publisher and subscriber via the MQTT broker container based on Mosquitto.
Download image	container_mosquitto_mqtt_broker.tar (2.3 MB)
Documentation	Based on Smart Device in default settings Execute Startup Wizard Install container in IP net "net1 – Config", assign an IP address Open configuration interface using a browser and the previously assigned IP address Menu > Overview (description)
Build script / package overview	create_container_mosquitto_mqtt_broker.sh
Related links	https://mosquitto.org

Modbus to MQTT Gateway
Status	Demo
Type	Build
Description	Gateway for periodic read out of one Modbus TCP register Dispatch of the value as MQTT publisher to an MQTT broker
Download image	container_modbus_mqtt_gateway.tar (2.3 MB)
Documentation	Based on Smart Device in default settings Execute Startup Wizard Install container in IP net "net1 – Config", assign an IP address Open configuration interface using a browser and the previously assigned IP address Menu > Overview (description)
Build script / package overview	create_container_modbus_mqtt_gateway.sh
Related links	https://mosquitto.org http://libmodbus.org

Nagios Network Monitoring
Status	Demo
Type	Static
Description	Modular system for monitoring networks, routers, hosts and services
Download image	m3_debian_nagios.tar (147 MB)
Documentation	nagios_login.txt (1 kB) nagios_setup.txt (1 kB)
Related links	www.nagios.org

Network Monitoring Tools: Icinga, Cacti, Zabbix
Status	Demo
Type	Static
Description	Tools for monitoring networks, routers, hosts and services
Download image	Icinga.tar.gz (160 MB) Cacti.tar.gz (106 MB) Zabbix.tar.gz (185 MB)
Documentation	The files for download are archives with the actual image (container) as well as text files with further information about installation and commissioning. Please unpack the respective archive and use only the *.tar file as container in the following instructions. Based on Smart Device in default settings 1. Execute Startup Wizard 2. Install container in IP net "net1 – Config", assign an IP address 3. Refer to the text files in the downloaded archive for further information
Related links	www.icinga.com www.cacti.net www.zabbix.com

Node-RED
Status	Demo
Type	Static
Description	A visual tool for wiring the Internet of Things Drag & drop sequence definitions for data sources, events and actions
Download image	NodeRED.tar.gz (36 MB)
Documentation	The file for download is an archive with the actual image (container) as well as a text file with further information about installation and commissioning. Please unpack the archive and use only the *.tar file as container in the following instructions. Based on Smart Device in default settings 1. Execute Startup Wizard 2. Install container in IP net "net1 – Config", assign an IP address 3. Refer to the text file in the downloaded archive for further information
Related links	www.nodered.org

Node-RED PRTG Network Monitoring Edition
Status	Demo
Type	Static
Description	Node-Red v1.1.3: "A visual tool for wiring the Internet of Things" Drag&Drop flow definitions for data sources, events and actions Authentication: user: insys, password: icom Changes regarding security and password: link Node-Red projects pre-configured: link Container Alpine Linux v3.8 based SSH user: root, password: root Extended backup concept for Node-Red: periodic rsync (15 min) backups all data relevant for Node-Red to an update-proof directory on demand(cf. /etc/periodic/15min/rsync-backup) Node-Red updates via SSH: `npm install -g --unsafe-perm node-red` PRTG interface for Node-Red pre-installed Node-Red monitoring application examples with PRTG pre-installed
Download image	Paessler-AG_Node-Red_Alpine-Stable (111 MB)
Documentation	The file for download is an archive with the actual image (container) as well as a text file with further information about installation and commissioning. Use only the *.tar file as container in the following instructions. Based on Smart Device in default settings 1. Execute Startup Wizard 2. Install container in IP net "net1 – Config", assign an IP address 3. Refer to the text file in the downloaded archive for further information.
Related links	https://www.nodered.org https://www.paessler.com/tools/prtg-node-red-connector

Net Tools
Status	Demo
Type	Build
Description	The container contains tools for network analysis and is intended to aid troubleshooting in a network. It contains amongst others tcpdump, iputils (full implementations of ping, ping6, rarpd rdisk, tracepath, traceroute, traceroute6), busybox (pscan, nc, netstat, ip, wget, .....), arping, httping (for simple contacting of a web server), iperf (for performance measurements), curl (supports also FTP and SNMP besides HTTP), mcip, mcip-tool, openvpn, strace (for debugging binaries), stunnel (for terminating SSL connections), iptables (for setting network filters)
Download image	container_net_tools.tar (2,9 MB)
Build script / package overview	create_container_net_tools.sh

2. Development containers

Development containers contain environments, resources and/or libraries for programming customer-specific applications (apps).

Debian environment
Status	Demo
Type	Static
Description	Minimum Debian system Packet manager "apt -get" for installing Linux software Ideal for Linux insiders and/or Raspberry Pi users for using their standard software (applications and development environments)
Download image	Debian 9 (Stretch) (49 MB) Debian 8 (Jessie) (59 MB)
Documentation	Configuration Guide "Installing a Linux Container in icom SmartBox"

Default Container
Status	Demo
Type	Build
Description	Replication of the container that can be created by icom OS-based routers (e.g. MRX/MRO) itself The replications is always generated with latest sources in contrast to the container of the router. Incl. shell scripting and web server with BusyBox Lua scripting
Download image	container_default.tar (1.2 MB)
Build script / package overview	create_container_default.sh

Minimal Container BusyBox
Status	Demo
Type	Build
Description	Minimal system only with the BusyBox tool collection
Download image	container_busybox.tar (1.0 MB)
Build script / package overview	create_container_busybox.sh

Git Container
Status	Demo
Type	Build
Description	Git for software version management plus OpenSSL, cURL and BusyBox
Download image	container_git.tar (2.1 MB)
Build script / package overview	create_container_git.sh

IRC Container
Status	Demo
Type	Build
Description	IRC server ngircd plus OpenSSL and BusyBox
Download image	container_irc.tar (1,8 MB)
Build script / package overview	create_container_irc.sh

Web server
Status	Demo
Type	Build
Description	Very flexible and efficient web server Lighttpd ("Lighty") plus OpenSSL, SQLite, BusyBox and nano (editor)
Download image	container_lighttpd.tar (2.4 MB)
Build script / package overview	create_container_lighttpd.sh

Node JS
Status	Demo
Type	Build
Description	Provision of a Node.js environment plus OpenSSL, cURL and BusyBox
Download image	container_nodejs.tar (14 MB)
Build script / package overview	create_container_nodejs.sh

Python 2
Status	Demo
Type	Build
Description	Script language Python 2 plus OpenSSL, SQLite and BusyBox
Download image	container_python_2.tar (16 MB)
Build script / package overview	create_container_python_2.sh

Python 3
Status	Demo
Type	Build
Description	Script language Python 3 plus OpenSSL, SQLite and BusyBox
Download image	container_python_3.tar (8.2 MB)
Build script / package overview	create_container_python_3.sh

Alpine Linux
Status	Demo
Type	Static
Description	Very small Linux distribution Based on musl, program C programs only in connection with own toolchain (other SDK) Start quick and easy known applications (e.g. OwnCloud, Apache2) A how-to for installing an Alpine Linux container is available here.
Download image	Alpine Linux 3.8 (2,9 MB)
Documentation	HTML documentation

3. Developer page

Software developers will find information and tools to generate own containers from scratch in our Github project "M3_Container".
https://github.com/insys-icom/M3_Container

Tool chain for generating C/C++ programs (realised in a VirtualBox for all PC operating systems) in the SDK
HTML framework for creating configuration websites
Adapted build scripts for standard software
Sources of the containers of the "build" type
Various tutorials, e.g. for using GO al programming language: https://github.com/insys-icom/M3_Container/tree/master/doc

The demo containers are open as demonstration material for own developments in operation: ssh access to the command line is granted to the user root with password root with full rights.