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
:
2. Create the mount point:
3. Mount
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
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.
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>
.
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.
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