Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Dell Financial Services Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Carts

Dell ThinOS Installation and ThinOS Activation License User Guide

PDF

Use Wyse Management Suite to deploy ThinOS to an Ubuntu system with Dell Client Agent (DCA) enabler

Prerequisites

  • Ensure that the DCA enabler version 1.5.0-14 or later is installed.
  • Verify if the DCA enabler is installed by logging in to the Ubuntu device, and checking if the folder /etc/dcae exists. If yes, the DCA enabler is installed.
  • Verify the DCA enabler version by opening a terminal window and running the command cat /var/log/dcae/dcae.log
  • If the DCA enabler is not installed, follow these steps to manually install the DCA enabler:
    • Download the DCA Enabler driver package from the Wyse Management Suite page at Support | Dell.
    • Extract the package until you see the files dca-enabler_x.x_amd64.deb and dca-enabler-packages_x.x_amd64.deb
    • Install the DCA enabler files by logging into the Ubuntu device, opening a terminal session, locating the DCA enabler packages folder, and running the following commands. Edit the DCA version numbers as per your requirement.
      • sudo dpkg -i < dca-enabler-packages_x.x_amd64.deb <Enter>
      • sudo dpkg -i < dca-enabler_x.x_amd64.deb <Enter>
    Figure 1. Run the commands in a Terminal session. Run the commands in a Terminal session
    Run the commands in a Terminal session
  • Ensure that the Ubuntu device is registered with the Wyse Management Suite server.
  • If DHCP Option Tags/DNS SRV records have been configured to advertise the Wyse Management Suite server, the Ubuntu device automatically discovers and registers with the server.
  • If not, you can follow these steps to manually register with the Wyse Management Suite server.

    If you have installed DCA enabler version 1.7.0-20 or later:

    • Open DCA Enabler.
    • Enter the WMS Server and Group Token.
    • Enable or disable CA Validation that is based on your Wyse Management Suite server license type.
    • Click Register. The device attempts to register with the Wyse Management Suite server and after registration, the device is listed as Type = Generic Client.

    If you have installed DCA enabler version 1.5.0-14 or 1.6.0-9:

    • Log in to the Wyse Management Suite server.
    • Go to the Portal Administration tab.
    • Under Console Settings > Generic Client Registration, locate your Wyse Management Suite group name.
    • According to your Wyse Management Suite settings, click Bootstrap or Bootstrap-HTTPS-no-CA-validation to download the configuration file.
    • Rename the file to reg.json.
      • If you do not have access to the Wyse Management Suite console, you can create the file using this syntax. Replace the content with values for your environment:

        {"ccm":{"ccmserver":"fqdn.of.your.wms.server","ccmport":"443","usessl":"true","mqttserver":"fqdn.of.your.mqtt.server","mqttport":"1883","grouptoken":"your.WMS.GroupToken" ,"isCaValidationOn":"false/true"} }}

      • Keep the syntax in lower case except as needed for the Wyse Management Suite group token.
      • There is no hyphen between the group prefix and group key.
    • Log in to the Ubuntu device.
    • Copy the reg.json file to the Ubuntu device.
    • Open a terminal session and go to the directory where the reg.json file is located.
    • Run the following command:
      • sudo cp reg.json /etc/dcae/config <Enter>
    • Restart the DCA enabler, open a terminal session, and enter the following command:
      • sudo systemctl restart dcae.service <Enter>
    • The device attempts to register with the Wyse Management Suite server and after registration, the device is listed as Type = Generic Client

Steps

  1. Log in to the Ubuntu device.
  2. Verify the DCA enabler using the steps mentioned above.
  3. Verify that the Ubuntu device is registered with the Wyse Management Suite server using the steps that are mentioned above.
  4. Verify the following on the Wyse Management Suite server:
    • Wyse Management Suite server is using a Pro license.
    • Wyse Management Suite server is version 4.0 or later.
    • Wyse Management Suite server has ThinOS Activation Licenses.
      NOTE:To check if the server has ThinOS Activation Licenses, go to WMS console > Portal Administration > Account > Subscription
  5. Upload the ThinOS Conversion installer file to Wyse Management Suite.
    To download the installer file, follow these steps:
    1. Go to Support | Dell
    2. In the Enter a Service Tag, Serial Number, Service Request, Model, or Keyword field, type the model number of your device. For example, Latitude 3440 or OptiPlex 7410 All-in-One.
    3. Select the product from the search results to load the product page.
    4. On the product support page, click Drivers & Downloads.
    5. Select the Operating System as ThinOS PCOIP.
    6. Select the Download Type as Operation Systems.
    7. Download the Conversion driver package. The package may be a ZIP file.
    8. Extract the package to get the ThinOS Conversion Installer file (DTOS_Ubuntu_Installer_x.x).
    9. Upload the installer to WMS Server > Apps & Data > App Inventory > Generic Client .
  6. Upload the ThinOS image file.
    To download the ThinOS image file, follow these steps:
    1. Go to Support | Dell
    2. In the Enter a Service Tag, Serial Number, Service Request, Model, or Keyword field, type the model number of your device. For example, Latitude 3420, or OptiPlex 7410 All-in-One.
    3. Select the product from the search results to load the product page.
    4. On the product support page, click Drivers & Downloads.
    5. Select the Operating System as ThinOS PCOIP.
    6. Select the Download Type as Operation Systems.
    7. Download the Conversion driver package. The package may be a ZIP file.
    8. Extract the package to get the ThinOS Image file (ThinOS_YYMM_x.x).
    9. Upload the ThinOS image to WMS Server >Apps & Data > OS Image Repository > ThinOS 9.x > Add Firmware file.
  7. Create the conversion app policy by following these steps:
    1. Go to WMS Server > Apps & Data > App Policies > Generic Client > Add Advanced Policy
    2. Populate the following fields:
      • Policy Name
      • Group
      • Task as Install Application
      • OS Type as Generic Client
      • Application:
        • Click Add app and select the ThinOS Conversion Installer file (DTOS_Ubuntu_Installer_x.x).
        • Click Add app again and select the ThinOS image file (ThinOS_YYMM_x.x).
      • Platform Filter as the platform you want to convert.
        NOTE:For ThinOS 2205, select all four Dell Latitude 3420 items in the dropdown list.
      • Apply Policy Automatically as Do not apply automatically.
    3. Click Save.
    4. Choose whether to schedule the job now or later.
  8. Once the Wyse Management Suite job begins, check the following client-side folders for activity:
    • /etc/dcae/upgrade: This folder is created once the client receives the Wyse Management Suite job. It is automatically deleted after installation.
    • /usr/dtos: This folder is created after the client receives the ThinOS Conversion Installer (DTOS_Ubuntu_Installer_x.x) file.
  9. Once the ThinOS image is successfully installed, the client reboots automatically.
  10. The conversion process is complete.
    NOTE:If ThinOS boots with a blue background and exhibits poor performance, reboot the device again.
    NOTE:A warning message Login is denied (ThinOS activation license is not available) may be displayed after connecting to a network.
    NOTE:After conversion, register the converted device with Wyse Management Suite. If required, the newly converted device downloads a ThinOS Activation License. If the conversion fails and the client does not boot, follow the steps in Install ThinOS from USB drive using Dell OS Recovery Tool

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\