Upgrade the Microsoft Defender for IoT micro agent

Alt
08/01/2024

This article describes how to upgrade a Microsoft Defender for IoT micro agent with the latest software version.

For more information, see our release notes for device builders.

Note

Defender for IoT plans to retire the micro agent on August 1, 2025.

Upgrade a micro agent from version 4.2.* to 4.6.2

When upgrading the micro agent from version 4.2.* to 4.6.2, you would first need to remove the package and then reinstall it.

Standalone micro agent:

Remove the current package. Run:

sudo apt-get remove defender-iot-micro-agent

Ensure that you've upgraded the apt. Run:
```
sudo apt-get update
```
Install the Defender for IoT micro agent on Debian or Ubuntu-based Linux distributions. Run:
```
sudo apt-get install defender-iot-micro-agent
```

Micro agent for Edge:

Remove the current package. Run:

sudo apt-get remove defender-iot-micro-agent-edge

Ensure that you've upgraded the apt. Run:
```
sudo apt-get update
```
Install the Defender for IoT micro agent on Debian or Ubuntu-based Linux distributions. Run:
```
sudo apt-get install defender-iot-micro-agent-edge
```

Upgrade a standalone micro agent

Ensure that you've upgraded the apt. Run:
```
sudo apt-get update
```
Install the Defender for IoT micro agent on Debian or Ubuntu-based Linux distributions. Run:
```
sudo apt-get install defender-iot-micro-agent
```

Upgrade a micro agent for Edge

Ensure that you've upgraded the apt. Run:
```
sudo apt-get update
```
Install the Defender for IoT micro agent on Debian or Ubuntu-based Linux distributions for Edge. Run:
```
sudo apt-get install defender-iot-micro-agent-edge
```

Upgrade a standalone micro agent from a legacy version

This section is relevant specifically when upgrading a micro agent from version 3.13.1 or lower to version 4.1.2 or higher.

In version 4.1.2, the standalone micro agent directory changed to align with standard Linux installation directory structures. This change requires customers to reauthenticate the micro agent and modify the connection string location.

Upgrade your micro agent as described above.
Reauthenticate your micro agent. For more information, see Authenticate the micro agent.

Install a specific version of the micro agent

Specify a version number in your command to install the specified micro agent version.

Use the following command syntax:

sudo apt-get install defender-iot-micro-agent=<version>

Next steps

For more information, see:

Comhroinn trí