Dell Wyse Management Suite Version 3.x High Availability Guide July 2021 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. © 2021 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 High availability overview.................................................................................................................................................. 5 Chapter 2: High availability architecture....................................................................................... 6 System requirements for high availability.................
Chapter 11: Upgrading from Wyse Management Suite version 1.4/1.4.1/2.x/2.1 to Wyse Management Suite version 3.x..................................................................................................83 Chapter 12: Troubleshooting........................................................................................................
1 Introduction Wyse Management Suite is the next generation management solution that enables you to configure, monitor, manage, and optimize your Dell Wyse thin clients and Dell endpoints powered by Dell Hybrid Client. Wyse Management Suite helps you to deploy and manage supported Dell devices on a high availability set-up with improved performance.
2 High availability architecture The Dell Wyse Management Suite architecture consists of Windows Server 2012 R2/2016/ 2019 Standard with failover cluster enabled. The Windows cluster contains a main computer that supports other applications and ensures minimum downtime by harnessing the redundant. This is used for application failover for Tomcat, Memcache, MQTT services. MongoDB database cluster helps in the event of primary database failure the secondary database will take over.
Table 1. System requirements Product Port Microsoft Windows Server 2012 R2/2016/2019 Standard ● Network ● Minimum disk space—40 GB communication ports: ● Minimum number of systems—2 ○ UDP:3343 ○ TCP:3342 ● Minimum memory (RAM)—8 GB ○ UDP:137 MySQL Cluster ● Network communication port —TCP:3306 Protocol Description Server where Wyse Management Suite is hosted. Supports English, French, Italian, German, and Spanish languages.
3 High availability on Windows Server 2012 R2/2016/2019 A failover cluster is a group of independent systems that increases the availability and scalability of clustered roles. This feature supports multiple workloads running clusters on hardware or on virtual machines. A failover cluster is a group of systems that are independent and increases the availability and scalability of clustered roles. The clustered servers are the nodes that are connected to one another as a network.
2. Click Failover Cluster Manager to launch the cluster manager. 3. Right-click Roles and then select Configure Role to display the High Availability Wizard screen. Figure 3. High availability wizard 4. Select Generic Service and then click Next to view the Select Service screen.
Figure 4. Select service 5. Select Dell WMS: Tomcat Service and then click Next. NOTE: You can add the Wyse Management Suite related services to the cluster only after you install Wyse Management Suite. The High Availability Wizard screen is displayed where you need to create the client access point and establish connectivity between the Windows server 2012 and Wyse Management Suite. 6. Type a network name in the Name field and then click Next.
Figure 5. Confirmation 7. Click Next to complete the process. 8. To add other Wyse Management Suite services as part of the cluster, launch Failover Cluster Manager, and then go to ActionsRoles to display the network name that you have created. 9. Click on the network name, and go to Add ResourceGeneric Service. 10. Select the following services from the New Resource Wizard screen that needs to be added as part of the cluster: a. Dell WMS: MQTT Broker b. Dell WMS: memcached 11.
4 Achieve high availability on Windows Server 2012 R2/2016/2019 About this task The following are the steps to achieve high availability on Windows Server 2012/2016/2019: 1. Add failover cluster feature on Windows Server 2012 R2/2016/2019—see Adding failover cluster feature on Windows Server 2012 R2/2016/2019. 2. Create file share witness—see Create file share witness. 3. Configure cluster Quorum—see Configure cluster Quorum. 4. Create clustered roles—see Create cluster roles.
Figure 6. Role based selection 3. Click Installation Type and select Role-based or Feature-based installation and then click Next to view the list of servers in the Select destination server screen. Figure 7.
4. Select the server where you want to enable the failover cluster feature and then click Next. 5. Select Failover Clustering on the Features screen, and then click Next. After you enable the failover cluster on the servers, open the Failover Cluster Manager on the server at Node 1. 6. Click Yes to confirm installation, and enable the failover cluster feature on the selected server. 7.
Figure 9. Testing options 10. Click Next. The Confirmation screen is displayed with the list of selected servers.
Figure 10. Confirmation 11. Click Next. The Summary screen is displayed with the failover cluster validation report.
Figure 11. Test summary details 12. Click View Report to check the report. If the status is Passed, you can proceed with the next step. If the status is Failed, you must fix the errors before you proceed with the next step. NOTE: The Create Cluster Wizard screen is displayed if there are no validation errors. 13. Click Next and type a name for the cluster in the Cluster Name field and then select the IP address of the system. 14. Click Next and the Confirmation screen is displayed. 15.
5. Click Select Profile to create a file share and then click Next. 6. On the Share location screen, select the server and share location for the file share and then click Next. 7. On the Share Name screen, type a name in the Share name field and then click Next until the Confirmation screen is displayed. 8. Click Create to create the file share and the View results screen is displayed with the status as Completed which indicates that the file share witness is created without any errors. 9.
Figure 13. Select voting configuration 6. Click Next . Select Configure a file share witness from the Select Quorum Witness screen. 7. Click Next and then type the share path in the File Share Path field from the Configure a file share witness screen.
Figure 14. Configure file share witness 8. Click Next . TheSummary screen is displayed with the configured quorum settings.
Figure 15. Summary of the quorum settings 9. Click Finish to complete the quorum settings. Creating clustered roles Prerequisites After you create the failover cluster, you can create clustered roles to host cluster workloads. Ensure that Wyse Management Suite is installed on the servers and point to the remote database before you create clustered roles. Steps 1. In Windows Server 2012, right-click the Start menu and then select Server Manager to launch the Server Manager dashboard 2.
Figure 16. High availability wizard 4. Select Generic Service and then click Next to view the Select Service screen. Figure 17. Select service 5. Select Dell WMS: Tomcat Service and then click Next.
NOTE: You can add the Wyse Management Suite related services to the cluster only after you install Wyse Management Suite. The High Availability Wizard screen is displayed where you need to create the client access point and establish connectivity between the Windows server 2012 and Wyse Management Suite. 6. Type a network name in the Name field and then click Next. The Confirmation screen is displayed with the network name and IP address details of the server. Figure 18. Confirmation 7.
5 Achieve high availability for MySQL InnoDB About this task The following steps explain how to achieve high availability for MySQL InnoDB: Steps 1. Check MySQL InnoDB server instance—see Create MySQL InnoDB cluster. 2. Add server or node to MySQL InnoDB—see Adding server or node to MySQL InnoDB cluster. 3. Configure MySQL Router—see Configure MySQL Router. High availability with MySQL InnoDB The MySQL InnoDB cluster provides a complete high availability solution for MySQL.
Figure 19. Setup type 4. On the Select Products and Features screen, select the MySQL Server, workbench, and shell components, and click Next.
Figure 20. Products and features 5. On the Check Requirements screen, select the components, and click Execute.
Figure 21. Requirements 6. Install the required components, and click Next.
Figure 22.
Figure 23. Requirements 7. On the Installation screen, click Execute.
Figure 24. Installation The MySQL server, workbench, and shell components are upgraded. 8. Click Next.
Figure 25. Installation 9. On the Product Configuration screen, the MySQL server component is displayed.
Figure 26. Product configuration 10. Click Next to configure the MySQL server component. 11. On the Group Replication screen, click the Standalone MySQL Server / Classic MySQL Replication radio button, and click Next.
Figure 27. Group replication 12. On the Type and Networking screen, select the Dedicated Computer option from the Config Type drop-down list.
Figure 28. Type and networking 13. Select and configure the options in the Connectivity section, and click Next. 14. In the Accounts and Roles screen, enter the MySQL root password. 15. Click Add User.
Figure 29. Add user The MySQL User Details window is displayed. 16. Enter the credentials and click Ok. The newly added user account is displayed in the MySQL User Accounts section.
Figure 30. Accounts and roles 17. Click Next. 18. On the Windows Service screen, enter the MySQL Windows service name, and click Next.
Figure 31. Windows service 19. On the Plugins and Extensions screen, click Next.
Figure 32. Plugins and extensions 20. On the Apply Configuration screen, click Execute. The configurations are applied to the MySQL component.
Figure 33. Apply configurations 21. Click Finish.
Figure 34. Apply configurations 22. On the Product Configuration screen, click Next.
Figure 35. Product configuration 23. On the Installation Complete screen, click Finish.
Figure 36. Installation complete Next steps Follow the procedure to install and configure MySQL server in all the three servers of the MySQL cluster. NOTE: To set up the environment as per the high availability setup, see dev.mysql.com. Check MySQL InnoDB server instances About this task Before you add MySQL InnoDB to the cluster setup, verify that MySQL InnoDB is created as per the cluster requirements.
● mysql-js> dba.checkInstanceConfiguration('root@IP Address2') ● mysql-js> dba.checkInstanceConfiguration('root@IP Address3') Figure 37. MySQL command prompt To check that the MySQL InnoDB is created on all the three cluster nodes, run the following commands at the command prompt: ● mysql-js> dba.checkInstanceConfiguration('root@IPAddress1:3306') ● mysql-js> dba.checkInstanceConfiguration('root@IPAddress2:3306') ● mysql-js> dba.
2. Run the following command to create a cluster with a unique name. For example, MySQLCluster. MySql JS> var cluster = dba.createCluster('MySQLCluster') 3. Run the following command to check the status of the cluster. MySql JS>Cluster.status() The status of the created cluster is displayed as ONLINE which indicates that the cluster is created successfully. Figure 39.
Figure 40. Cluster status Configure MySQL Router Prerequisites MySQL Router establishes communication network between Wyse Management Suite and MySQL InnoDB. About this task To install MySQL Router, do the following: Steps 1. Log in to the Windows Server 2012/2016 to install MySQL Router. For more information, see MySQL Router Installation 2. Select MySQL Router from the Select Products and Features screen and then click Next .
Figure 41. Select products and features 3. On the Check Requirements screen, click Execute.
Figure 42. Check requirements 4. Install the required components, and click Next.
Figure 43.
Figure 44. Check requirements 5. On the Installation screen, click Execute.
Figure 45. Installation MySQL router component is upgraded. 6. Click Next.
Figure 46. Installation 7. On the Product Configuration screen, the MySQL router component is displayed.
Figure 47. Product configuration 8. Click Next to configure the MySQL router component. 9. On the MySQL Router Configuration screen, enter the hostname, port number, management user, and password.
Figure 48. MySQL Router Configuration 10. On the Apply Configuration screen, click Execute.
Figure 49. Apply configuration 11. Click Finish.
Figure 50. Apply configurations 12. On the Product Configuration screen, click Next.
Figure 51. Product configuration The Installation Complete message is displayed.
Figure 52. Installation complete 13. Click Finish. 14. Browse to \ProgramData\MySQL\MySQL Router directory, and open the file mysqlrouter.conf to check that the bootstrap property with all the configured MySQL servers are part of cluster setup.
Figure 53. Bootstrap server address Create database and users on MySQL InnoDB server You must create the database and user accounts with administrator privileges on MySQL InnoDB server.
6 Achieve high availability on MongoDB About this task The following steps explain how to achieve high availability on MongoDB: Steps 1. Install MongoDB—see Installing MongoDB. 2. Create replica servers—see Creating Replica servers. 3. Create Stratus users—see Creating Stratus user account. 4. Create root user—see Creating root user for MongoDB. 5. Edit MongoDB configuration file—see Editing MongoDB configuration file.
Figure 55. mongod.cfg file 4. Open the mongod.cfg file in a text editor, and add: systemLog: destination: file path: c:\data\log\mongod.log storage: dbPath: c:\data\db 5. Save the file. 6. Open command prompt. 7. Run the following command to start the MongoDB service: a. C:\MongoDB\bin>.\mongod.exe --config c:\Mongodb\mongod.cfg --install b. C:\MongoDB\bin>net start mongodb The message MongoDB service is starting is displayed. 8. Change the working directory to \MongoDB\bin. 9. Run Mongo.
{ role: "readWriteAnyDatabase", db: "admin" }, { role: "dbOwner", db: "DBUser" }]}) Create database user Create an user, for example, DBUser using the Wyse Management Suite to access MongoDB. NOTE: The database user and password are examples and can be created using a different name and password at your work place. Run the following command to create the DBUser: db.
Figure 56. Edit mongod.cfg systemLog: destination: file path: c:\data\log\mongod.log storage: dbPath: c:\data\db\Mongo net: bindIp: x.x.x.x, 0.0.0.0 port: 27017 security: authorization: enabled NOTE: The port numbers will change depending on the system at the work place. 4. Save mongod.cfg and exit. Initiate replication on the servers Ensure that you disable firewall on Windows and stop Tomcat servers if they are running. 1.
Figure 57. Enabling security 4. Create mongod.key.txt file and copy on all the three servers. NOTE: Ensure that the mongod.key.txt file content or key is the same in all the three servers. Figure 58. Copy the mongod key file 5. After you copy the file, stop the mongod service by running the following command: net stop mongodb 6. Start the mongod service by running the following command: net start mongodb 7. Repeat the steps from 1 to 6 in all the three nodes of MongoDB servers. 8.
"ok" : 1 } 9. Check the replication status by running the following command: rs.status(); Figure 59. Replication status 10. Start mongod service and add the secondary nodes to the second and third nodes in the MongoDB cluster: rs.add("IPAddress2:27017") rs.add("IPAddress3:27017") MongoDB Enterprise wms20:PRIMARY> rs.add("10.150.132.
Figure 60. Status in primary server Figure 61.
7 Achieve high availability for Teradici devices Wyse Management Suite uses the HAProxy hosted on the Ubuntu server 16.04.1 LTS to perform load balancing between the EMSDK servers. HAProxy is a load balancer proxy that can also provide high availability based on how it is configured. It is a popular open source software for TCP/HTTP Load Balancer, and proxy solution which runs on Linux operating system.
NOTE: Administrator must add additional back end servers beyond the total number of client’s capacity to have seamless failover. 5. Save the changes to the haproxy.cfg file by typing CTRL+O.
8 Install Wyse Management Suite on Windows Server 2012 R2/2016/2019 Prerequisites Ensure that the following servers are configured before installation of Wyse Management Suite application: ● Windows Fail over Cluster on Two Nodes ● MongoDB Server Running with replica set ● MySQL Server InnoDB Cluster up running ● MySQL Router installed on the two Nodes ● Install Visual C++ 2015 or 2017 Redistributable package (x64) or later versions. Wyse Management Suite installer requires VCRUNTIME140.
Figure 63. Setup type 3. Select the External Remote Mongo database option (MongoDB Cluster with Replica set created). Ensure to provide the remote primary Mongo DB server information and port number; and Mongo DB username and password. Figure 64. Configuration 4. Select the External MariaDB option for MySQL. Provide MySQL router address (Local Host if it is installed on Wyse Management Suite server node) in the External Maria DB Server fields with the port number(Default 6446).
Figure 65. Root password c. Execute the command, CREATE DATABASE stratus DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_unicode_ci to create DB. Figure 66. Database command d. Execute following commands to create and Stratus User account and privileges: ● Create user 'stratus'@'localhost' ● Create user 'stratus'@'10.150.132.21' ● Set password for 'stratus'@'localhost' = password ('PASSWORD') ● Set password for 'stratus'@'IP ADDRESS'= password ('PASSWORD') ● Grant all privileges on *.
Figure 67. My SQL workbench Figure 68. My SQL workbench 5. Provide ports information for Wyse Management Suite related Services in “Port Selection” window. Figure 69. Configuration 6. Provide administrator credentials and email address information.
Figure 70. Configuration 7. Provide Teradici EM SDK Port information and CIFS User Account information. Figure 71. Teradici EM SDK 8. Provide ‘Destination Installation folder path’ and ‘Shared UNC path’ for Local repository.
Figure 72. Destination 9. Recheck the Installation Summary information before we proceed with the Wyse Management Suite installation. 10. Complete the Installation on both the nodes. Type the Destination Installation folder path and Shared UNC path for the local repository and then click Next. The message The installation was successful is displayed. NOTE: The shared UNC path should be kept out of both the Windows Server where Wyse Management Suite application is installed.
9 Post installation checks About this task Do the following to check the high availability for Wyse Management Suite: ● Launch the Wyse Management Suite administrator portal and check whether you can log in using the web interface. ● Edit the bootstrap.properties file in the Tomcat server under the \Dell\WMS\Tomcat-9\webapps\ccmweb\WEB-INF\classes folder for MongoDB as follows: mongodb.
10 Upgrade Wyse Management Suite version 1.3 to 1.4 Prerequisites ● Ensure that the mongodb.seedList value in the bootstrap.properties file includes backslash character (\) in the list of Mongo database servers. The bootstrap.properties file is at Tomcat-9\webapps\ccmweb\WEB-INF\classes, mongodb.seedList = MongoDBServer1_IP\:27017, MongoDBServer2_IP\:27017, MongoDBServer3_IP\:27017. Figure 74.
Figure 75. Welcome screen 3. On the Upgrade page, click Next to upgrade Wyse Management Suite . 76 Upgrade Wyse Management Suite version 1.3 to 1.
Figure 76. Upgrade Upgrade Wyse Management Suite version 1.3 to 1.
Figure 77. Upgrade 4. Click Launch to open the Wyse Management Suite web console. 78 Upgrade Wyse Management Suite version 1.3 to 1.
Figure 78. Launch Next steps ● Ensure that Tomcat-8 folder and subfolders are deleted, and Tomcat-9 folder and subfolders are created. Also, do the following: ○ Ensure that Tomcat-9\webapps\ccm-web\WEB-INF\classes folders and subfolders are created. ○ Ensure that Tomcat-9 service is added, and Tomcat-9 service is running. ○ Ensure that the bootstrap.properties file is copied from Tomcat-8\ webapps\ccm-web\WEB-INF\classes folder to Tomcat-9\webapps\ccm-web\WEB-INF\classes folder. ○ Ensure that the mongodb.
Figure 79. Access point 3. Check the version of the Tomcat service. If the version of the Tomcat service is 8, you must manually remove Tomcat‐ 8 and add Tomcat‐9 service into the Access Point. This is because, when you upgrade Wyse Management Suite 1.4 to WMS 2.0, Tomcat‐8 service is replaced with Tomcat‐9. 4. Right-click the Tomcat-8 service, and then click Remove. Figure 80. Tomcat service removal 5. Add the Tomcat-9 service to the access point. 80 Upgrade Wyse Management Suite version 1.3 to 1.
Figure 81. Tomcat-9 service Figure 82. Tomcat 9 service 6. Bind the FQDN address of the access point of High Availability to the Memcached registry on both nodes of the High Availability setup using the command Registry Path: HKLM\SYSTEM\CurrentControlSet\Services\Memcached\ “ImagePath” = “C:\Program Files\DELL\WMS\memcached\memcached.exe" -d runservice -p -I 11211 WMS1314AP.AD132.COM -U 0” Upgrade Wyse Management Suite version 1.3 to 1.
Figure 83. Memcached data 82 Upgrade Wyse Management Suite version 1.3 to 1.
11 Upgrading from Wyse Management Suite version 1.4/1.4.1/2.x/2.1 to Wyse Management Suite version 3.x Prerequisites Ensure to perform the following tasks before upgrading to Wyse Management Suite version 3.x: ● Set the policy of the resources(tomcat,memcache,mqtt) in the access point to "if resource fails, Do not restart" though default policy “if resource fails, attempt restart on current node ” is recommended, for failover scenario it does not allow the product to upgrade. Figure 84.
● Install Visual C++ 2015 or 2017 Redistributable package (x64) or later versions. Wyse Management Suite installer requires VCRUNTIME140.dll file to connect with MongoDB replica set or stand-alone setup with version 4.2.1. NOTE: From Wyse Management Suite 3.3, you must use MongoDB version 4.2.12 for distributed setups. You can not install or upgrade Wyse Management Suite 3.3 using any other version of external MongoDB server. Steps 1. Double-click the Wyse Management Suite 3.x installer package. 2.
Figure 86. End user license agreement 3. Clear the Bind Memcached to 127.0.0.1 check box. Upgrading from Wyse Management Suite version 1.4/1.4.1/2.x/2.1 to Wyse Management Suite version 3.
Figure 87. Teradici EM SDK NOTE: There is no TLS selection during the upgrade process. However, there is an option to select a port for secure mqtt. You must use a valid port for secure mqtt and should not enter 0 for secure mqtt during a new custom install or upgrade from the previous version. 4. Click Next. Figure 88. Upgrade 86 Upgrading from Wyse Management Suite version 1.4/1.4.1/2.x/2.1 to Wyse Management Suite version 3.
5. Select a port for secure MQTT communication. The default port is 8443. NOTE: The port number for secure MQTT communication should not be 0.The port selection option is displayed when you are updating from Wyse Management Suite version 3.x, 3.1, and 3.1.1 to 3.3. NOTE: Select the Apply recommended changes check box if you want to change the URLs. Update MQTT Config message is displayed when you are updating from Wyse Management Suite version 3.2 and 3.2.1 to 3.3 Figure 89. MQTT port selection 6.
Figure 90. Upgrade 88 Upgrading from Wyse Management Suite version 1.4/1.4.1/2.x/2.1 to Wyse Management Suite version 3.
Figure 91. Upgrade Upgrading from Wyse Management Suite version 1.4/1.4.1/2.x/2.1 to Wyse Management Suite version 3.
Figure 92. Upgrade complete Table 2. Wyse Management Suite upgrade path 90 Upgrade type Upgrade path Compatibility 3.2 to 3.3 3.2 > 3.2.1 > 3.3 Supported 3.2.1 to 3.3 3.2.1 > 3.3 Supported Upgrading from Wyse Management Suite version 1.4/1.4.1/2.x/2.1 to Wyse Management Suite version 3.
12 Troubleshooting About this task This section provides troubleshooting information for Wyse Management Suite version 1.x for the cluster set up. ● Problem: Where is the Wyse Management Suite log file located to check server installation issues. Workaround: The log file is in the %temp% WMSInstall.logfolder. ● Problem: Where is the Tomcat service related log file located to check the application related issues.
Figure 93. Error message Workaround: Change the server ID entries in the my.conf file located in the \ProgramData\MySQL\MySQL Server 5.7 directory. Figure 94. change server ID Problem: After every High Availability upgrade, the installer sets the db.serversincluster and db.queuelock to Server node IP Address or Host-name. Workaround: db.serversincluster and db.queuelock, with High Availability access point IP Address or Host-name must be updated manually after every High Availability upgrade.
