What's in the release notes?

Workspace ONE Assist for Linux Release Notes provides information on the features of the Workspace ONE Assist for Linux releases.

Workspace ONE Assist is a Remote Access solution to empower your IT and Help desk staff to troubleshoot and fix device issues in real-time, directly from the Workspace ONE Console with tools like File Manager and Remote Shell. Console users can now experience the same consistent workflow available on other platforms like Android, Windows 10, and macOS, now on Linux.

To provision a Linux device with Assist, install the Workspace One Assist agent on a Workspace ONE managed Linux device.

Workspace ONE Assist 22.07 - July 2022

New Features

The following functionalities are available in this release:

  • Ability to manage the file system on the remote device using the File Manager Tool.
  • Ability to run commands on the remote device using the Remote Shell Tool.
  • Role based access controls to File manager and Remote shell functionality.

Note:

  • Linux support in Workspace ONE Unified Endpoint Management (UEM) is only available for SaaS customers currently will be deployed to SaaS environments in phases.
  • Assist is currently only available on SystemD Linux devices and SystemV devices are not yet supported.
  • For more information on Linux device management, please refer to the following Product announcement: https://kb.vmware.com/s/article/2961324?lang=en_US
  • Please refer to this KB article for more details: https://via.vmw.com/linux_rollout_kb

Minimum Requirements

Listed are the minimum requirements:

  • Workspace ONE Assist Console - 21.09
  • Workspace ONE UEM 2109
  • Linux  x64, ARM5, or ARM7 architecture
  • Linux installer files of deb, rpm, and tgz are available
  • Latest versions of Chrome, Edge, Firefox, or Safari
  • Workspace ONE Intelligent Hub 1.0 for Linux

The following client packages are available various flavours of Linux.

  • linux-x64 (Most desktop distributions like CentOS, Debian, Fedora, Ubuntu, and derivatives)
  • linux-arm (Linux distributions running on ARM like Raspbian on Raspberry Pi Model 2+)
  • linux-arm64 (Linux distributions running on 64-bit ARM like Ubuntu Server 64-bit on Raspberry Pi Model 3+)

Current Limitations

  • Assist sessions on Linux devices will support Unattended access only in this release. The ability to view and control a device screen will be introduced in upcoming releases.
  • Assist is currently only available on SystemD Linux devices and SystemV devices are not yet supported.

Resolved Issues

  • AET-8499: Added support for .NET6

Known Issues

We haven’t identified any notable known issues in this release. If you are facing any problems, feel free to reach out to our support team.

Workspace ONE Assist 21.11 - November 2021

New Features

The following functionalities are available in the 21.11 release:

  • Ability to manage the file system on the remote device using the File Manager Tool.
  • Ability to run commands on the remote device using the Remote Shell Tool.
  • Role-based access controls to File manager and Remote shell functionality.

Note:

  • Linux support in Workspace ONE Unified Endpoint Management (UEM) available only for SaaS customers currently will be deployed to SaaS environments in phases.
  • Assist is currently only available on SystemD Linux devices and SystemV devices are not yet supported.
  • For more information on Linux device management, please refer to the product announcement, https://kb.vmware.com/s/article/2961324?lang=en_US
  • Please refer to the knowledge base article for more details, https://via.vmw.com/linux

Minimum Requirements

Listed are the minimum requirements:

  • Workspace ONE Assist Console - 21.09
  • Workspace ONE UEM 2109
  • Linux  x64, ARM5, or ARM7 architecture
  • Linux installer files of deb, rpm, and tgz are available
  • Latest versions of Chrome, Edge, Firefox, or SafariWorkspace ONE Intelligent Hub 1.0 for Linux

The following client packages are available in various flavors of Linux.

  • linux-x64 (Most desktop distributions like CentOS, Debian, Fedora, Ubuntu, and derivatives)
  • linux-arm (Linux distributions running on ARM like Raspbian on Raspberry Pi Model 2+)
  • linux-arm64 (Linux distributions running on 64-bit ARM like Ubuntu Server 64-bit on Raspberry Pi Model 3+)

Current Limitations

Assist sessions on Linux devices will support Unattended access only in this release

The ability to view and control a device screen will be introduced in upcoming releases.Assist is currently only available on SystemD Linux devices, and SystemV devices are not yet supported.

Download Instructions

To remotely manage a Linux or Linux based IoT device, you must install the Workspace ONE Assist application on an already Linux device already enrolled in UEM.

You can install the Assist application by following one of the below methods. Once the Assist application is installed on the Linux device, you will need to register it to the Workspace ONE Assist server. You can verify the status of the registration by navigating to the Device detailed view -> More -> Troubleshooting -> Event Logs.

Installation Method 1:

Install the Workspace ONE Assist agent on the remote Linux device using a WS1 Custom Configuration Profile which uses Puppet manifests.

  1. On the Workspace ONE UEM console navigate to Profiles and Baselines-> Profiles to add a new Custom Configuration profile. Depending on the UEM version the Profiles tab would be present either in Resources or in Devices.
  2. Create a new Linux Profile or update an existing one to add a new custom configuration for Workspace ONE Assist. 
  3. On the Custom Configuration page, enter a name and create a puppet manifest to install the Assist application on your Linux devices. We have provided a sample manifest in the readme file and with the product that can be modified and used if desired.
  4. Once the Custom Configuration is added, Save and Publish the Linux profile to your Linux devices.

Installation Method 2:

If you have physical access to the Linux device, install the Assist Agent manually using this method.

  1. On the Linux device, open a browser and navigate to the VMware Workspace ONE Resource Portal and download the Workspace ONE Assist agent directly on the Linux device. Alternative methods of copying the agent to the linux device would also work.
  2. Extract the Package in the Linux device. You can use the command to extract.
    $ tar xvf ws1-assist__21.11.00.74release_linux-<arch>.tar.gz
  3. Change directory using the command:
    $ cd ws1-assist_21.11.00.74_release_linux-<arch>
  4. Install the package using the command:
    $ sudo ./install.sh

Support Contact Information

To receive support, submit a ticket with the My Workspace ONE portal or call your local support line.

check-circle-line exclamation-circle-line close-line
Scroll to top icon