Linux

Note:

N3uron has been tested on the following Linux distributions:

• Debian 9 and newer; Debian-based like Ubuntu 18.04 and newer versions; Raspbian and Raspberry PI OS.

• RHEL 7, 8; Red Hat-based like CentOS 7, 8; Oracle Linux 7, 8 and Amazon Linux 2, 2023.

For other distros please contact your N3uron distributor or email info@n3uron.com

Minimum system requirements:

• Single-core 1GHz processor.

• 1GB RAM.

• 1GB free HD space (Requirements vary by usage).

Install N3uron

One-Step Automated Install

To install or upgrade N3uron to the latest version, run the following command:

curl -fsSL https://get.n3uron.com/install.sh | sudo bash

Manual Install

The following procedure will install N3uron in the recommended /opt/n3uron folder. It is also possible to install N3uron in a different folder, depending on the end user’s preferences.

Step 1: Download the N3uron setup file for Linux from our Download page.

Step 2: Decompress the setup file, where <arch> is the architecture of the target machine and <version> corresponds to the N3uron version.

sudo tar -xvzf n3uron-setup-linux-<arch>-<version>.tar.gz -C /opt/

Step 3: Install N3uron as a system service.

sudo /opt/n3uron/bin/n3uron install

Note:

In modern versions of 64-bit operating systems, external databases are not required to run Historian. A MongoDB instance will automatically be installed in the N3uron folder to provide storage for historical data.  The user can choose to use either the embedded MongoDB instance or an external one.

For older operating systems, such as Debian 9, RHEL 7 or Ubuntu 16.04, as well as ARM architectures, a MongoDB instance can be manually installed and used for Historian.

When installing MongoDB on an ARM64 device, please note that starting from version 4.0, MongoDB requires the ARMv8.2-A or later microarchitecture.

To use the embedded MongoDB database, it might be needed to install the libcurl4 dependency using the following command:

sudo apt install libcurl4

Step 4: Start the N3uron service.

sudo systemctl start n3uron

Step 5: Log in to the WebUI at http://localhost:8003 (to access the WebUI from a different machine use the IP instead of localhost) using the default credentials shown in the table below. We recommend changing the credentials after the first login.

Note:

The N3uron AMI available at the AWS Marketplace uses the Instance ID of the EC2 machine as the default password.

Note:

To access the N3uron WebUI from a different machine, make sure that the N3uron host machine is reachable and that there are no firewalls blocking the port assigned to N3uron WebUI (8003 and/or 8443 by default).

In demo mode, each module runs with full functionality for two hours. To restart the demo mode, simply restart the module from the Web interface.

The N3uron service can be controlled from the console using the following commands:

# Start the service.
sudo systemctl start n3uron

# Stop the service.
sudo systemctl stop n3uron

# Restart the service.
sudo systemctl restart n3uron

# Check the status of the service.
sudo systemctl status n3uron

# View the logs of the service.
sudo journalctl -u n3uron

Upgrade N3uron

Step 1 (Optional): Create a node backup to restore the N3uron configuration if something goes wrong during the update. You can find the steps to perform a node backup in the Backup and Restore section.

Step 2 (Recommended): Review the release notes for the target N3uron version to identify any breaking changes that might affect your current configuration.

Note:

It is strongly recommended to apply the update in a testing environment before implementing it in a production environment.

Automated Upgrade

Run our one-step automated script to upgrade your current installation to the latest release of N3uron.

curl -fsSL https://get.n3uron.com/install.sh | sudo bash

Manual Upgrade

Step 1: Stop the N3uron service by running the following command:

sudo systemctl stop n3uron

Step 2: Extract the new version of the binary files from the setup, where <arch> is the architecture of the target machine and <version> corresponds to the downloaded N3uron version. The following command assumes N3uron is installed in /opt/n3uron:

sudo tar -xvzf n3uron-setup-linux-<arch>-<version>.tar.gz -C /opt/ ./n3uron/bin

Note:

Given that version 1.21 includes significant modifications related to managing Users and Roles, upgrading from a previous version will automatically overwrite all the users previously configured for the WebUI and WebVision. Therfore, it will be required to recreate them. To ensure compatibility with the new version, the following command needs to be executed:

sudo tar -xvzf n3uron-setup-linux-<arch>-<version>.tar.gz --skip-old-files -C /opt/ ./n3uron/config

Step 3: Start the service and log into the WebUI to check everything is running correctly:

sudo systemctl start n3uron

Uninstall N3uron

Step 1: Uninstall the N3uron service with the following command.

sudo /opt/n3uron/bin/n3uron uninstall

Step 2 (Optional): Delete the N3uron installation directory.

sudo rm -r /opt/n3uron

Note:

This command will remove all the existing data and configuration of N3uron.