Configure optical drive devices

Updated at:

To use an optical drive peripheral in a cloud computer, both an administrator and an end user must complete specific configurations. The administrator configures policies in the console, while the end user configures their terminal and the cloud computer.

Get peripheral information

For USB peripherals, you need the VID (Vendor ID) and PID (Product ID), which are required when you configure peripheral policies. Both VID and PID are hexadecimal values, such as 0xa12c, where the 0x prefix is typically optional. You can look up the VID and PID of a connected USB peripheral in several ways.

Important

The availability of peripheral devices on a cloud computer depends on multiple factors, including the type and version of the Alibaba Cloud Workspace terminal, the cloud computer image type and version, the type and version of the local device running the Alibaba Cloud Workspace client, and the brand and model of the peripheral device. You can visit the peripheral compatibility page to check whether a specific peripheral is compatible with a cloud computer. The data on this page was obtained under laboratory conditions and may differ from actual results.

From the Alibaba Cloud Workspace terminal

  1. Open and log on to the Alibaba Cloud Workspace client.

  2. In the upper-right corner of the client, click the icon, and then select Settings.

  3. In the left-side navigation pane of the Settings window, click Peripherals, and then view the VID and PID of the USB peripheral on the Local USB Peripherals panel.

From the computer's device manager

You can find the VID and PID of a peripheral in the device management information on your computer.

Windows

  1. In the Start menu, search for and open Device Manager.

  2. In the Device Manager window, navigate to , and then double-click the USB device you want to look up.

  3. On the Details tab of the properties dialog box, select Hardware Ids from the Property drop-down list. The VID and PID are displayed in the text box below.

macOS

  1. In the system menu bar, choose , and then click More Info in the dialog box.

  2. At the bottom of the About This Mac panel, click System Report.

  3. In the left-side navigation pane of the new window, choose Hardware > USB, select the USB device you want to look up in the right-side panel, and then view the VID and PID below.

From the floating menu

  1. Click the floating menu and select Peripherals & Printers.

  2. On the Advanced Management tab, view the VID and PID of the USB peripheral in the device list.

Use a third-party tool

You can use the USB Device Tree Viewer tool to view peripheral information. This tool supports only Windows.

  1. Download the tool: https://www.uwe-sieber.de/usbtreeview_e.html#download.

  2. Extract the downloaded package, and then double-click UsbTreeView.exe to open it.

  3. In the left-side directory of the tool, select the USB device you want to look up, and then view the VID and PID in the Device ID section of the right-side panel.

WUYING hardware terminal

When you use a cloud computer with a WUYING hardware terminal, such as a WUYING Cube, WUYING Cube Pro, or WUYING All-in-One 23.8, both administrators and end users must complete the following configuration steps.

Administrator: configure peripheral policies

Peripheral management policies are part of the cloud computer policy, and must be created and maintained by an administrator in the console.

Note

The following examples use the EDS Enterprise Edition console. For the Business Edition procedure, see Manage policies.

General procedure for creating or modifying peripheral policies

Create a custom policy and associate it with a cloud computer

By default, a newly created cloud computer is associated with the system-generated default policy. Because the default policy cannot be modified, the administrator must create a custom cloud computer policy in the console and associate it with the cloud computer.

  1. Log on to the EDS enterprise console.

  2. In the left-side navigation pane, choose O&M > Policies.

  3. On the Policies page, click Create Policy.

  4. On the Create Policy page, enter a Policy Name as prompted, modify the policy settings as needed, and then click OK.

    After the policy is created, you can view it in the list on the Policies page.

  5. In the left-side navigation pane, choose Resource Management > EDS Enterprise.

  6. On the EDS Enterprise page, perform one of the following operations as needed:

    • Single operation: Find the target cloud computer, click More in the Actions column, and then select Change Policy.

    • Batch operation: Select one or more cloud computers, and then choose More > Change Policy at the bottom of the page.

  7. On the Required Policy tab of the Change Policy panel, click Change Policy, select the custom policy you created, and then click OK.

    Note

    If the resource group to which the cloud computer belongs already has an associated policy, you cannot directly change the policy for the cloud computer here. You can either change the policy associated with the resource group, or first remove the cloud computer from the resource group and then change its policy.

  8. At the bottom of the Change Policy panel, click OK, and then click Confirm Policy Change.

Modify a custom policy already associated with a cloud computer

If the cloud computer is already associated with a custom policy, the administrator can directly modify the policy in the console without re-associating it.

  1. Log on to the EDS enterprise console.

  2. In the left-side navigation pane, choose O&M > Policies.

  3. On the Policies page, find the custom policy you want to modify, and then click Modify Policy in the Actions column.

  4. On the Modify Policy page, modify the policy settings as needed, and then click OK.

Peripheral policy configuration

Enable local disk mapping
  • Configuration path: Peripheral Control > Local Disk Mapping > Local Disk Mapping.

  • Configuration requirements: Set Local Disk Mapping to Read/Write or Read-only.

    item_local_disk_mapping

Enable USB redirection
  • Method 1: Globally enable USB redirection

    • Configuration path: Peripheral Control > Peripheral Redirection > USB Redirection.

    • Configuration requirements: Turn on the USB Redirection switch.

      item_usb_redirection_toggle

  • Method 2: Enable USB redirection for specific USB devices by using a peripheral whitelist

    After you globally enable USB redirection, all USB devices can connect to the cloud computers associated with the policy. If you do not want all USB devices to connect to the cloud computers associated with the policy, you can turn off the USB Redirection switch and enable USB redirection for specific USB devices by adding a peripheral whitelist.

    • Configuration path: Peripheral Control > Peripheral Blacklist/Whitelist > Add Rule.

    • Configuration requirements: Enter the device name, VID, PID, and set Blacklist/Whitelist to Whitelist.

      item_peripheral_whitelist

Custom peripheral rule

To prevent end users from configuring incorrectly on the client, administrators can create custom peripheral rules in the cloud computer policy. These rules have higher priority than the custom configurations specified by end users on the client. For information about the priority of peripheral policies in different dimensions, see Policy priority.

  • Configuration path: Peripheral Control > Peripheral Management Rule > Add Custom Peripheral Rule.

  • Setting: Set Device Type to Optical Drive, enter the device name, VID, and PID, and set Redirect Mode to USB Redirection.

End user: configure and use peripherals

Connect the peripheral

You must connect peripherals to the on-premises computer running the Alibaba Cloud Workspace client before you can connect the peripherals to a cloud computer.

When you connect a cloud computer to a peripheral for the first time, a connection configuration dialog box appears in the lower-right corner of the cloud computer desktop. In the dialog box, you can select the device type, specify whether to turn on auto-connect, and specify whether to remember the current configurations.

Windows client

When you use a cloud computer with the Windows client, both administrators and end users must complete the following configuration steps.

Administrator: configure peripheral policies

Peripheral management policies are part of the cloud computer policy, and must be created and maintained by an administrator in the console.

Note

The following examples use the EDS Enterprise Edition console. For the Business Edition procedure, see Manage policies.

General procedure for creating or modifying peripheral policies

Create a custom policy and associate it with a cloud computer

By default, a newly created cloud computer is associated with the system-generated default policy. Because the default policy cannot be modified, the administrator must create a custom cloud computer policy in the console and associate it with the cloud computer.

  1. Log on to the EDS enterprise console.

  2. In the left-side navigation pane, choose O&M > Policies.

  3. On the Policies page, click Create Policy.

  4. On the Create Policy page, enter a Policy Name as prompted, modify the policy settings as needed, and then click OK.

    After the policy is created, you can view it in the list on the Policies page.

  5. In the left-side navigation pane, choose Resource Management > EDS Enterprise.

  6. On the EDS Enterprise page, perform one of the following operations as needed:

    • Single operation: Find the target cloud computer, click More in the Actions column, and then select Change Policy.

    • Batch operation: Select one or more cloud computers, and then choose More > Change Policy at the bottom of the page.

  7. On the Required Policy tab of the Change Policy panel, click Change Policy, select the custom policy you created, and then click OK.

    Note

    If the resource group to which the cloud computer belongs already has an associated policy, you cannot directly change the policy for the cloud computer here. You can either change the policy associated with the resource group, or first remove the cloud computer from the resource group and then change its policy.

  8. At the bottom of the Change Policy panel, click OK, and then click Confirm Policy Change.

Modify a custom policy already associated with a cloud computer

If the cloud computer is already associated with a custom policy, the administrator can directly modify the policy in the console without re-associating it.

  1. Log on to the EDS enterprise console.

  2. In the left-side navigation pane, choose O&M > Policies.

  3. On the Policies page, find the custom policy you want to modify, and then click Modify Policy in the Actions column.

  4. On the Modify Policy page, modify the policy settings as needed, and then click OK.

Peripheral policy configuration

Enable local disk mapping
  • Configuration path: Peripheral Control > Local Disk Mapping > Local Disk Mapping.

  • Configuration requirements: Set Local Disk Mapping to Read/Write or Read-only.

    item_local_disk_mapping

Enable USB redirection
  • Method 1: Globally enable USB redirection

    • Configuration path: Peripheral Control > Peripheral Redirection > USB Redirection.

    • Configuration requirements: Turn on the USB Redirection switch.

      item_usb_redirection_toggle

  • Method 2: Enable USB redirection for specific USB devices by using a peripheral whitelist

    After you globally enable USB redirection, all USB devices can connect to the cloud computers associated with the policy. If you do not want all USB devices to connect to the cloud computers associated with the policy, you can turn off the USB Redirection switch and enable USB redirection for specific USB devices by adding a peripheral whitelist.

    • Configuration path: Peripheral Control > Peripheral Blacklist/Whitelist > Add Rule.

    • Configuration requirements: Enter the device name, VID, PID, and set Blacklist/Whitelist to Whitelist.

      item_peripheral_whitelist

Custom peripheral rule

To prevent end users from configuring incorrectly on the client, administrators can create custom peripheral rules in the cloud computer policy. These rules have higher priority than the custom configurations specified by end users on the client. For information about the priority of peripheral policies in different dimensions, see Policy priority.

  • Configuration path: Peripheral Control > Peripheral Management Rule > Add Custom Peripheral Rule.

  • Setting: Set Device Type to Optical Drive, enter the device name, VID, and PID, and set Redirect Mode to USB Redirection.

End user: configure and use peripherals

Install UsbDk

Note

You need to install UsbDk on the local Windows computer only when you use Windows client and access peripherals through USB redirection. UsbDk is not required in other scenarios.

UsbDk (USB Development Kit) is an open-source driver library for Windows that provides applications with direct and exclusive access to USB devices. It is essential for USB peripherals to function properly on a cloud computer. The Windows client installer includes UsbDk installation. If you skipped this step during installation, peripheral issues may occur. Follow these steps to reinstall UsbDk.

  1. Open the Alibaba Cloud Workspace client download page and download the latest version of Windows client.

  2. Double-click the installer to run it. On the Select Components screen, make sure to select UsbDk Runtime Libraries, and then follow the prompts to complete the installation.

  3. Restart your computer after installing UsbDk Runtime Libraries.

Connect the peripheral

You must connect peripherals to the on-premises computer running the Alibaba Cloud Workspace client before you can connect the peripherals to a cloud computer.

When you connect a cloud computer to a peripheral for the first time, a connection configuration dialog box appears in the lower-right corner of the cloud computer desktop. In the dialog box, you can select the device type, specify whether to turn on auto-connect, and specify whether to remember the current configurations.

macOS client

When you use a cloud computer with the macOS client, both administrators and end users must complete the following configuration steps.

Administrator: configure peripheral policies

Peripheral management policies are part of the cloud computer policy, and must be created and maintained by an administrator in the console.

Note

The following examples use the EDS Enterprise Edition console. For the Business Edition procedure, see Manage policies.

General procedure for creating or modifying peripheral policies

Create a custom policy and associate it with a cloud computer

By default, a newly created cloud computer is associated with the system-generated default policy. Because the default policy cannot be modified, the administrator must create a custom cloud computer policy in the console and associate it with the cloud computer.

  1. Log on to the EDS enterprise console.

  2. In the left-side navigation pane, choose O&M > Policies.

  3. On the Policies page, click Create Policy.

  4. On the Create Policy page, enter a Policy Name as prompted, modify the policy settings as needed, and then click OK.

    After the policy is created, you can view it in the list on the Policies page.

  5. In the left-side navigation pane, choose Resource Management > EDS Enterprise.

  6. On the EDS Enterprise page, perform one of the following operations as needed:

    • Single operation: Find the target cloud computer, click More in the Actions column, and then select Change Policy.

    • Batch operation: Select one or more cloud computers, and then choose More > Change Policy at the bottom of the page.

  7. On the Required Policy tab of the Change Policy panel, click Change Policy, select the custom policy you created, and then click OK.

    Note

    If the resource group to which the cloud computer belongs already has an associated policy, you cannot directly change the policy for the cloud computer here. You can either change the policy associated with the resource group, or first remove the cloud computer from the resource group and then change its policy.

  8. At the bottom of the Change Policy panel, click OK, and then click Confirm Policy Change.

Modify a custom policy already associated with a cloud computer

If the cloud computer is already associated with a custom policy, the administrator can directly modify the policy in the console without re-associating it.

  1. Log on to the EDS enterprise console.

  2. In the left-side navigation pane, choose O&M > Policies.

  3. On the Policies page, find the custom policy you want to modify, and then click Modify Policy in the Actions column.

  4. On the Modify Policy page, modify the policy settings as needed, and then click OK.

Peripheral policy configuration

Enable local disk mapping
  • Configuration path: Peripheral Control > Local Disk Mapping > Local Disk Mapping.

  • Configuration requirements: Set Local Disk Mapping to Read/Write or Read-only.

    item_local_disk_mapping

Enable USB redirection
  • Method 1: Globally enable USB redirection

    • Configuration path: Peripheral Control > Peripheral Redirection > USB Redirection.

    • Configuration requirements: Turn on the USB Redirection switch.

      item_usb_redirection_toggle

  • Method 2: Enable USB redirection for specific USB devices by using a peripheral whitelist

    After you globally enable USB redirection, all USB devices can connect to the cloud computers associated with the policy. If you do not want all USB devices to connect to the cloud computers associated with the policy, you can turn off the USB Redirection switch and enable USB redirection for specific USB devices by adding a peripheral whitelist.

    • Configuration path: Peripheral Control > Peripheral Blacklist/Whitelist > Add Rule.

    • Configuration requirements: Enter the device name, VID, PID, and set Blacklist/Whitelist to Whitelist.

      item_peripheral_whitelist

Custom peripheral rule

To prevent end users from configuring incorrectly on the client, administrators can create custom peripheral rules in the cloud computer policy. These rules have higher priority than the custom configurations specified by end users on the client. For information about the priority of peripheral policies in different dimensions, see Policy priority.

  • Configuration path: Peripheral Control > Peripheral Management Rule > Add Custom Peripheral Rule.

  • Setting: Set Device Type to Optical Drive, enter the device name, VID, and PID, and set Redirect Mode to USB Redirection.

End user: configure and use peripherals

Connect the peripheral

You must connect peripherals to the on-premises computer running the Alibaba Cloud Workspace client before you can connect the peripherals to a cloud computer.

When you connect a cloud computer to a peripheral for the first time, a connection configuration dialog box appears in the lower-right corner of the cloud computer desktop. In the dialog box, you can select the device type, specify whether to turn on auto-connect, and specify whether to remember the current configurations.

Troubleshooting