Everyware Software Framework Developer's Hub

Everyware Software Framework (ESF) is an enterprise-ready IoT Edge Framework distributed and supported by Eurotech. Based on Eclipse Kura, the open source Java/OSGi middleware for IoT gateways, ESF adds provisioning, advanced security, remote access, diagnostics monitoring. It supports ready-to-use field protocols (including Modbus, OPC-UA, S7), MQTT connectivity, and a web-based visual data flow programming to acquire data from the field, process it at the edge, and publish it to IoT Cloud Platforms. ESF features full remote device management through its integration with Everyware Cloud, Eurotech’s IoT Integration Platform.

Get Started

Install RHEL and ESF on a Reliagate 20-25 (beta)

This is a simple guide to install RedHat Enterprise Linux 7.3 and ESF 4.1.0 on a Reliagate 20-26.

  1. Download “Red Hat Enterprise Linux 7.3 Binary DVD” from https://access.redhat.com/downloads/content/69/ver=/rhel---7/7.3/x86_64/product-software

  2. Create a USB installer following directions here: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Installation_Guide/sect-making-usb-media.html

  3. Connect a keyboard and a mouse to the Reliagate and plug a DisplayPort monitor (the connector is under the Service Panel of the device). Connect the Reliagate to the net using one of the ethernet sockets on the device. Finally, plug the USB stick on the USB port on the side of the Reliagate and power on the device.

  4. The RHEL installation screen will appear on the screen. Select "Install Red Hat Enterprise Linux 7.3" and follow the instructions on the screen, selecting the appropriate options and configuring the Internet connection. When asked, select "Infrastructure Server" installation with no additional options

  5. After the installation succeeded, the device will be rebooted.

  6. Log in as root and register and attach to RH repositories:

subscription-manager register --username <username> --password <password>
subscription-manager list --available --all
subscription-manager attach --pool=<poolID>
  1. Enable extra and optional repos:
subscription-manager repos --enable=rhel-7-server-extras-rpms
subscription-manager repos --enable=rhel-7-server-optional-rpms
grubby --update-kernel=ALL --args=net.ifnames=0
grubby --update-kernel=ALL --args=biosdevname=0
  1. Run the following commands to replace the tweak issues related to Fedora/RHEL distros:
systemctl disable systemd-networkd
systemctl disable systemd-resolved
systemctl disable systemd-hostnamed
systemctl disable hostapd
systemctl disable wpa_supplicant
systemctl disable network
systemctl disable NetworkManager
  1. Install EPEL release repository:
yum install http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
  1. Install pre-requisite packages:
yum install deltarpm bzip2 net-tools ntp sudo biosdevname bluez unzip psmisc tar telnet bind iptables iptables-services dhcp hostapd dos2unix  setserial iw openvpn monit socat nano minicom gdb usbutils wireless-tools
  1. Install Java JRE:
    a. Download the Server JRE for Linux 64 (server-jre-8u92-linux-x64.tar) from http://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html#sjre-8u92-oth-JPR
    b. Untar the archive, copy the folder in /opt/ and create a symlink in /usr/bin for java
    c. Check Java running the following command
java -version
  1. Install ESF from installer package for Reliagate 20-26:
    a. Download ESF 4.1.0 for Reliagate 20-26 (esf_4.1.0_reliagate-20-26_rhel_7.3_installer.sh) from http://www.eurotech.com/download/en/pb.aspx?pg=ESF under the System Distribution tab
    b. Copy the installer on the device and make it executable using
chmod +x esf_4.1.0_reliagate-20-26_rhel_7.3_installer.sh

c. Run

./esf_4.1.0_reliagate-20-26_rhel_7.3_installer.sh

d. Reboot the system

Known Issues:

  1. Serial ports:
    The serial ports /dev/ttyXRUSB1 (COM0) and /dev/ttyXRUSB1 (COM1) are not available on the system. Moreover the ethsetserial command, used to switch between RS232/422/485, is not present.
  2. LEDs and GPIOs:
    The following resources (LEDs and GPIOs) are missing in the system:
    LED 5: User 1 /dev/led1_green (LED1 green)
    /dev/led1_orange (LED1 orange)
    LED 6: User 2 /dev/led2_green (LED2 green)
    /dev/led2_orange (LED2 orange)
    Digital Input 1: /dev/opto1_in/value
    Digital Input 2: /dev/opto2_in/value
    Digital Input 3: /dev/opto3_in/value
    Digital Output 1: /dev/opto1_out/value
    Digital Output 2: /dev/opto2_out/value
    Digital Output 3: /dev/opto3_out/value
  3. Bluetooth:
    Bluetooth 2.1 is not supported since ESF needs Bluez 4.101.
  4. Watchdog:
    The watchdog devices are not exported in /dev folder
  5. i2c bus
    The i2c bus is not available.
  6. Serial Number
    The device serial number is stored in the internal i2c eeprom. Since i2c driver is not supported, the serial number can't be read from the eeprom. To add the serial number to the system, write it to the /etc/eth_serial_number file before installing ESF. During ESF installation, the serial number is read and written to the ESF properties.

Install RHEL and ESF on a Reliagate 20-25 (beta)