Ubuntu

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

  • The DeviceOn Ubuntu Linux installer is named something like “DeviceOn_Server_Ubuntu 20.04_x64_5.x.x.run”. To acquire the installer and ensure having the latest version, please go to resource page.

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

Steps to Installation

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 target host

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

Step 3: Set the installer as executable

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

sudo chmod 0755 DeviceOn_Server_Ubuntu-20.04_x64_5.x.x.run

Step 4: Running the installer

Change your working directory to where the installer is and run "./DeviceOn_Server_Ubuntu 18.04_x64_5.x.x.run ". You may need to run "sudo ./DeviceOn_Server_Ubuntu 18.04_x64_5.x.x.run " to acquire higher privileges if you were logged in as a normal user.

sudo ./DeviceOn_Server_Ubuntu-20.04_x64_5.x.x.run

Step 5: Answering some questions

This installer will guide you through installing DeviceOn 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 in order to continue with the installation.

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

  1. Checking running mode and system dependencies...

  1. Enter 'y', if you agree to install and use MongoDB.

  1. Installing required 3rd party packages, including OpenJRE, Erlang, MongoDB, PostgreSQL, Tomcat, Grafana, RabbitMQ, FTPD, OMIdb, MogoSH, etc.

  1. DeviceOn license is tied to a network interface. The following lists all choose-able network interfaces information. To install DeviceOn, 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 may encounter in the future.

  1. The password of user postgres to login PostgreSQL database. When you run into this step the question shows like above. Just input the password you would like to use to login PostgreSQL database for “postgres” account.

When you run into this step the question shows like above. Just input the password you would like to use to login PostgreSQL database for “postgres” account.

  1. The password of user “wisepaas” to login MongoDB database.

When you run into this step the question shows like above. Just input the password you would like to use to login MongoDB database for “wisepaas” account.

  1. If turn MongoDB capped functionality on or not.

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 followed to ask you “how much capped size, in MB, to be used? “. Just input the size, in MB, you want to use in “capped” functionality in 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.

The characteristic of capped cannot be disabled, if you enable the collection at first.

  1. Enter 'y' to enable TPM to protect your IoT data and encrypt/decrypt credentials by TPM.

But pay attention to here that once you determine to introduce TPM into DeviceOn, it's not possible to disable in the future or DeviceOn will run into a big problem regarding encryption/decryption.

  1. The valid IP or host name of the target host.

When you run into this step the question shows like above. Just input the IP address of the target host. A hostname (even a FQDN) is also acceptable if you are sure that agents can connect to via the name you provide.

  1. Enter the root email domain to use, type 'y' to use 'root@advantech.com.tw'. If you want to use your own domain, type 'n'.

  1. The password of user “root@advantech.com.tw” to login DeviceOn portal, and the rule should follow 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)

When you run into this step the question shows like above. Just input the password you would like to use to login DeviceOn portal for “root@advantech.com.tw” account.

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

Activate License

Step 1: Accept the EULA

Please read over and consent to the license agreements found below.

Step 2: Login to DeviceOn and Apply License

Sign into DeviceOn with the account credentials you set up previously.

Upon your first login, a notice will open asking you to start a free trial or obtain a paid license through product activation. Activating a license is a prerequisite to handle your IoT devices in the system.

There are two license activation options: directly purchase from the WISE-Marketplace (method 1) or apply for a free trial (90-Day) via the Request Form (method 2). Both require the License Request Code, which contains device information details like the MAC address. Please copy or download this code to use for either activation method.

Method 1:

If you already have a WISE-Marketplace account created by Sales, go directly there to buy a DeviceOn license.

After purchasing, in the upper right go to the My Licenses page. Locate the inactive license, paste in your license request code to activate it, and download the license file.

Method 2:

Use the request form to input your personal information. Be sure to correctly fill out both your email and the copied License Request Code. Once you've verified the details are all accurate, submit the form. The trial license will be sent to the email you provide as soon as it is prepared.

When the audit process is done, expect an email from us containing the attached license file.

Step 3: Import License File

Locate the license attached in the email and activate it with the "Activate" button.

Last updated