Skip to main content
  • 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.

Dell Wyse Management Suite Version 1.2 Deployment Guide

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. Navigate to the Network Connections window and verify that the server has four network connections available. The following window is displayed:
    Figure 1. Configure IP address IP Address
  2. Configure each network connection with an IP address such that Ethernet0 has the primary IP address IP0 that is used by the Wyse Management Suite.
  3. Assign Ethernet1, Ethernet2, and Ethernet3 to the remaining three IP addresses – IP1, IP2, and IP3 that are used by front-end MQTT.
  4. Configure DNS with two DNS records. For example,

    Xyz.wysemanagementsuite.com

    Assigned with the primary IP address assigned to Ethernet0.

    This domain is used by the devices to communicate with Tomcat over HTTPS.

    Xyz-pns.wysemanagementsuite.com

    Round robin between three IP addresses assigned to Ethernet1, Ethernet2, and Ethernet3.

    This domain is used by the devices to establish a connection with the front-end MQTT servers.

  5. Download and install the latest Wyse Management Suite for a private cloud. The following components are installed as services:
    1. Tomcat
    2. Memcached
    3. Mosquitto
    4. MongoDB
    5. 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. To support 1,20,000 devices, you need separate Mosquitto instances to handle the device connections. Since each Mosquitto instance can handle most of 50,000 device connections, you need at least three front-end instances to handle 1,20,000 devices. Each of the three front-end Mosquitto instances interacts through port 1883, and each instance will be bound to a particular IP address. To install three new instances of Mosquitto, you need three new copies of Mosquitto deployment as explained in the following steps:

  1. Create three new directories inside Mosquitto folder as shown in the following entries: C:\Program Files\DELL\mq1C:\Program Files\DELL\mq2C:\Program Files\DELL\mq3
  2. Copy the contents in the directory C:\Program Files\DELL\WMS\Mosquitto to the folders created in the step 1.
  3. Open the file in the directory C:\Program Files\DELL\mq1\mosquitto.conf in a text editor.
  4. In the mosquitto.conf folder, uncomment the property bind_address, and update the entry as, bind_address <IP1>.
  5. Start mq1and do the following to confirm that mq1 is running on IP1:
    1. Open a command prompt window.
    2. Go to C:\Program Files\DELL\mq1 directory.
    3. Run the command, Mosquitto.exe –c mosquitto.conf at the command prompt.
    4. Open the Powershell window, and run the command, PS> get-nettcpconnection -LocalPort 1883 at the command prompt.
  6. Confirm that the service is running with following values:LocalAddress=IP1LocalPort=1883State=Listen
  7. Repeat steps 3, 4, 5 and 6 for mq2 and mq3 with IP2 and IP3 respectively to complete the process.

Deploy front-end Mosquitto as a service

  1. Open a Windows PowerShell window with administrator privileges, and run the following commands to create a service entry in the registry and service database: PS> sc.exe “Dell WMS: FE-MQTT1” binPath= “C:\Program Files\DELL\mq1\mosquito.exe run” PS> sc.exe “Dell WMS: FE-MQTT2” binPath= “C:\Program Files\DELL\mq2\mosquito.exe run” PS> sc.exe “Dell WMS: FE-MQTT3” binPath= “C:\Program Files\DELL\mq3\mosquito.exe run”
  2. From the Control Panel, open Windows Local Services and confirm that the services are created as shown in the following screen shot:
    Figure 2. ServicesServices
    • 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.conf folder, uncomment the property bind_address, and update the entry as, bind_address <IP1>.
  3. Go to the Bridges section of the document, and run the following commands: # connection <name>#address <host>[:<port>] [<host>[:<port>]]#topic <topic> [[[out | in | both] qos-level] local-prefix remote-prefix] connection pns01address <IP1>:1883topic # outconnection pns02address <IP2>:1883topic # outconnection pns03address <IP3>:1883topic # out
  4. In the Windows Local Services, set Dell WMS: Mosquitto service to Manual as shown in the following window:
    Figure 3. Start services Start services manually

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 OFFSETX -m MOSQUITTO_DIR "C:\Program Files\DELL\WMS\Mosquitto\mq1"sc.exe start "Dell WMS: FE-MQTT1"SLEEP 5TIMEOUT /5SETX -m MOSQUITTO_DIR "C:\Program Files\DELL\WMS\Mosquitto\mq2"sc.exe start "Dell WMS: FE-MQTT2"SLEEP 5TIMEOUT /5SETX -m MOSQUITTO_DIR "C:\Program Files\DELL\WMS\Mosquitto\mq3"sc.exe start "Dell WMS: FE-MQTT3"SLEEP 5TIMEOUT /5SETX -m MOSQUITTO_DIR "C:\Program Files\DELL\WMS\Mosquitto"sc.exe start "mosquitto"
  3. Save the mqttsvc.bat file.
  4. Create a shortcut to the mqttsvc.bat file. This script is used to start all Mosquitto services when the server starts.
  5. To configure Mosquitto Service Startup Script, go to Windows startup folder, and in the search window, type Shell: startup as shown in the following screen shot:
    Figure 4. Start screenStart 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.
  7. Restart the server and perform the following steps to confirm that four instances of Mosquitto are running on each of IP0, IP1, IP2, and IP3 on port 1883:
    1. Open the Powershell window, and run the following command:PS> get-nettcpconnection -LocalPort 1883
    2. Confirm that there are at least four services running with the following values: LocalAddress=IP0, IP1, IP2, IP3LocalPort=1883 State=Listen

Configure front-end Mosquitto on MongoDB database

MongoDB has bootstrapProperties file that has various parameters to configure URLs for Tomcat to connect devices with back-end and front-end Mosquitto. The installer by default would configure both parameters with back-end Mosquitto as most users would be running with a single instance of Mosquitto.

  1. Open a command prompt and navigate to C:\Program Files\DELL\WMS\MongoDB\bin directory.
  2. Run the following command at the command prompt.>mongo stratus -u stratus -p <mongodbPassword> -eval "db.bootstrapProperties.update({'name': 'stratus.external.mqtt.url'}, {'name': 'stratus.external.mqtt.url' , 'value' : 'tcp://xyz-pns.wysemanagementsuite.com:1883' }, {upsert:true})"
  3. Restart Tomcat Service identified in Local Services as Dell WMS: Tomcat Service.

Remote repository

Wyse Management Suite allows you to have local and remote repositories for applications, operating system images and so on. If the user accounts are distributed across geographies, it would be efficient to have a separate local repository for each of the distributed user account so the devices can download images from its local repository. This flexibility is provided with WMS_Repo.exe software. The WMS_Repo.exe is a Wyse Management Suite file repository software that helps to create distributed remote repositories which can be registered with Wyse Management Suite. The WMS_Repo.exe is available only for Pro license subscribers only.

The server requirements to install Wyse Management Suite repository software are:
  • 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 5. Welcome screenWelcome screen
    Figure 6. Destination folder Destination folder
    Figure 7. Installation completed Installation completed
  4. Click Launch to launch the WMS Repository registration screen on the web browser.
    Figure 8. Registration details 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 9. Register on a public cloud Register on a public cloud
  6. Enter the following details, and press Register:
    1. Wyse Management Suite server URL
      • NOTE: Unless you register with Wyse Management Suite v1.0, you cannot use MQTT Server URL.


    2. WMS Repository URL (update the URL with the domain name)
    3. Wyse Management Suite administrator login username information
    4. Wyse Management Suite administrator login password information
    5. Repository path information
  7. If the registration is successful, the Registration window is displayed:
    Figure 10. Registration successful Registration successful
  8. The following screen on the Wyse Management Suite portal confirms the successful registration of the remote repository:
    Figure 11. Registration successful on the portal 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 12. Cerificate uploadCerificate upload
  10. The server restarts, and the uploaded certificate is displayed.
    Figure 13. SSL certificate enabled 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 14. Trust store certificates Trust store certificates
  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 15. Repository folderRepository folder

Manage Wyse Management Suite repository service

Wyse Management Suite repository is displayed as Dell WMS Repository: Tomcat Service in the Windows Local Services window and is configured to start automatically when the server restarts as shown: Dell WMS Repository: Tomcat Service


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: <>()\