Dell Wyse ThinOS 9.1.3129, 9.1.3112, 9.1.2101, and 9.1.1131 Administrator’s Guide

Create and import bulk device exception file

From Wyse Management Suite 3.1, you can deploy device exception configurations to multiple ThinOS 9.x devices.

1. Create a bulk device exception file. To create a file, do any of the following:
   • Create a group policy for a test group and then export that policy to a file. If the configuration contains passwords, they are replaced with * in the exported file. For example:

     {
         "WMSVersion": "4.6.8",
         "exportedDate": "1581466633677",
         "deviceTypes": [
             {
                 "type": 6,
                 "configurations": {
                     "version": "0.0.1",
                     "sequence": 1581466506281,
                     "parameters": {
                         "AdminModeUsername": {
                             "value": "admin",
                             "updatedAt": "1581466506234"
                         },
                         "AdminModePassword": {
                             "value": "********",
                             "updatedAt": "1581466506234"
                         },
                         "TerminalName": {
                             "value": "outpatient",
                             "updatedAt": "1581466506234"
                         },
                         "TimeServer": {
                             "value": "10.10.10.10",
                             "updatedAt": "1581466506234"
                         },
                         "timeZone": {
                             "value": "America/Phoenix",
                             "updatedAt": "1581466506234"
                         },
                         "TerminalNameCapital": {
                             "value": "yes",
                             "updatedAt": "1581466506234"
                         },
                         "DeviceNICDefault": {
                             "value": "Wlan",
                             "updatedAt": "1581466506234"
                         },
                         "AdminMode": {
                             "value": "yes",
                             "updatedAt": "1581466506234"
                         }
                     }
                 }
             }
         ]
     }

   • Create a .json file using the following format:

     {
     
     "devices": {
     
     <serialnumber>: {
     
     "parameters": {
     
     "<parametername>": {
     
            "value": <value>
     
     },
     
     "<parametername>": {
     
            "value": <value>
     
     }
     
     },
     
     configurations: [<configuration name>]
     
     }
     
     }
     
     "configurations": {
     
     <configurationName>: {
     
     "<parametername>": {
     
            "value": <value>
     
     },
     
     "<parametername>": {
     
            "value": <value>
     
     }
     
       }
     
     }
     
     }

     For example,

     {
         "devices": {
             "9EPDL900051": {
                 "parameters": {
                     "TerminalName": {
                         "value" : "Cubical 5 - Floor 3"
                     },
                     "TerminalNameCapital": {
                         "value": "no"
                     }
                 },
                 configurations: ["westWingExceptions"]
             },
             "5LGDO600108": {           
                 "parameters": {
                     "TerminalName": {
                         "value" : "Cubical 15 - Floor 2"
                     },
                     "TerminalNameCapital": {
                         "value": "no"
                     }
                 },
                 configurations: ["westWingExceptions"]
             }
         }, 
         "configurations": {
             "westWingExceptions": {
                 "DeviceNICDefault": {
                     "value": "Wlan"
                 },
                 "timeZone": {
                     "value": "America/Phoenix"
                 },
                 "TimeServer": {
                     "value": "10.10.10.10"
                 },
                 "TerminalNameCapital": {
                     "value": "yes"
                 },
                 "AdminMode": {
                     "value": "yes"
                 },
                 "AdminModeUsername": {
                     "value": "admin"
                 },
                 "AdminModePassword": {
                     "value": "password"
                 }
             }
         }
     }

2. Compress and encrypt the file.
   NOTE:You can use 7-zip software to compress and encrypt the file.

   NOTE:File size should not be more than 1 MB.
3. Go to Groups & Configs and click Import Policies.
   The Import Policies Wizard screen is displayed.
4. Select Bulk Device Exceptions.
5. Click Browse and select the password encrypted .zip file.
6. Click Next.
   Select the device type configurations to import page is displayed.
7. Click Next.
   NOTE:Since you can bulk import a device exception file for ThinOS 9.x devices, you cannot configure the options in the page.
8. Enter the .zip file password that was used to zip the .json file.
9. Click Next.
   A summary of the bulk device exceptions import is displayed.
10. Click Import.
    After the configurations are imported, a report generation link is generated in the Group & Configs page which can be downloaded. A success message is displayed in the Group & Configs page.
    NOTE:If a device is not registered and the configurations are imported, exceptions are applied to this device only if the device registers with one of the preloaded serial numbers device in the next 30 days.

    NOTE:If a device is already registered and the configurations are imported with device serial number, then the device exceptions are applied to the device.

    NOTE:Imported file is a password protected. AES-256 and ZipCrypto encryption is supported.

    NOTE:Configurations such as certificates, wallpaper, logo, and so on, with resources associated with them are not imported.