Install the Raspbian Image

This is a guide on how to load the Ardexa Raspbian image onto a Raspberry Pi and install the Ardexa agent. Ardexa has developed a version of Linux for ARM (Raspbian) and x86 that is extremely reliable for IoT environments, and/or situations requiring little or no supervision.

Ardexa Devices provided for our enterprise customers come pre-installed with the ArdexaLinux Image.

Preparation

The pre-requisites for these instructions are the following:

1. A Raspberry Pi and power supply

2. Micro SD Card - Minimum Requirements: Class 10 (C10) - 4Gb

3. A micro SD Card adapter (for the micro SD card)

4. An Ethernet network with Internet connectivity and a DHCP Server

5. The Ardexa Raspbian Image, supplied by Ardexa. Latest version is: image_ArdexaLinux_10.2.1_rpi.zip

6. The password for the Ardexa Raspbian image, also provided by Ardexa

7. Access to the Ardexa Cloud, and permissions that enable you to create a new Device

If you don't have these, contact Ardexa.

Download the Etcher application

Go to https://etcher.io and download the etcher application for your environment. This tool helps you install the Ardexa Raspbian image onto an SD card.

Install Ardexa Raspbian

Connect the SD Card reader to your workstation, and insert the microSD card, using the SD card adapter. An SD card adapter is a 'holder' for the micro SD card, as shown in this video: https://www.youtube.com/watch?v=pM3rLuvOr8s

Start the etcher application that was previously downloaded. Then follow these three steps:

1. Select the Ardexa Raspbian image,

2. Select the SD card; and then

3. Flash!

This will write the image to the SD card, and should take about 5 to 10 minutes.

Installing The Raspberry Pi on to the Network

Once the above has been done, then:

1. Insert the SD card in the Pi

2. Plug in an Ethernet cable (Assuming you have a DHCP server on your network)

3. Plug in the power to the Pi, mouse and keyboard, and a HDMI screen

The Ardexa Raspbian image has been designed to automatically connect to a network using DHCP. So when you see the login prompt, it should already have connected, so long as DHCP is available.

When prompted to login ("raspberrypi login:"), login using the credentials (case sensitive):

1. userid: ardexa

2. password: PROVIDED BY ARDEXA

UNO220 ONLY: Enable additional drivers

The UNO220 requires one additional step to enable all the features provided by the case/hat. Please run

sudo uno220 enable

This can be done from the console, or using REMOTE SHELL. Please reboot the machine after you have run this command.

Create a new device in the Ardexa Cloud

See Install for more information on installing the Ardexa Agent.

1. Go to the Devices page in the Ardexa Cloud

2. Click the New Device button

3. Enter a name for your new device. Set the Device type "Raspberry Pi (Zero, 1, 2 and 3)" (important):

   
4. Click Create. The agent pack will be downloaded by your browser. If you performed this step on another device, copy the agent pack to your Raspberry Pi using a USB device.

5. Run the following commands on the Raspberry Pi in the directory where the agent pack is located. Make sure to substitute the variable elements (${WORKGROUP_ID} etc) as each agent pack is unique to your workgroup and device.

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

Once this is done, the Raspberry Pi will connect to the Ardexa cloud.