Installation

If you are interested in DeviceOn/ePaper and are used to the Linux platform, we here provide an installer for Ubuntu Linux 20.04 (one of the most popular Linux distributions). This section will guide you on how to install DeviceOn/ePaper on Ubuntu. Note here that:

  • The DeviceOn/ePaper Ubuntu Linux installer is named something like “DeviceOnEPDInstaller_u2004_3.x.x.tar.gz”. To acquire the installer and ensure having the latest version, please go to the resource page.

  • If you are running the installer with an account other than “root”, you should use the “sudo” command to obtain higher privileges, or the installation may fail at any step.

Steps to Install

Step 1: Open a terminal

The installer runs in CLI (Command Line Interface) mode. As such, open a terminal preferable for you.

Step 2: Copy the installer to the target host

Use the way you like to copy the installer to the target host.

Step 3: Unwrap the files

In the terminal, run “tar -xvf DeviceOnEPDInstaller_u2004_3.x.x.tar.gz” to unwrap the install files under Ubuntu Linux.

tar -xvf DeviceOnEPDInstaller_u2004_.tar.gz

Step 4: Go into the directory

In the terminal, run “cd DeviceOnEPDInstaller_3.x.x” to go to the directory.

cd DeviceOnEPDInstaller_3.x.x

Step 5: Set the installer as executable

In the terminal, run “sudo chmod +x DeviceOn_Server_Ubuntu 20.04_x64_3.x.x.run” so that the installer as an executable file under Ubuntu Linux.

sudo chmod +x EPD_Server_Ubuntu-20.04_x64_3.x.x.run

Step 6: Run the installer

You may need to run "sudo ./EPD_Server_Ubuntu-20.04_x64_3.x.x.run" to acquire higher privileges if you were logged in as a normal user.

sudo ./EPD_Server_Ubuntu-20.04_x64_3.x.x.run

Step 6 (Optional): Run the installer offline

You may need to run "sudo ./run_install.sh" to acquire higher privileges if you were logged in as a normal user.

sudo ./run_install.sh -o EPD-Dependency-Ubuntu-20.04.iso

Step 7: Answer some questions

This installer will guide you through installing DeviceOn/ePaper onto your local machine. All you need to do throughout the installation process is answer some questions as prompted.

  1. Please read the End-User License Agreement carefully. Press any key when you have finished reading and agree to the terms to continue with the installation.

  2. Enter "yes" to accept the license agreement.

  1. Check the running mode (should run as install mode) and system dependencies...

  1. DeviceOn/ePaper license is tied to a network interface. The following lists all chooseable network interface information. To install DeviceOn/ePaper, you have to determine which network interface to be tied to.

It is strongly recommended to select a physical network interface instead of a virtual one. Choosing a physical interface avoids any potential issues DeviceOn/ePaper may encounter in the future.

  1. Enter a "public static IP" in this step (Note: It is an important step for key functions such as OTA firmware upgrade, device connection, and image transfer).

  1. Enter the password for the PostgreSQL database (Note: This is the password for user postgres to login the PostgreSQL database).

  1. Enter the password for the Mongo database (Note: This is the password for user wisepaas to login the Mongo database).

  1. Decide whether you want to turn on the Mongo database-capped functionality or not. If you choose yes, please enter "y". Then, enter the recommended size: 10240 (MB).

When you run into this step the question shows like above. Just input “yes” or “no” to enable or disable “capped” functionality. If you answer “yes”, a subsequent question follows to ask you “How much capped size, in MB, to be used? “. Just input the size, in MB, you want to use in the “capped” functionality in the MongoDB database.

Capped collections are fixed-size collections that support high-throughput operations that insert and retrieve documents based on insertion order. Capped collections work in a way similar to circular buffers: once a collection fills its allocated space, it makes room for new documents by overwriting the oldest documents in the collection.

  1. Enter the root email for login DeviceOn/ePaper portal, and type 'y' to use 'root@advantech.com.tw'. If you want to use your domain, type 'n'.

  2. The password of user “root@advantech.com.tw” to login the DeviceOn/ePaper portal, and the rule should follow the below guideline.

Strong Password Rules:

Minimum eight characters, at least one number, one lowercase letter, one uppercase letter, and one special character (Blank character, Backslash(\), Double quotes(") are prohibited)

  1. After that, this installer will continue to install EPD Hub, EPD Controller, Service Monitor, and other system settings such as Firewall. Please wait in patience until the overall processes are done. Then, you will see a message like below.

Finally, a workable DeviceOn/ePaper server should be there as the target host. Open a browser and input http://{IP-USED-IN-STEP-7.4}, you should see the DeviceOn/ePaper login page.

Firewall Setting

Check out whether the firewall inbound rules in the following table have been set or not (We have set up the necessary port by default).

Port
Inbound rule
Service

22

Disable

SSH*

80

Enable

HTTP

443

Enable

HTTPS

8090

Disable

Service Monitor

1883

Enable

MQTT

8883

Enable

TLS/SSL encrypted MQTT

5672

Enable

AMQP

5671

Enable

TLS/SSL encrypted AMQP

2121

Enable

FTP

60001-60100

Enable

FTP Passive Mode

PreviousStandalone InstallerNextUpgrade

Last updated