Wyse Easy Setup

Version 1.0 Administrator’s Guide

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. Other trademarks
may be trademarks of their respective owners.

2018- 11

Rev. A02
 Contents

1 Introduction to Wyse Easy Setup....................................................................................................................4

Key features........................................................................................................................................................................ 4

2 Support matrix.............................................................................................................................................. 5

3 Downloading Wyse Easy Setup...................................................................................................................... 6

4 Installing Wyse Easy Setup............................................................................................................................ 7

Installing Wyse Easy Setup on a local device.................................................................................................................. 7
Installing Wyse Easy Setup by using Wyse Management Suite....................................................................................7
Installing Wyse Easy Setup on Windows 10 IoT Enterprise and Windows Embedded Standard 7P
operating systems........................................................................................................................................................ 8
Installing Wyse Easy Setup on Windows Embedded Standard 7E operating system..........................................8

5 Accessing Wyse Easy Setup.........................................................................................................................10

6 Configuring Wyse Easy Setup....................................................................................................................... 11

Configuring connections and applications......................................................................................................................11
User settings..................................................................................................................................................................... 13
User Interface settings.....................................................................................................................................................15

7 Deploying a configuration............................................................................................................................. 17
Deploying a configuration by using the Wyse Easy Setup application....................................................................... 17
Deploying a configuration by using Wyse Management Suite.................................................................................... 17

8 Troubleshooting Wyse Easy Setup................................................................................................................19

9 Tips and best practices................................................................................................................................20

Contents 3
 1
Introduction to Wyse Easy Setup
Wyse Easy Setup enables administrators to quickly and easily deploy configurations on thin clients running Windows 10 IoT Enterprise,
Windows Embedded Standard 7P, and Windows Embedded Standard 7E operating systems.

Wyse Easy Setup enables you to:

• Create a dedicated browser-focused client by configuring the Internet Explorer settings.

• Configure multiple broker connections such as Citrix, VMware, and Remote Desktop Protocol (RDP).
• Configure a device to create a dedicated application for a particular line of business.

You can create a kiosk mode to lock down a Windows device to prevent users from accessing any features or functions on the device
outside of the kiosk mode. You can also customize the kiosk interface to enable or disable user access to specific settings.

NOTE: Configurations on thin clients using the Wyse Easy Setup are applicable only to standard users. This feature is not
supported for domain accounts in KIOSK mode.

Key features
The following are the key features of Wyse Easy Setup:

• Provision to create a controlled and specialized experience for the users in the form of a customized Wyse Easy Setup shell. This
prevents users from accessing any features or functions on the device outside of the shell.
• Restricted control panel access
• An interface to launch the virtual desktop infrastructure (VDI) and applications
• Provision to add and launch the custom application
• Provision to add a custom Original Equipment Manufacturer’s (OEM) background and logo for the customized Wyse Easy Setup shell
• Support for custom features such as control on the application behavior when you exit VDI connections and applications.
• Custom shell taskbar and the Start menu
• An interface to configure the connections and applications, and the WyseEasyShell settings by using the Wyse Easy Setup
administrator application.
• Provision to configure custom desktop by using the local administrator user interface or Wyse Management Suite.

4 Introduction to Wyse Easy Setup

 2
Support matrix
The following table lists the operating systems and Dell Wyse thin clients, connection types, and applications supported by Wyse Easy
Setup:

Table 1. Support matrix

Operating system and Dell Wyse thin clients

• Windows 10 IoT Enterprise—English (en-US) only
– Latitude 3480 mobile thin client
– Latitude 5280 mobile thin client
– Wyse 5060 thin client
– Wyse 7040 thin client
– Wyse 5020 thin client with Win10 IoT
– Wyse 7020 thin client with Win10 IoT
– Wyse 7020 accelerated thin client with Win10 IoT
• Windows Embedded Standard 7P—English (en-US) only

– Latitude E3460 mobile thin client

– Latitude E7270 mobile thin client
– Wyse 5060 thin client
– Wyse 7040 thin client
– Wyse 5020 thin client with WES7P
– Wyse 7020 thin client with WES7P
• Windows Embedded Standard 7E—English (en-US) only

– Wyse 5020 thin client with WES7–D90Q7

– Wyse 7020 thin client with WES7–Z90Q7

Connection types
• Remote Desktop Protocol
• Citrix connection
• VMware Horizon View connection

Custom applications—Default
• Internet Explorer
• Calculator
• Notepad

Applications All traditional desktop applications that are supported by the

operating systems are compatible with Wyse Easy Setup.

Wyse Easy Setup does not support Windows Store applications.

Support matrix 5
 3
Downloading Wyse Easy Setup
Wyse Easy Setup is preinstalled on Wyse thin clients. It can also be downloaded from the Dell support site.

1 Go to downloads.dell.com.
2 Click the directory path that displays Wyse Easy Setup.
The download link for Wyse Easy Setup software along with relevant pdf files such as Release Notes and Administrator's Guide are
displayed on the web page.
3 Click the download link (.exe file) for Wyse Easy Setup and navigate to the location where you want to save the self-extracting .exe
file. This .exe file contains the Wyse Easy Setup installer.

NOTE: Download the WES7E_PreRequsite.ps1 file if you want to install Wyse Easy Setup on thin clients that run on
Windows Embedded Standard 7E operating system.

The file is downloaded in the location you have specified.

6 Downloading Wyse Easy Setup

 4
Installing Wyse Easy Setup
You can install Wyse Easy Setup using any of the following methods:

• Local installation directly on your thin client—see Installing Wyse Easy Setup directly on a local device
• Remote or silent installation from Wyse Management Suite—see Installing Wyse Easy Setup using Wyse Management Suite

Topics:

• Installing Wyse Easy Setup on a local device

• Installing Wyse Easy Setup by using Wyse Management Suite

Installing Wyse Easy Setup on a local device

Prerequisites

• Write filter in disabled state

• Minimum free disk space of 100 MB
• Minimum RAM disk size of 100 MB
• Microsoft Visual C++ Redistributable 2012 32–bit (x86) and 64–bit (x64)—For Windows 10 IoT Enterprise and Windows Embedded
Standard 7P operating systems
• Microsoft Visual C++ Redistributable 2012 32–bit (x86)—For Windows Embedded Standard 7E operating system
• Microsoft .NET Framework 4.5 and later versions
• Wyse Device Agent version 14.0.0.237 and later versions if you want to manage Wyse Easy Setup by using Wyse Management Suite
• Run the WES7E_PreRequsite.ps1 with PowerShell as an administrator—For Windows Embedded Standard 7E operating system only

Steps
1 Log in as an administrator.
2 Double-click the WyseEasySetup.exe file.
The Install Dell Wyse Easy Setup screen is displayed.
3 Read the license agreement and click Next.
The installer takes approximately 2–3 minutes to complete the installation.
4 After the installation is complete, click Exit.
5 To access the Wyse Easy Setup application, see Accessing Wyse Easy Setup.

NOTE: To run the installer silently on a local device, log in as an administrator, run the command prompt, and enter
WyseEasySetup.exe /s.

Installing Wyse Easy Setup by using Wyse

Management Suite
You can install Wyse Easy Setup on your Windows-based thin clients by using Wyse Management Suite.

To install Wyse Easy Setup on thin clients that run on Windows 10 IoT Enterprise and Windows Embedded Standard 7P operating systems,
see Installing Wyse Easy Setup on Windows 10 IoT Enterprise and Windows Embedded Standard 7P operating systems

Installing Wyse Easy Setup 7

To install Wyse Easy Setup on thin client that run on Windows Embedded Standard 7E operating system , see Installing Wyse Easy Setup
on Windows Embedded Standard 7E operating system

Installing Wyse Easy Setup on Windows 10 IoT Enterprise and

Windows Embedded Standard 7P operating systems
Prerequisites

• Write filter in disabled state

• Minimum free disk space of 100 MB
• Minimum RAM disk size of 100 MB
• Microsoft Visual C++ Redistributable 2012 32–bit (x86) and 64–bit (x64)
• Microsoft .NET Framework 4.5 or later versions
• Wyse Device Agent version 14.0.0.237 or later versions if you want to manage Wyse Easy Setup by using Wyse Management Suite

Steps
1 Log in to the Wyse Management Suite console.
2 Click Apps & Data.
3 In App Policies, click Thin Client.
4 Click Add Policy.
The Add Standard App Policy windows is displayed.
5 Enter the policy name.
6 Select the Group, Task, OS type, Application, OS Subtype Filter, and Platform Filter from the corresponding drop-down lists.
7 Enter /s in the Installer Parameters field.
8 Click Save.
9 Go to the Jobs page and schedule the job to start the silent installation of Wyse Easy Setup.

Installing Wyse Easy Setup on Windows Embedded Standard

7E operating system
Prerequisites

• Write filter in disabled state

• Minimum free disk space of 100 MB
• Minimum RAM disk size of 100 MB
• Microsoft Visual C++ Redistributable 2012 32–bit (x86)
• Microsoft .NET Framework 4.5 and later versions
• Wyse Device Agent version 14.0.0.237 and later versions if you want to manage Wyse Easy Setup by using Wyse Management Suite

Steps
1 Copy the Wyse Easy Setup installer and the power shell script file WES7E_PreRequsite.ps1 to deploy to the thin clients in the
thinClientApps folder in the local repository or the Wyse Management Suite repository.
2 In Apps & Data > App Inventory > Thin Client , verify if the application is registered.
3 In App Policies, click Thin Client.
4 Click Add Advanced Policy.
5 Enter the Policy Name.
6 From the Group drop-down list, select the group.
7 From the Task drop-down list, select Install Application.
8 From the OS Type drop-down list, select WES.

8 Installing Wyse Easy Setup

9 Click Add app, and select WyseEasySetup.exe under Apps.
10 From the Pre-install drop-down list, select WES7E_PreRequsite.ps1.
11 In the Install Parameters field, enter /s.
12 To cancel the application policy at first failure, select Enable app dependency. If this option is not selected, the policy does not run/
work due to application failure.
13 From the OS Subtype Filter drop-down list, select WES7 (Windows Embedded Standard 7).
14 From the Platform Filter drop-down list, select the platform to which you want to deploy the application.
15 In the Timeout field, specify the number of minutes the message dialog should be displayed on the client, which gives you time to save
your work before the installation begins.
16 From the Apply Policy Automatically drop-down list, select Apply the policy to new devices if you want to automatically apply this
policy to a device that is registered with Wyse Management Suite and belongs to a selected group or is moved to a selected group.
17 To create a policy, click Save. A message is displayed to allow administrators to schedule this policy on devices based on the group.
Select Yes to schedule the application policy for devices immediately or at a scheduled date and time on the App Policy Job page.
18 Go to the Jobs page and schedule the job to start the silent installation of Wyse Easy Setup.

Installing Wyse Easy Setup 9

 5
Accessing Wyse Easy Setup
You can access Wyse Easy Setup by using any one of the following methods:

• By using an administrator account:

a Log in as an administrator.
b Go to Start > Wyse > WyseEasySetupAdmin.
• By using a user account:
a Log in as a user.
b Go to Start > Wyse > WyseEasySetupAdmin.

The User Account Control window is displayed.

c Enter the administrator password, and click Yes.

NOTE: To configure the Wyse Easy Setup shell on thin clients that run on Windows Embedded Standard 7P operating system,
go to Start > All Programs > Wyse > WyseEasySetupAdmin, and enter the user name and password.
• By using the Wyse Easy Setup user shell in the kiosk mode:

a If the Admin Access is enabled, go to Start > Admin Access.

The User Account Control window is displayed.
b Enter the administrator password, and click Yes.

10 Accessing Wyse Easy Setup

 6
Configuring Wyse Easy Setup
You can configure Wyse Easy Setup by using any of the following methods:

• Wyse Management Suite 1.1 and later versions

• Local administrator user interface

NOTE: Write filter must be enabled to configure the Wyse Easy Setup.

Configuring Wyse Easy Setup involves the following tasks:

• Configure connections and applications—see Configuring connections and applications.

• Configure user settings—see Configuring user settings.
• Configure User Interface settings—see Configuring User Interface settings.

You can also configure Wyse Easy Setup using Wyse Management Suite 1.1 and later versions. For more information, see Wyse
Management Suite Administrator’s guide at support.dell.com/manuals.

NOTE: If a thin client is registered in Wyse Management Suite or Wyse Device Manager, the Wyse Easy Setup administrator user
interface is disabled.

Topics:

• Configuring connections and applications

• User settings
• User Interface settings

Configuring connections and applications

About this task
The Connections & Applications section in Wyse Easy Setup enables you to add and configure connections and applications for a user.

Configuring Wyse Easy Setup 11

Figure 1. Connections and Applications

Steps
1 Click the + icon in the Connections & Applications section.
The Available applications/connections to add dialog box is displayed.

12 Configuring Wyse Easy Setup

 Figure 2. Available applications/connections

The following options are available by default:

• RDP
• Citrix
• VMware Horizon View
• Browser
• Calculator
• Notepad

NOTE: To manually add an application, browse the application, and click Import.
2 Click the application or connection that you want to add and configure.
3 Click Save.
The configured application or connection is displayed in the Connections & Applications section.
4 Click Apply.

NOTE: You can add a maximum of 18 connections and applications in the Wyse Easy Setup shell.

User settings
The User Settings section enables you to configure the system specific settings for users. This section contains the following options:

Configuring Wyse Easy Setup 13

Figure 3. Connections and applications

Table 2. System

Option Description
Region/Language Enables the user to access the region and language option in the
control panel.
Date and time Enables the user to access the date and time option in the control
panel.
Display Enables the user to access the display option in the control panel.
Wi-Fi Enables the user to access the network option in the control panel.
Sound Enables the user to access the sound option in the control panel.
Ease of access Enables the user to access the easy of access option in the control
panel.

14 Configuring Wyse Easy Setup

Table 3. Peripherals

Option Description
Mouse Enables the user to access the mouse option in the control panel.
Keyboard Enables the user to access the keyboard option in the control panel.

User Interface settings

The User Interface section enables you to configure the taskbar and the Start menu. You can also personalize the background and the
logo on the user shell. The User Interface section contains the following options:

Figure 4. User Interface settings

Table 4. Kiosk mode

Option Description
Display Kiosk Mode If the Kiosk mode is enabled, the Wyse Easy Setup shell is
displayed, and the traditional Windows interface such as the
desktop and taskbar are inaccessible to users.

Configuring Wyse Easy Setup 15

Option Description

NOTE: If the Kiosk mode is disabled, only RDP, Citrix, and

VMware horizon view connections configurations are
displayed on the Windows desktop.

Exit Action Enables you to select the actions to be performed when a user
closes an application.
NOTE:
The Exit Action is enabled only if Display Kiosk Mode is
enabled, and a single application is configured.

Table 5. Personalization

Option Description
Background Enables the user to set a customized background.
To set a customized background, click Change, and select the
required background.

NOTE: The default Dell background is displayed if the

Background option is disabled or if the customized
background is not selected.

Logo Enables the user to add a customized logo in place of the default
Dell logo.

To set a customized logo in the background, click Change, and

browse to the required logo on your local drive.

Table 6. Taskbar

Option Description
Date and Time Enables the user to set the date and time option on the Wyse Easy
Setup shell or custom desktop.
Sound Enables the user to set the sound parameters in the Wyse Easy
Setup shell or custom desktop.
Network Status Enables the user to view the network option on the Wyse Easy
Setup shell or custom desktop.
Touch Keyboard Enables the user to view the touch keyboard on the Wyse Easy
Setup shell or custom desktop.

Table 7. Start Menu

Option Description
Admin Mode Enables the user to access administrator mode on the Wyse Easy
Setup shell or custom desktop.
Allow Shutdown Enables the user to shut down the system on the Wyse Easy Setup
shell or custom desktop.
Allow Restart Enables the user to restart the system on the Wyse Easy Setup
shell or custom desktop.
Allow Log off Enables the user to log off the system on the Wyse Easy Setup
shell or custom desktop.

16 Configuring Wyse Easy Setup

 7
Deploying a configuration
You can deploy a configuration to multiple thin clients by using the following methods:

• By using Wyse Easy Setup application

• By using Wyse Management Suite

Topics:

• Deploying a configuration by using the Wyse Easy Setup application

• Deploying a configuration by using Wyse Management Suite

Deploying a configuration by using the Wyse Easy

Setup application
Prerequisite
Before deploying a configuration, ensure that the thin client is not registered to Wyse Management Suite. If a thin client is registered in
Wyse Management Suite or Wyse Device Manager, the Wyse Easy Setup administrator user interface is disabled and an error message is
displayed.
Steps
1 Configure the settings by using WyseEasySetupAdmin—see Configuring Wyse Easy Setup.
2 Click the export icon.

Figure 5. Export and import

3 Save the configuration as a configuration or JSON file on a local drive or a shared location.
4 Copy the configuration file to the target thin client.
5 Start WyseEasySetupAdmin—see Accessing Wyse Easy Setup.
6 Click the import icon, and then click Apply.
The configuration is deployed to the target thin client.

Deploying a configuration by using Wyse Management

Suite
Prerequisite
Before deploying a configuration, ensure that the thin client is registered to Wyse Management Suite.
Steps
1 Log in to the Wyse Management Suite console.
2 Click Groups & Configs.
3 Select a group, and click Edit Policies.
4 Click WES.
5 Click Wyse Easy Setup.
6 After configuring the options, click Save and Publish.

Deploying a configuration 17
 NOTE:
• If the thin client is registered to Wyse Management Suite, all the local configurations deployed using the Wyse Easy Setup
administrator shell are discarded. The remote configurations deployed using Wyse Management Suite are applied.
• If the thin client is unregistered from Wyse Management Suite, the configurations deployed through Wyse Management Suite
are discarded. The local configurations deployed using the Wyse Easy Setup administrator shell are applied.

For more information, see Wyse Management Suite Administrator’s Guide at support.dell.com/manuals.

18 Deploying a configuration
 8
Troubleshooting Wyse Easy Setup
This section provides troubleshooting information for Wyse Easy Setup.

• Problem—Icons are not displayed in the taskbar of the Wyse Easy Setup shell.
Solution—Ensure that the Wyse Device Agent version 14.0.0.216 or above is installed on your thin client before you install Wyse Easy
Setup. Also, ensure that WyseEasySetupHookx86 and WyseEasySetupHookx64 run in the background.
• Problem—Citrix and VMware Horizon view connections are not displayed in the Connections & Applications area by default.
Solution—Ensure that Citrix and VMware are installed in the following default path:
– Citrix:
drive C\Program Files (x86)\VMware\VMware Horizon View Client\vmware-view.exe—64-bit operating system

drive C\Program Files\VMware\VMware Horizon View Client\vmware-view.exe—32-bit operating system

– VMWare:
drive C\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\SelfService.exe—64-bit operating system

drive C\Program Files\Citrix\ICA Client\SelfServicePlugin\SelfService.exe—32-bit operating system

Troubleshooting Wyse Easy Setup 19

 9
Tips and best practices
This section provides information about the best practices that you need to follow, and tips that help you to work effectively on Wyse Easy
Setup.

• Dell recommends that you use the default desktop resolution settings (full-screen) since the resolution settings available in the ICA and
RDP connection options are not indicative of the target monitor.
• To use USB redirection with an RDP connection when the VMware Horizon View client is installed, you must first disable the VMware
Horizon View USB service before you connect to an RDP session.
• Dell recommends that you set the Wyse Easy Setup shell display resolution to 1280x800.
• Export or import a configuration file to a folder that has read and write access for a user account from where you are configuring Wyse
Easy Setup.
• Ensure that the applications that you add as part of the configuration file do not have any permission restriction.
• You can run Wyse Easy Setup remotely if you import the application from a network location or locally if it is installed on the local
device.

20 Tips and best practices