Re-provisioning an agent

During the lifecycle of a robot, it is common to have to re-image or replace a robot. In those cases, it is important the robot be reprovisioned instead of being added as a new robot. Reprovisioning an agent ensures that new agent assumes the identity of the previous agent and hence the data will appear as though it is from the same device.

Prior to reprovisioning a device, ensure that the agent is either stopped or uninstalled.

🚧

Warning

Once you proceed with the reprovisioning flow, the current token will expire and the device will be invalidated and hence will stop ingesting data.

🚧

Warning

Do not perform reprovisioning over a port-forwarded SSH connection. The connection will be broken when the original token is revoked.

Step 1: Remove the current formant-agent installation

sudo apt remove formant-agent --purge

Step 2: Generate a new token

From the burger menu Settings ⇒ Devices ⇒ click three dots next to the device name ⇒ reprovision
Confirm that you want to proceed by clicking on OK. Copy the 1-liner and proceed to the next step.

Step 2: Run installation 1-liner on the device

Paste and run the installation script 1-liner to your robot's command line. It should look like this:

bash <(wget -qO - https://app.formant.io/install-agent.sh) <thisisthetoken>