Dell Wyse Management Suite Version 1.
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. © 2018 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents 1 Introduction....................................................................................................................................................4 2 Hardware requirements..................................................................................................................................5 3 Wyse Management Suite deployment architecture........................................................................................ 6 4 Deployment details..........................
1 Introduction Dell Wyse Management Suite is the next generation management solution that lets you centrally configure, monitor, manage, and optimize your Dell Wyse thin clients. The new Suite makes it easier to deploy and manage thin clients with high functionality and performance, and ease of use. It also offers advanced feature options such as cloud versus on-premises deployment, remote management by using a mobile application, BIOS configuration and port lockdown.
2 Hardware requirements The following table lists the hardware requirements: Table 1. Hardware requirements Description 10000 devices or less 50,000 devices or less Operating system Microsoft Windows Server 2012 R2 or Microsoft Windows Server 2016 Supported language pack—English, French, Italian, German, Spanish, Japanese and Chinese (preview release).
3 Wyse Management Suite deployment architecture The following are the Wyse Management Suite installer components to deploy at the work place: • WMS Web Application—Application Server that hosts Wyse Management Suite. • Memcached—Used to Cache data for performance and scalability. • MQTT—Used to push notifications to thin clients. • MongoDB—Relational database for structured data and normalization. • MariaDB—SQL database for performance and scalability. Figure 1.
4 Deployment details This chapter contains the deployment architecture details for Wyse Management Suite. The Wyse Management Suite supports up to 1,20,000 connected devices. You can also customize your deployment for 50,000 devices or more, depending on the deployment setup. Deployment on a single server to support 50,000 devices The minimum hardware requirement on a single server for 50,000 devices is: Table 2.
Table 3. Hardware specification Application Hardware specification Wyse Management Suite • • 16 CPUs 32 GB RAM • 200 GB HDD • Four network interfaces (to assign 4 IP addresses to the server) Figure 3. Single server with 1,20,000 devices FE MQTT on a separate server You can deploy FE MQTT on a separate server. This reduces the load on the WMS server because the TCP connections to be supported is shared between the FE MQTT server and the WMS server. The minimum hardware requirements are: Table 4.
Application details Hardware specification • 1 network interface The following diagram depicts the architecture of FE MQTT Servers separated from Wyse Management Suite server. Figure 4. FE MQTT servers separate from Wyse Management Suite server Wyse Management Suite on a separate database server This section explains the deployment architecture of Wyse Management Suite on a separate database server. MongoDB and MariaDB may be on the same server or on separate servers.
5 Custom port configurations Wyse Management Suite uses the following port as the default port for the applications that are installed: • Apache Tomcat: 443 • MariaDB database: 3306 • Mongo database: 27017 • MQTT Broker: 1883 • Memcached: 11211 To use a nondefault port for one or more of the above services, use Custom install option during Wyse Management Suite installation, the option listed in the following screen allows you to use the local database for MongoDB and MariaDB or use the remotely i
c d e #port 1883 Uncomment the port 1883 entry and change the port number to your preferred port. For example, port 2883. Save the file, and start the MQTT service. Check the following entry to confirm that the MQTT service is running on the new port: ps> get-nettcpconnection –LocalPort 2883 3 To configure Tomcat, do the following: a b c Open a command prompt session, and navigate to cd C:\Program Files\DELL\WMS\MongoDB\bin.
Deploy and configure Wyse Management Suite This chapter describes the deployment and configuration of Wyse Management Suite on a single server. The tasks involved in deploying Wyse Management Suite on a single server are: • Preparing the server • Configuring DNS • Installing Wyse Management Suite Perform the following steps to deploy Wyse Management Suite on a single server to support 1,20,000 devices: 1 Log in to the system.
a b c d e Tomcat Memcached Mosquitto MongoDB MariaDB Mosquitto that is installed by the WMS installer must be configured as the back-end MQTT; front-end MQTT can be installed manually. The default installation directory is, Drive C:\Program Files\DELL\WMS. Deploy front-end Mosquitto as a service Wyse Management Suite can handle up to 50,000 devices with a single instance of Mosquitto installed by the installer which serves both as front-end as well as back-end Mosquitto.
Figure 7. Services NOTE: The Startup Type is Manual, and the Mosquitto Services are started by running a script. The Mosquitto Services (including ‘Dell WMS: Mosquitto’) should not be started, or restarted manually, as the services get started by the script automatically when the system restarts. Configure back-end Mosquitto to connect with front-end Mosquitto 1 Open the file in the directory C:\Program Files\DELL\WMS\Mosquitto\mosquito.conf in a text editor. 2 In the mosqquito.
Figure 8. Start services Edit Mosquitto service startup script 1 Go to the directory C:\Program Files\DELL, and create a file mqttsvc.bat. 2 Open the file mqttsvc.bat in text editor, and type the following commands into the file. @ECHO OFF SETX -m MOSQUITTO_DIR "C:\Program Files\DELL\WMS\Mosquitto\mq1" sc.exe start "Dell WMS: FE-MQTT1" SLEEP 5 TIMEOUT /5 SETX -m MOSQUITTO_DIR "C:\Program Files\DELL\WMS\Mosquitto\mq2" sc.exe start "Dell WMS: FE-MQTT2" SLEEP 5 TIMEOUT /5 SETX -m MOSQUITTO_DIR "C:\Program
Figure 9. Start screen The C:\Users\Administrator\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup directory is displayed. 6 Copy the shortcut of mqttsvc.bat file into the folder.
• Windows 2012 R2 or Windows 2016 Server • 4 CPU • 8 GB RAM • 40 GB storage space Do the following to install WMS-Repo software: 1 Download WMS_Repo.exe file from Dell Digital Locker. 2 Log in as Administrator, and install WMS_Repo.exe on the repository server. 3 Click Next and follow the instructions on the screen to complete the installation. Figure 10.
Figure 11.
Figure 12. Installation completed 4 Click Launch to launch the WMS Repository registration screen on the web browser.
Figure 13. Registration details 5 Click Register to start the registration. Select the Register to public WMS Management Portal if you are registering on the public cloud.
Figure 14. Register on a public cloud 6 Enter the following details, and press Register: a Wyse Management Suite server URL NOTE: Unless you register with Wyse Management Suite v1.0, you cannot use MQTT Server URL.
Figure 15. Registration successful 8 The following screen on the Wyse Management Suite portal confirms the successful registration of the remote repository: Figure 16. Registration successful on the portal 9 HTTPS is by default enabled with WMS_Repo.exe, and is installed with the self-signed certificate. To install your own domain-specific certificate, scroll down the registration page to upload the SSL certificates.
Figure 17. Cerificate upload 10 The server restarts, and the uploaded certificate is displayed.
Figure 18. SSL certificate enabled 11 If the Wyse Management Suite is enabled with self-signed or a private domain certificate, you can upload the certificate on the Wyse Management Suite repository server to validate the Wyse Management Suite CA credentials. Figure 19.
12 Navigate to the C:\wmsrepo location that you entered during registration, and you can view the folders where all the repository files are saved and managed. Figure 20.
6 Maintenance This chapter describes how to take a backup of the database. Database backup Stop Tomcat Service before taking a backup of the database. Tomcat Service is identified as “Dell WMS: Tomcat Service” and must be stopped from Local Services. To dump the contents of the MongoDB, run the following command: mongodump --host -u stratus –p --authenticationDatabase admin --db stratus --out ". \wmsmongodump" To dump the contents of the MarioDB, run the following command: mysq