Upgrade Workspace Agent to Universal Agent

There are several notable differences between the Universal Agent and the Workspace Agent, which are described in detail in this article.
We recommend you read this article in full before upgrading the Agent.

The Universal Agent installer is capable of upgrading a device with Workspace Agent already installed, and it will automatically remove Workspace Agent before installing the necessary Universal Agent files.

Read Installation to learn more about how to change the upgrade behaviour of the installer described below.

Configuration

The Universal Agent uses a new configuration format stored as Agent.json as opposed to the Agent.xml file that is used by the Workspace Agent.
The default behaviour of the installer is to migrate the existing Agent.xml to the new JSON format during installation.

The related MSI property is OVERRIDE_CONFIG.

Cache

The Universal Agent has a new cache location to which the installer will move the existing cache of the Workspace Agent primary zone.
The cache of other zones will be deleted.

The related MSI property is MIGRATE_CACHE.

Database

The Universal Agent uses a new database format to which the installer will import the state of the existing package execution from the Workspace Agent.

The related MSI property is MIGRATE_DATABASE.

Offline mode

When upgrading to the Universal Agent, the offline mode will not be available until a successful refresh is completed after the upgrade.