Workspace Environment Management

Configure automatic agent upgrade

As an administrator using Workspace Environment Management (WEM) to manage workspaces, you might want to ensure that you are always using the latest WEM agents to take advantage of new features with each upgrade. However, upgrading non-persistent machines causes the upgrades to be reverted after those machines restart. WEM provides you with an automatic agent upgrade feature, letting you schedule automatic upgrades for the WEM agents while ensuring that non-persistent machines are not affected.

The procedure for configuring the feature is as follows:

  1. Enable automatic agent upgrade
  2. Configure SMB shares (optional)

Prerequisites

Before you start, do the following (needed only when you want to configure SMB shares):

  • Prepare a file share that the WEM agent can access. Using a file share can significantly reduce traffic on networks and reduce the time to download the agent package.

Enable automatic agent upgrade

The following information is supplemental to the guidance in Agent settings. To enable automatic agent upgrade, follow the general guidance in that article, minding the details below.

  1. In the web console, go to Advanced Settings > Agent Settings under the relevant configuration set and select Enable automatic upgrade.

    Agent upgrade

  2. Select a version to upgrade the agent to, set a time range for the upgrade, and choose whether to apply the upgrade only to persistent machines.

    Note:

    To keep the agent up to date, select Latest version. Upgrades applied to non-persistent machines are reverted after the machines restart. We recommend applying agent upgrades only to persistent machines.

    Enable automatic upgrade

  3. Choose whether to allow users to upgrade agent manually.

Configure SMB shares (optional)

Using SMB shares reduces traffic on networks and reduces the time to download the agent package. The following information is supplemental to the guidance in File shares. To configure SMB shares, follow the general guidance in that article, minding the details below.

  1. In the web console, go to Advanced Settings > File Shares under the relevant configuration set and add the SMB share you prepared.

    Add SMB share

    If you are using Azure File shares, you can find the SMB share path and the credentials as follows:

    • In the Azure portal, go to the storage account you created and navigate to File shares.

      File Shares in Azure portal

    • Click Connect. You can then find the SMB share path and credentials in the script.

      Connect in Azure portal

  2. Select the SMB share that you want the agent upgrade feature to use.

    Select SMB share for agent upgrade

Configure automatic agent upgrade