Advantech ArdexaLinux Installation
Ardexa has developed a version of Linux for ARM (Raspbian) and x86 that is extremely reliable for IoT environments. It is known as ArdexaLinux. This guide will take you through the steps to load the ArdexaLinux image onto your machine device and installation of the Ardexa agent.
This guide is to install ArdexaLinux on the following Advantech devices: UNO-2271G, UNO-2272G and UNO-2362G. If you haven't configured the BIOS on these devices, you MUST do so. See the following pages. If your Advantech device is not one of the ones listed below, contact Ardexa.
Note: Ardexa Devices provided to our enterprise customers come pre-installed with the ArdexaLinux Image.

Preparation

The pre-requisites for these instructions are the following:
  1. 1.
    An IoT device and power supply
  2. 2.
    A micro SD Card adaptor (for the micro SD card)
  3. 3.
    An Ethernet network with Internet connectivity and a DHCP Server
  4. 4.
    A compatible mouse/keyboard
  5. 5.
    The ArdexaLinux Image, supplied by Ardexa.
  6. 6.
    The password for the ArdexaLinux image, also provided by Ardexa
  7. 7.
    Access to the Ardexa Cloud, and permissions that enable you to create a new Device
If you don't have these, contact Ardexa.

Install Ardexa Linux Image

Ensure a keyboard (and optional mouse) is connected to the edge device. Some industrial computers (such as the UNO-2271G) only have 1 USB port - in this case, an adapter is required to use the boot USB and keyboard/mouse concurrently.
  • Copy the ArdexaLinux ISO image to a USB device as a bootable image, and plug it into any USB socket.
  • Boot the machine. Make sure the BIOS setting is selected to boot off the USB (see above).
  • On some devices, a benign error may appear when booting - press any key to continue with the install.
  • A boot loader will appear. Select Install Ardexa to automatically install Ardexa.
  • System will automatically reboot. If it does not boot to login screen, then change the BIOS boot order by selecting the ‘non Ubuntu’ option. For installation of the Ardexa agent, see this page

Create Ardexa Agent

  • Login into your Ardexa App Workgroup.
  • Select [DEVICES] menu.
  • Select [MANAGE] option
  • Select SELECT NEW DEVICE
  • Input name of device in format XXXXX Company Name.
    • XXXXX is the 5-digit number given to you in the order.
    • Company Name is the name of the destination company noted in the order.
  • Select Linux 64 bit (x86_64)
  • A newly created agent will be then available for download.

Install Ardexa Agent

  • Copy deb files or executable onto your machine. For Linux: sudo dpkg -i ardexa-<version>.deb
<version> = name of Debian package file you downloaded.
Detailed instructions on agent installation are provided here.

Label your Machine

  • We suggest labelling the machine with the 5-digit number provided in the order.
  • Place the label alongside the serial number on the outside of the machine.

Machine Password

Please contact Ardexa

Timezone

It is important that the machine has the correct time zone. We suggest using the delivery location of the machine as its time zone.
To set the time zone log into the machine and open a terminal/command-prompt window on the machine.
In the terminal window run the command: sudo timedatectl
  • this will show the current date, time AND time-zone.
  • Check it correct
In the terminal window run the command: sudo timedatectl list-timezones
  • This will list the available timezones.
  • Use the space bar to scroll down the list, make note of the desired timezone for the device and Ctrl-C to exit.
In the terminal window run the command: sudo timedatectl set-timezone <desired-new-timezone>
  • This will change the time zone on the machine-device.
  • Example: sudo timedatectl set-timezone Europe/Berlin
Make sure the device METADATA is refresh when the timezone is changed.

Record Important Details

We suggest you keep an inventory of your devices and record the following details by taking photographs of:
  • Windows license (if installed).
  • Serial number of the machine.
  • Label of machine.

Final Testing

  1. 1.
    Connect the machine to the Internet using a network with DHCP.
  2. 2.
    Check the machine has come online using the Ardexa App.
  3. 3.
    Check that agent is working by typing a simple command in: DEVICES > {DEVICE} > REMOTE SHELL.
    • Eg: ls (list directory).
    • If machine returns a list of folders, then agent is operating correctly.
  • Remove AC power to the machine and then reconnect power
    • Check that machine has come online again (step 2/ above)
    • Check that agent is working again (step 3/ above)
Copy link
Outline
Preparation
Install Ardexa Linux Image
Create Ardexa Agent
Install Ardexa Agent
Label your Machine
Machine Password
Timezone
Record Important Details
Final Testing