Dell Wyse Management Suite Version 3.x Migration Guide December 2020 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Introduction................................................................................................................. 5 Migrating from Wyse Device Manager to Wyse Management Suite...................................................................... 5 Chapter 2: Prerequisites for migration.......................................................................................... 7 Wyse Management Suite license requirements...........................................................
Chapter 6: Postmigration............................................................................................................ 25 Chapter 7: Uninstall Wyse Management Suite Import Tool...........................................................26 Chapter 8: Troubleshooting......................................................................................................... 27 Data import failure..........................................................................................................
1 Introduction This guide contains instructions to migrate from Wyse Device Manager (WDM) to Wyse Management Suite. The target audience for this guide is enterprise customers with administrator privileges. You must have knowledge about various thin client operating systems, Wyse Device Manager, cloud infrastructure, network technologies, file system permissions, and user authentication technologies. Dell Technologies recommends that you migrate from WDM version 5.7.
● View import status of View and Windows-based profiles—see View import status of View and Windows-based profiles. ● View import status of View and Teradici-based configurations—see View import status of View and Teradici-based configurations. 8. Switch devices from WDM based on your thin client infrastructure—see Switching devices from Wyse Device Manager to Wyse Management Suite. ● ● ● ● ● Switch Switch Switch Switch Switch Windows-based devices—see Deploy RSP package to Windows-based devices.
2 Prerequisites for migration Ensure that you meet the following migration requirements from Wyse Device Manager (WDM) and Wyse Management Suite (WMS): ● Wyse Device Manager (WDM) ○ Migration to Wyse Management Suite is supported from WDM version 5.7.2. If you are using an earlier version of WDM, then upgrade WDM to version 5.7.2. ○ WDM enterprise edition must be installed on your network. ○ Scheduled jobs or tasks in WDM must not be in progress state.
3. Upgrade the EM SDK package to the latest version by using the Wyse Management Suite 3.x installer. 4. Proceed with the Wyse Management Suite installation without selecting the EM SDK component. Supported environment for migration Table 1.
Table 3. Data migration (continued) Data available on thin client Wyse Device Manager (WDM) Wyse Management Suite Additional information Profiles on Windows Embedded Standard 7, Windows Embedded Standard 7P, Windows Embedded 8 Standard, and Windows 10 IoT Enterprise. Device configuration profile that is pushed through Profile Manager. Profiles are moved in the configuration policy. Remote connections for vWorkspace cannot be migrated.
Table 4. Device migration (continued) Device operating system Supported in Wyse Device Manager (WDM) Supported in Wyse Management Suite Migrated from WDM to Wyse Management Suite ThinLinux Yes Yes Yes Teradici 4.x Yes No No Teradici 5.
3 Using Wyse Management Suite Import Tool Wyse Management Suite Import Tool allows you to import the data from WDM to Wyse Management Suite.
● When verifying the licenses, the import tool does not filter the unsupported devices in the Wyse Management Suite. The tool checks the license based on total license subscriptions in Wyse Management Suite and devices imported from WDM. ● Only the first package is imported when you import Teradici 5.x configurations using Default Device Configuration (DDC). ● Default Device Configuration (DDC) cannot be imported for Windows and ThinLinux-based devices.
6. Enter the administrator username and password in the respective fields to access the Wyse Management Suite server. 7. Click Connect. The Wyse Device Manager Import task screen is displayed. NOTE: If you have entered the wrong credentials, or if you do not meet the license requirements, an error message is displayed. NOTE: ● If the import tool is unable to connect to the WDM server, database, or repository, an error message is displayed.
4 Importing data inventory Data import is the process of importing data inventories from Wyse Device Manager (WDM) to Wyse Management Suite. In the WDM Import Task screen, you can perform each task independently. However, you must import Windows-based WCM resources from WDM before importing view and Windows profiles. To import view and Teradici configurations, you must first import Teradici-based WCM resources from WDM.
Dell Technologies recommends that you click the Validate Repository Access link to validate whether the Wyse Management Suite local repository is accessible. If the Wyse Management Suite local repository is configured, then you can enter the Wyse Management Suite local repository. If the Wyse Management Suite local repository is not accessible, then enter the network credentials.
● Imported Packages—Displays the total number of resources that are successfully imported. ● Pending Packages—Displays the total number of resources that are pending to be imported. To import a pending resource, click the link and start the import activity again. ● Failed import Packages—Displays the total number of resources that failed during import. To import a failed resource, click the link and start the import activity again.
NOTE: If you want to assign both devices and WES profiles to the selected view, select both Devices and WES Profiles check boxes. If you want to assign both WES Profiles and ThreadX_5X configurations to the selected view, select both WES Profiles and ThreadX_5X Configurations check boxes. All configuration assignments in WDM are selected, and you cannot modify. Assignment of device configuration to specific groups can be performed only using the Build option.
● ● ● ● Imported Groups—Displays the total number of groups that are successfully imported. Imported Profile—Displays the total number of Windows-based profiles that are successfully imported. Imported Devices—Displays the total number of devices that are successfully imported. Failed import Groups—Displays the total number of groups that failed during import. To import a failed group, perform the rollback activity, and then import the group again.
Import view and Teradici-based configurations Teradici-based Wyse Configuration Manager (WCM) resources that are used in the Teradici-based configurations must be imported before importing configurations to Wyse Management Suite. For more information about importing Teradici-based WCM resources—see Import Teradici-based WCM resources. You can select only one view to import groups, ThreadX 5.x devices, and configurations.
Create groups and configurations using WDM default group types Use the Build option to create groups and profiles by using WDM default group types. You can create a group hierarchy in Wyse Management Suite provided that grouping is not assigned as a view in WDM. 1. On the View & WES Profiles/ThreadX_5X Configurations screen, click the Build radio button. A drop-down list with all the default group types in WDM is displayed. The order determines the group hierarchy structure.
● After the import activity of the view and Teradici-based configuration is complete, the VIEW STATUS and Rollback options are displayed during next login or after you click Back to Task. For more information about rollback capability— see Rollback capability. ● The date of the last import activity is displayed in the View and WES Profile/ThreadX_5X Configurations task section.
5 Switching devices from Wyse Device Manager to Wyse Management Suite After you import devices from WDM to Wyse Management Suite, the device registration status in Wyse Management Suite is displayed as Pre-registered. Deploy an RSP package to switch the Windows Embedded Standard, Windows 10 IoT Enterprise, ThinLinux, and SUSE Linux devices from WDM to Wyse Management Suite.
3. Go to Other Packages, select the registered RSP package, and click Package Script. The Package Script screen is displayed. 4. Click Edit, and replace the server URL with the Wyse Management Suite server URL in the RSP package script. For example: "/bin/sh/tmp/deviceSwitchOver.sh https://wmserver.wms.com:443". 5. Click Save. 6. Deploy the RSP package to the ThinLinux devices by using WDM. For information about installing an RSP package using WDM, see the Wyse Device Manager version 5.7.
Table 5. INI parameters ThinOS v8.5-based devices ThinOS v8.4-based devices AutoLoad=1 AutoLoad=1 SignOn=1 SignOn=1 WDAService=yes\ WDAService=yes\ Priority=WMS Priority=CCM WMSEnable=yes\ CCMEnable=yes\ Server=\ CCMServer=\ CAValidation=no\ GroupPrefix=\ Override=yes GroupKey=\ MQTTServer=\ CAValidation=no\ Override=yes NOTE: For ThinOS Lite devices, you must create a xen.ini file with the same INI parameters that are listed in the table.
6 Postmigration Verify the data that is imported from Wyse Device Manager (WDM) to Wyse Management Suite. You can use the event logs to compare the total file count and capacity. To verify that the data is successfully migrated: 1. Log in to the Wyse Management Suite. 2. On the Dashboard page, verify the device count for total devices that are imported from WDM. 3. On the Dashboard page, verify the summary of events for WDM import activity. 4.
7 Uninstall Wyse Management Suite Import Tool To uninstall Wyse Management Suite Import Tool: 1. Go to Control Panel, and click Programs > Programs and Features. 2. Select Wyse Management Suite Import Tool. 3. Click Uninstall. The Wyse Management Suite Import Tool Uninstaller screen is displayed. By default, the Remove radio button is selected. 4. Click Next. 5. Click Finish after the uninstallation is complete.
8 Troubleshooting This section describes some basic troubleshooting that you can implement when you experience any problem. NOTE: If the details of the previous import session are not required, delete the %programdata%WMS-Import \WMSMigrationInfo.json file.
Solution—Perform the Rollback operation on the View and WES Profiles task screen, and start the import activity again— see Importing view and Windows-based profiles. Switching SUSE Linux device from WDM to Wyse Management Suite is unsuccessful Problem—Switching the SUSE Linux Enterprise device from WDM to Wyse Management Suite is unsuccessful. Solution—Ensure that the server URL, MQTT URL, and group token that is entered in the RSP package script are valid.