Devices

Device Management & Maintenance

The Devices page provides a variety of functions for managing and maintaining devices connected to the Ardexa Cloud.

Device state

Devices will display various state indicators to inform you about errors or conditions you need to be aware of.

Offline

Device is not connected to the cloud

Configuration error

There is a configuration error and the device is in "fallback" mode

Certificate error

The certificate has expired and needs to be updated immediately. Also shown is the Offline icon

Cloud Device Icon

The "CD" indicates this is a Cloud Device icon

Device actions

Refresh Metadata

This action forces the Ardexa agent on the device to reprocess scenario metadata and re-synchronise with the cloud.

Send ArdexaControl

ArdexaControl is a utility script used by some Ardexa Cloud functions.

Reissue certificate

This option enables a device's certificate to reissued. Selecting it will open a dialog with the following options:

Immediately deploy the updated certificate to the device

This option is available only for devices that are currently online. The new certificate will be issued and sent directly to the device by the Ardexa Cloud.

Download a certificate pack

This option will download the new certificate, private key and certificate authority chain file as a zip archive. This certificate pack can then be deployed to a device manually. Using this option can help recover a device that has lost connection to the Ardexa Cloud, provided you have another means of accessing the device.

Download a complete Agent Pack

This option will download a complete Agent Pack, containing the Agent binary and certificate pack in a single archive. This will need to be manually deployed to the machine. Using this option is best for replacing a broken/retired device with a new physical edge device.

Move device

This function allows a device to be given a new identity, potentially in a new workgroup. All of these options work by replacing the certificate on the selected device with a new one.

To use this function you will need permissions to Manage Devices in the target workgroup.

Note: each of these options uses ArdexaControl to provide fallback logic in case the device is unable to connect to the Ardexa Cloud using the new identity. This is implemented by restoring the original certificate. After moving a device it should be kept powered on for two minutes to ensure that the new identity is maintained after the device is rebooted.

New

This option creates a new device identity in the selected workgroup, then automatically updates the selected device to assume this identity.

Browse

This option allows you to move the current device to assume the identity of an existing device in another workgroup. To do this, type the target device's name into the filter, select it from the search results table and click MOVE.

Certificate

This option allows you to upload a certificate pack from an existing device in the Ardexa Cloud. This can be obtained by either creating a new device or reissuing a certificate and downloading the certificate pack.

Remove

This action will remove the device from the Ardexa Cloud. As this is a sensitive action, you will be asked to type the device's name to confirm.

If a device is deleted accidentally, please contact your Account Manager or [e-mail] to restore it.

Device functions

Selecting a device from the list will display a list of tabs used to access additional device functions:

General Info

This tab displays device metadata and images. See General Info for more details.

Remote Shell

This tab enables remote shell access to a device. See Remote Shell for more details.

File Transfer

This tab enables secure file transfers to and from connected devices. See File Transfer for more details.

Machine Plugins

The Machine Plugins tab enables you to manage plugins: applications which read data from connected equipment, implement control and support management of devices.

Manual Configuration

The Manual Configuration tab provides detailed information about the device and the data it collects.

Live Feed

The Live Feed tab allows you to view a live stream of data collected by the device.

Network Settings

The Network Settings tab enables management of network settings on devices.

See here for information on managing edge device network settings, and here for Cloud Devices.

Discovery

The Discovery tab enables you to scan local and external networks connected to the device.

Commands

The Commands tab allows privileged users to define predefined commands that can be run by other users.

Tunnel

The Tunnel tab enables you to interact with network devices and/or services connected to the Ardexa device via Ardexa Remote.