This page provides information on how to add and remove Octave edge devices in your Octave deployment.

Adding an Octave Edge Device to Your Deployment

Follow the steps below to add an Octave edge device to your Octave deployment:

1. Access the Activate a Device screen using one of the following methods:

• Navigate to Build > Device > Details, click on the Device dropdown, and click Add Device:

• Navigate to Deploy & Monitor > Devices and click Add Device:

2. Follow the steps on the Activate a Device screen:

Add Multiple Devices to Your Deployment in Bulk

Follow the steps below to add multiple Octave edge devices to your Octave deployment in bulk:

1. Navigate to Deploy & Monitor > Devices, click the dropdown beside Add Device, and select Import devices:

2. Perform one of the following steps:

• Manually enter the information for each device and click Import:

• Drag or click (1) to upload a CSV file containing the information for up to 500 devices to import and then click Import (2):

• (Optional): Click the question mark (3) to display information about the CSV format along with some example data. You can copy the example data to the clipboard by clicking the clipboard icon (4):

The CSV file must be formatted as shown in the following example:

The following table describes each column in the CSV file:

📘

Notes

Octave allows you to display certain devices in your deployment on the import screen which can be useful when putting together the list of devices to import and avoids the need to return to the main device listing screen:

• Use the filter field near the top-right corner of the screen to display all existing devices in the deployment which have a name containing the value entered in the filter field.
• Enable Only devices with errors to show all devices in the deployment which have some sort of error (e.g., inconsistent format, duplicate names, etc…).

Remove an Octave Edge Device from Your Deployment

Follow the steps below to remove an Octave edge device to your Octave deployment:

1. Navigate to Build > Device > Details.
2. Select the device to delete from the Device dropdown.
3. Click on the gateway icon to display a dropdown showing the device's properties.
4. Click Remove device.

🚧

Device local configuration

Removing a device does not reset it. If you add it again, a Blueprint or a Configuration must be applied, otherwise the device will use the previous configuration.

📘

Note

After removing a device you can always add the device back in.

📘

Note

When a device is deleted and added again or moved from one company to another, the device should be power cycled for its Resources to show up properly (i.e., if the device remains powered on during the migration, it will not properly appear in Octave with its full Resource tree until the device is power cycled).

This can be done by physically rebooting the device or by sending a reboot command by writing an Event with: {"elems": { "/util/reboot/trigger": 1 }} to the device /:command Stream.

Adding and Removing Devices Programmatically

You can use the following endpoints from Octave's REST API to programmatically add and remove devices:

• POST /device/provision: adds a single device.
• POST /device/provision/bulk: adds multiple devices in bulk by uploading a CSV file of device information.

The following values can be returned in the body.state field of the response:

• DELETE /device/<device ID>: removes a single device.

After adding devices to the Octave programmatically, you will usually want to fully configure them right after, in a programmatic manner as well. The key steps are:

• Applying Tags to the devices (if not yet done through the Bulk import)
• Applying Blueprints to devices