Installation (ARM64 or X86/AMD64)

How to install the agent

For most users, the Debian package (DEB) will be your method of installation. This includes

  • Debian Jessie or higher

  • Ubuntu: all currently supported versions

  • Raspbian Jessie or higher

  • ArdexaLinux (based on Debian)

Installing the Agent in Linux

NOTE: Ardexa Devices provided to enterprise users have the Ardexa Agent pre-installed.

Power on your device and log in when the Login prompt appears. Copy the agentPack onto a USB stick using your laptop and then plug the USB stick into the device.

Mount the USB Drive

On the device you will need to manually handle the USB stick and unzip process so that you can read the files. With the USB key inserted, run the following commands

Retrieve USB Disk Partition Name

1. Run the following command and note the name of the USB disk partition in the output, e.g. sda1:

sudo lsblk

2. Create the mount point:

sudo mkdir /mnt/usb

3. Mount

sudo mount /dev/sda1 /mnt/usb
ls /mnt/usb

The first command should not print anything to the screen. The second command, ls should list the files on the USB stick. The following commands assume that the agentPack is the only file in the USB stick.

Install the Agent

Linux command shells have a feature call "TAB completion" which can save you lots of time and avoid errors. For example, when typing the following commands, you can just enter unzip agent and then press the TAB button. If there is only one filename that starts with agent, the shell will auto-complete the rest of the name. If the name is not auto-completed, press TAB a second time to see the available options and you can enter more character until you get a unique match.

The same applies to the dpkg command, type sudo dpkg -i ardexa and then press TAB to auto-complete the rest of the filename

1. Navigate to the directory where the USB drive is mounted

cd /mnt/usb

The next step will unzip the agentPack. Where it says <TAB>, press the [TAB] key on your keyboard before pressing ENTER. <TAB> will activate a feature in the Linux command shell called "Auto Complete" which will type-out the rest of the file name for you.

sudo unzip /mnt/usb/agent<TAB>

Inside the ZIP file there are two more files. The file names will be displayed on the console. Next, we will install the DEB file using the following command. Again, press the [TAB] key when you see <TAB>.

sudo dpkg -i ardexa<TAB>

Assuming the device has internet access, the agent should now connect.

Once connection has been confirmed, the USB drive may be removed directly after running the following command.

sudo reboot
unzip agentPack-${WORKGROUP_ID}-${DEVICE_NAME}.zip
sudo dpkg -i ardexa_${VERSION}_${ARCH}-${DEVICE_NAME}.deb

The Ardexa Agent will now be installed and if you are already connected to the internet you should see the agent come online within a few seconds.

If the agent does not come online within one minute, please refer to the Troubleshooting guide.

Checking and Verifying the Agent

NOTE: Ensure your device is connected either via an ethernet cable or via WiFi.

Post configuration of your Device, the Ardexa Agent will come online and appear in your Workgroup in the Ardexa cloud application. The figure below shows how to identify whether a device is on or offline. If for some reason you find the agent is not available then please follow our troubleshooting guide or otherwise reach out to our support team here.

Last updated