Sie sind auf Seite 1von 80

Installation Guide

Wyse Streaming Manager

Issue: 022806
PN: 883875-01 Rev. A
Copyright Notices
© 2006, Wyse Technology Inc. All rights reserved.
This manual and the software and firmware described in it are copyrighted. You may not reproduce, transmit,
transcribe, store in a retrieval system, or translate into any language or computer language, in any form or by any
means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, any part of this publication
without express written permission.

End User License Agreement (“License”)


A copy of the Wyse Technology End User License Agreement is included in the software and provided for your
reference only. The License at http://www.wyse.com/license as of the purchase date is the controlling licensing
agreement. By copying, using, or installing the software or the product, you agree to be bound by those terms.

Trademarks
Wyse, WY, and WyseWorks are registered trademarks, and the Wyse logo, Winterm logo, Wyse, Winterm, Wyse
Expedian, and Alcatraz are trademarks of Wyse Technology Inc. Rapport is a registered trademark of Rapport
Technologies Inc., a division of Wyse Technology.
ICA is a registered trademark and MetaFrame is a trademark of Citrix Systems Inc.
Microsoft and Windows are registered trademarks of Microsoft Corporation.
All other products are trademarks and/or registered trademarks of their respective companies.
Specifications subject to change without notice.

Restricted Rights Legend


You acknowledge that the Software is of U.S. origin. You agree to comply with all applicable international and
national laws that apply to the Software, including the U.S. Export Administration Regulations, as well as end-user,
end-use and country destination restrictions issued by U.S. and other governments. For additional information on
exporting the Software, see http://www.microsoft.com/exporting.

Ordering Information
For availability, pricing, and ordering information in the United States and Canada, call 1-800-GET-WYSE
(1-800-438-9973) or visit us at http://www.wyse.com. In all other countries, contact your sales representative.
Contents
1 Introduction 1
About this Guide 1
Organization of this Guide 2
Wyse Technical Support 2
Links to Related Documentation and Services 2

2 Overview 5
System Overview 5
General Overview of the Installation Process 6

3 Preparing for Installation 7


Hardware Requirements 7
Software Requirements 7
Pre-Installation Checklist 8
Security and Credentials 9
Server to Server Communication Ports 9
Domain Names 10
Server License Files 10
Installing Microsoft SQL Server 2000 11
Installing the Latest Microsoft SQL Server 2000 Service Pack 12
Configuring a DHCP Server to Boot Thin Clients 12
Installing and Configuring TFTP 13

4 Installing and Configuring WSM Core Server 15


Installing WSM Core Server 15

5 Starting the Wyse Streaming Manager for the First Time 27


Using the Configuration Wizard 27

6 Installing and Configuring WSM Client 33


Preparing to Install WSM Client 33
Installing WSM Client on Wyse Thin Clients 33
Installing WSM Client in a VMWare Environment 33
Installing WSM Client 34
Capturing an OS Image to the Core Server 45
Configuring the OS Image 48

7 Installing and Configuring WSM Edge Server 51


Installing WSM Edge Server 51

8 System Maintenance 63
Passwords 63
Logs 63
iv Contents

Backup Recovery 64
System Monitoring 64

9 Troubleshooting 65
Enabling Active Directory for the First Time 65
Installing WSM Client on Windows XP 65
Network Devices are Unable to be Created in Active Directory 66
HTTP Error:404 /admin/ not found RequestURL=/admin/ powered by jetty 66
Verifying the Status of the Wyse Streaming Manager Service Files 67
Re-configuring an OS Image 68
Uninstalling Wyse Streaming Manager 70

A Error Codes 71

Figures 73

Tables 75
1 Introduction
Wyse Streaming Manager is an operating system and application distribution and
streaming technology that provides a cost-effective method to rapidly deploy and manage
operating systems and applications to a large pool of users. It provides core functions for
streaming operating systems and applications to subscribers.
Wyse Streaming Manager main features include:
• Patented streaming operating system and application technology.
• Anti-piracy protection of operating system and application code.
• Usage metrics collection.
• Licensing policies to enforce all operating system and application usage.
• Scalability and built-in fail-over support.

About this Guide


This guide is intended for administrators of the Wyse Streaming Manager system. It
describes the Wyse Streaming Manager installation process for Windows servers and
clients. This guide provides the step-by-step instructions you need to install and configure
a Wyse Streaming Manager environment. It also includes the requirements you must
address before you begin the installation procedures.
This installation guide is intended for experienced network administrators and Information
Technology professionals who have installed and configured Windows operating systems
and applications.
It is recommended that you have the following technical knowledge:
• Working knowledge of Windows Server 2000 and Windows Server 2003.
• Working knowledge of client/server systems and technologies.
• A conceptual understanding of database systems and SQL server.
• Working knowledge and understanding of the Windows registry, including machine
profiles, user profiles, and software registry entries.
• Experience in an environment with some automated/centralized networking tool is a
major plus (Tivoli, Openview, Unicenter, etc.)
• Understanding of the Jetty Web server.
• Knowledge of network monitoring tools.
2 Chapter 1

Organization of this Guide


This guide is organized as follows:
• Chapter 2, "Overview," provides an overview of the Wyse Streaming Manager system
and a general overview of the installation process.
• Chapter 3, "Preparing for Installation," contains hardware and software requirements
and the procedures you must complete to prepare the environment for the Wyse
Streaming Manager system installation.
• Chapter 4, "Installing and Configuring WSM Core Server," provides the detailed
procedures you must complete to install the Wyse Streaming Manager Core Server.
• Chapter 5, "Starting the Wyse Streaming Manager for the First Time," provides the
detailed procedures you must complete to start the Wyse Streaming Manager for the
first time.
• Chapter 6, "Installing and Configuring WSM Client," provides the detailed procedures
you must complete to install the Wyse Streaming Manager Client.
• Chapter 7, "Installing and Configuring WSM Edge Server," provides the detailed
procedures you must complete to install the Wyse Streaming Manager Edge Server.
• Chapter 8, "System Maintenance," contains information to help you successfully
maintain the Wyse Streaming Manager system.
• Chapter 9, "Troubleshooting," provides information and help on installation, setup,
conflicts, and general troubleshooting.
• Appendix A, "Error Codes," includes the most common errors that you may encounter,
either in a displayed message box or in a log file.

Wyse Technical Support


To access Wyse technical resources, visit AskWyse.com. If you still have questions, you
can submit your questions using the Wyse Support Request Form, or call Customer
Support at 1-800-800-WYSE (toll free in U.S. and Canada). Hours of operation are from
7:00 am to 7:00 pm CST, Monday through Friday.
To access international support, visit http://www.wyse.com/global.

Links to Related Documentation and Services


Wyse Streaming Manager features can be found in the Wyse Streaming Manager
Datasheet. It is available on the Wyse Web site at:
http://www.wyse.com/products/software/streamingmanager.
The Wyse Streaming Manager Publisher Guide is intended for administrators of the Wyse
Streaming Manager system. It describes how to use Wyse Streaming Manager Publisher
to publish applications and to make them available for distribution.

The Wyse Streaming Manager Administrators Guide is intended for administrators of the
Wyse Streaming Manager system. It provides information, and detailed system command
and parameter configurations, to help administrators design and manage a Wyse
Streaming Manager environment. It also explains how to use Wyse Streaming Manager,
manage the availability of software applications for distribution to subscribers, manage
application subscription licenses, install and configure published applications, provide
subscriber profile and billing information for efficient application usage tracking, and
control subscriber access to the Wyse Streaming Manager system.
Introduction 3

The Wyse Streaming Manager Users Guide is intended for users of the Wyse Streaming
Manager Client system. It provides detailed instructions on using the Wyse Streaming
Manager Client to manage the applications available to users from a network server.
Wyse Thin Computing Software is available on the Wyse Web site at:
http://www.wyse.com/products/software.
4 Chapter 1

This page intentionally blank.


2 Overview
This section provides an overview of the Wyse Streaming Manager system and a general
overview of the installation process.

System Overview
Wyse Streaming Manager is a software-based thin-computing solution that allows IT staff
to deploy a standardized operating system and applications to stateless thin computers (or
thin-computing devices) from a central location. By streaming the entire operating system
and applications, Wyse Streaming Manager makes it possible for thin computers to
operate like a PC, but without the local storage. Streaming the operating system and
applications independent of each other makes it easier for IT to backup, update, manage,
maintain, and support multitudes of desktops with minimal staff.
This Wyse software-only solution takes advantage of existing computing, network, and
storage elements. It does not require specialized hardware, proprietary BIOS extensions,
or highly specialized adapters such as IP/iSCSI host bus adapters. In order to boot over
the network, client systems use PXE (Pre-Boot eXecution Environment). PXE is an open
industry specification that defines how network clients automatically download both
software images and configuration parameters. PXE was designed to assist in system
manageability, including such tasks as remotely installing an operating system, or as an
emergency boot method (in the case of a client systems hardware or software failing). The
Wyse solution uses PXE to download a bootstrap file that will then load the Windows
operating system. PXE is common on almost all personal computers with an integrated
network interface, and is also standard in many Network Interface Cards.
Wyse Streaming Manager includes:
• An easy-to-use operating system image-creation tool for IT administrators that allows
them to create and deploy operating system images. This tool is installed as part of the
Wyse Streaming Manager Client.
• An application packager, Wyse Streaming Manager Publisher, that allows IT
administrators to create and deploy application images.
• A centralized Web-based management interface installed with the Wyse Streaming
Manager Core Server.
• Windows Server-based services which include:
• OS Authentication Service - Allows you to manually start and stop the
authentication service for the Wyse Streaming Manager.
• OS Streaming Service - Allows you to manually start and stop the streaming service
for the Wyse Streaming Manager.
• Application Authentication Service - Manages subscriber licenses and metering
application usage.
• Application Streaming Service - Services end-user application client requests.
6 Chapter 2

• Monitor Service - Monitors and controls the Wyse Streaming Manager Services on
the machine to which it is loaded.
• Content Distribution Service - Allows you to synchronize the repositories of OS and
Application images between the Core and remote servers.
These services and applications are briefly introduced in this installation guide during the
installation process, however, the actual usage of the Wyse Streaming Manager tools are
more fully discussed in the Wyse Streaming Manager Administrators Guide.

General Overview of the Installation Process


This section contains a general overview of the steps you need to complete to install the
Wyse Streaming Manager system. Detailed procedures of these general steps are found
in the appropriate sections of this installation guide.
To install the Wyse Streaming Manager system:
1. Prepare for installation by completing all pre-installation requirements as described in
"Preparing for Installation."
2. Install Wyse Streaming Manager Core Server by completing the procedures in
"Installing and Configuring WSM Core Server."
3. Start the Wyse Streaming Manager as described in "Starting the Wyse Streaming
Manager for the First Time."
4. Install and configure the Wyse Streaming Manager Client by completing the
procedures in "Installing and Configuring WSM Client."
5. (Optional) Install Wyse Streaming Manager Edge Server by completing the procedures
in "Installing and Configuring WSM Edge Server."
3 Preparing for Installation
This section contains hardware and software requirements and the procedures you must
complete to prepare the environment for the Wyse Streaming Manager system
installation. If you configure multiple machines, you will repeat some of the steps. You
must complete the Wyse Streaming Manager Core Server and Wyse Streaming Manager
Client installation steps for each related machine being configured.

Hardware Requirements
Each machine must meet or exceed the minimum system requirements shown in Table 1.

Table 1 Server Hardware Requirements

Category Minimum Requirements Recommended

CPU 733 MHz CPU 1 GHz dual CPU or higher

RAM 512 MB 1 GB or higher

Disk Space 20 GB + AppSets size 20 GB (RAID) + AppSets


size (if applicable)

Network Interface Card (NIC) 100 Mbps 100 Mbps/1 Gbps

Note
These requirements may vary due to application and operating system sizes.

Software Requirements
In addition to the Wyse Streaming Manager software, the following software must be
installed on each server as shown in Table 2.

Table 2 Server Software Requirements

Hardware or Machine Software Requirements

Operating System Microsoft Windows 2000 Server SP4 or Windows 2003


Server

Database Server Microsoft SQL Server 2000

Directory Service (optional) Microsoft Active Directory 2000 or 2003

Note
It is highly recommended that all software be updated to the latest versions.
8 Chapter 3

Pre-Installation Checklist
To help ensure a trouble-free installation use this checklist to verify that you have the
required items and have completed the required procedures before you start the
installation.
• Obtain and configure all hardware, as planned for in this section.
• Be sure to have administrator rights on all systems to begin the server installations.
• Install Windows 2000 Server or Windows 2003 Server systems on all server machines.
Be sure that all systems are up-to-date with current Microsoft service packs, patches,
and updates.
• Download and install Microsoft Internet Explorer (IE) 6.0 or later on all machines (for
complete information on downloading and installing IE 6.0 or later, refer to the
Microsoft Web site).
• A minimum of one public IP addresses will be required, be sure to set-up DNS entries
for these (for information on these Domain Names, refer to "Domain Names").
• Obtain a Server License File from Wyse (provided to you in e-mail) for the system as
described in "Server License Files."
• Install the Microsoft SQL Server 2000 as described in "Installing Microsoft SQL Server
2000." Be sure that the server is running before you begin installing WSM.
• Download and install the latest Microsoft SQL Server 2000 Service Pack as described
in "Installing the Latest Microsoft SQL Server 2000 Service Pack."
• Download and install the Microsoft SQL Server 2000 Driver for JDBC Service Pack 3
onto the Core Server (for complete information on downloading and installing the
driver, refer to the Microsoft Web site).
• Download and install the latest version of Microsoft Data Access Components (MDAC)
on the Core Server (for complete information on downloading and installing MDAC,
refer to the Microsoft Web site).
• Configure the DHCP Server as described in "Configuring a DHCP Server to Boot Thin
Clients."
• Install and configure the Trivial FTP (TFTP) Windows component as described in
"Installing and Configuring TFTP."
• If you are planning to integrate Active Directory with Wyse Streaming Manager as
described in "Starting the Wyse Streaming Manager for the First Time," be sure that the
Core Server and the Active Directory Server are part of the Domain before the
administrator of the local system begins installing WSM Core Server. Also be sure that
you create a new user in the Active Directory with the username password that you
intend to use during the WSM Core Server installation (database Server screen). In
addition, be sure that the display name for this user is the same as the username
• If you are planning to install and configure WSM Edge Server as described in
"Installing and Configuring WSM Edge Server" and you want to manage (Start and
Stop) the services on the Edge Server from the Wyse Streaming Manager
Administrator Console, be sure that the Core Server and the Edge Server are part of
the Domain and that all installations are done by the administrator of the local system.
Also, be sure to create a Domain user and make this Domain user a member of the
Local Administrator group of the Core Server and Edge Server machines. In addition,
ensure that the Remote Registry Service is running on the Core Server before you
begin installing an Edge Server.
Preparing for Installation 9

Security and Credentials


To ensure security Wyse Streaming Manager uses various credentials. Most of these are
common for system administrators. The only new credential is for the Wyse Streaming
Manager system itself.
The following credentials will require passwords when they are installed.
• Wyse Streaming Manager Database – The database requires a username and
password for executing SQL queries. Each server in Wyse Streaming Manager
requires this password to access the database. This information is stored encrypted in
the Windows registry after installation. The default account is wsmdb. The default
password is wsmdb.
• Windows Service – All Wyse Streaming Manager servers are required to run as
Windows Service with local system privileges. However, if a depot is located on a
network file share, the service needs an account with both local system access and
access to the file share. This is configured and can be modified under the Management
Console for Windows Services.
• Wyse Streaming Manager – To administer the Wyse Streaming Manager provider
environment, a default account named admin must be created in the system. This
account enables you to log on for the first time and to configure the system. You can
change the default password (admin) after you log in for the first time.

Server to Server Communication Ports


The servers communicate through the port attribute in the Server table. These values are
not exposed through the Administrator Console. However, a mechanism is in place to
resolve port conflicts at startup. When the server detects a port conflict, it will try to
allocate another port above it (For example: 5000 + 1, 5000 + 2, 5000 + 3, and so on). It
will try for a maximum of 100 times before failing.
The following is a list of servers and default Server/Server communication ports:
• Monitor Service (Default Port Range: 5000-5100)
• Application Authentication Service (Default Port: 8001)
• Application Streaming Service (Default Port: 8002)
• Operating System Authentication Service (Default Port: 6910)
• Operating System Streaming Service (Default Port: 6911 - NOTE that this port can be
configured to a different port by an administrator through the Administrator UI)

Note
Ensure that these ports are open for proper communication between servers.

If you have a firewall enabled on any server where Wyse Streaming manager is installed,
ensure that the services and ports are configured as follows:
• Services:
• WSM Multicast boot service
• WSM OS streaming service
10 Chapter 3

• Ports:
• Application Streaming Service (Default Core Server Port: 8002 and Default Edge
Server Port: 8001)
• Operating System Streaming Service (Default Port: 6911 - NOTE that this port can
be configured to a different port by an administrator through the Administrator UI)
• NetBIOS Name Service (Default Port: 137)
• TFTP Service (Default Port: 69)

Domain Names
It is important to use DNS entries for mapping IPs to servers. Although you can use IP
addresses, it will make scaling and system changes more difficult. This entry point DNS
will be used to allow the client to talk to the server farm. The DNS name that is used
should be entered into the machine name when configuring the core server (as described
in "Installing and Configuring WSM Core Server"). Also, the client port configured in that
section, will be the port used by the clients and will need to be configured in both the
firewall and load-balancing switch. Wyse Streaming Manager requires a minimum of two
public IP addresses with DNS entries.

Server License Files


You need to obtain license files to start the system and register network devices (license
files are provided to you in e-mail by Wyse). Wyse Technology uses License files to
control client seats and prevent software piracy. A license file is encrypted using a PKI to
sign each key based on x509 SSL Certificate.
You need a key for any of the following reasons:
• adding additional network devices
• license expiration
License files are stored in the database in an encrypted format. You can add the license
file to the system by using the Administrator Console (after the server installation is
complete). For instructions on adding the licenses file, refer to "Starting the Wyse
Streaming Manager for the First Time." For more details on the Administrator Console,
refer to the Wyse Streaming Manage Administrators Guide.
Preparing for Installation 11

Installing Microsoft SQL Server 2000


It is recommended that you install the Database Server on a server machine that is
separate from the Wyse Streaming Manager servers. Ensure that the network is
configured to allow all servers to communicate with the database on the configured SQL
port. However, the Database Server can be installed on the same machine as the Wyse
Streaming Manager servers for a single-server installation. All servers will authenticate
with the database using configured credentials.

Note
You should refer to the documentation provided by the database vendor for
complete installation instructions, performance enhancements, and setup.

To install the Microsoft SQL Server 2000:


1. Start the SQL Server 2000 installation and select the Install SQL Server 2000
Components option.
2. Select the Database Server option, select the Local Computer option, and click Next.
3. Select the Create a new instance of SQL server, or install client tools installation
option and click Next.
4. Enter your name, company name, and click Next.
5. After reading and agreeing to the End User License Agreement, click Yes.
6. Select the Server and Client Tools installation option and click Next.
7. Select the Default installation option and click Next.
8. Select the Typical setup type option and click Next.
9. Within the Service Account window, ensure that the Use the same account for each
service option is selected.
10.Select one of the following Service Setting options:
• If you plan to install all of the components of the Wyse Streaming Manager Core
Server onto one server, select the Use the Local System Account option and click
Next.
• If you have a domain level user account, select the Use a Domain User Account
option, enter the appropriate account information, and click Next.
11. Select the Mixed Mode authentication mode option and click Next.

Note
Verify that the database is configured to run in Mixed Mode for
authentication. Wyse Streaming Manager uses both ODBC and JDBC to
communicate with the database using SQL authentication. If Mixed Mode is
not chosen, the servers cannot communicate with the database. This setting
is located under the Security tab of the database properties labelled SQL
Server and Windows NT.

12.Click Next to start the installation.


13.Select a licensing mode and click Next.
14.After the setup is complete click Finish, and continue with "Installing the Latest
Microsoft SQL Server 2000 Service Pack."
12 Chapter 3

Installing the Latest Microsoft SQL Server 2000 Service Pack


It is recommended that you download and install the latest service pack for the SQL
Server version that you are using. For Windows Server 2003, SQL Server 2000 Service
Pack 3a or later is required. For complete information on SQL service packs, refer to the
Microsoft Web site.

Note
If you are given the option to modify the Authentication Mode during service
pack installation, select Mixed Mode to allow the Wyse Streaming Manager
Core Server software to access the database.

Configuring a DHCP Server to Boot Thin Clients


Some DHCP servers can provide all of the boot information to a thin client (including, IP
address, boot server name, and boot file name). Using such a server eliminates the need
for the PXE service. For example, you can set the DHCP options for a Microsoft DHCP
server as shown in Table 3.

Table 3 Example of DHCP server options

DHCP
Option
Number Purpose DHCP Option Value for the Thin Client

03 Gateway Specific to the network.


If a DNS server is not on the local area network
then specify the IP address of the gateway for the
local area network in which the client resides.
Otherwise, this option is optional.

06 IP Address of the Specify the IP address of DNS server that


DNS Server contains the record for the boot server.

66 Boot server name Fully qualified domain name of the server running
the TFTP service (e.g. boot.company.com)

67 Boot file name Boot file named VLDRMI13.BIN.


Preparing for Installation 13

Installing and Configuring TFTP


You must install Trivial FTP (TFTP). You can install a third party Trivial FTP (TFTP) or the
Trivial FTP (TFTP) Windows component.
To install a third party Trivial FTP (TFTP), follow the installation procedures of the software
you obtain.
To install the Trivial FTP (TFTP) Windows component, install the Windows Remote
Installation Services Setup (as this will provide the TFTP service). Install the Remote
Installation Services Setup by clicking Start | Programs | Administrative Tools | Remote
Installation Services Setup and completing the Remote Installation Services Setup
Wizard.
Be sure to change the Registry Setting by going to:
hklm\system\current control set\services\TFTPD\parameters

Note
The default location is: C:/program files/wyse/wsm/os/TFTPboot

and adding a string value named directory with a value=<the Path to the
TFTPBOOT directory>.

Note
The parameters key does not exist by default in Windows 2000 Advanced
Server. This key must be created.

After you have completed installation and configuration, be sure to start the TFTP
Daemon.
14 Chapter 3

This page intentionally blank.


4 Installing and Configuring WSM
Core Server
This section provides the detailed procedures you must complete to install the Wyse
Streaming Manager Core Server. Although you can select customized installation
configurations during the installation, it is recommended that you use the default
configurations.

Note
Be sure you have completed all pre-installation requirements as described in
"Preparing for Installation" before you begin installing WSM Core Server.

Installing WSM Core Server


To install WSM Core Server:
1. After downloading the Wyse Streaming Manager Core Server software, double-click
the WSMCoreServer.exe to open the InstallShield Wizard.

Figure 1 InstallShield Wizard

2. Click Next to open the Welcome window.


16 Chapter 4

Figure 2 InstallShield Welcome

3. Click Next to open the License Agreement window.


Installing and Configuring WSM Core Server 17

Figure 3 License Agreement

4. After reading the agreement, select the I accept the terms in the license agreement
option and click Next to open the Destination Folder window.
18 Chapter 4

Figure 4 Destination Folder

5. Click Next to open the Streaming Directory Information window.


Installing and Configuring WSM Core Server 19

Figure 5 Streaming Directory Information

Note
The Streaming Directory is where the Write Cache files, OS Images, and
Application Images will be stored.

6. Click Next to open the Database Server window.


20 Chapter 4

Figure 6 Database Server

7. Use the following guidelines to complete the Database Server window:


• Enter the Database Name you want to use for the SQL server (default is
StreamingDB).

Note
Do not use special characters for the Database Name.

• Enter the Username for the database (default is wsmdb).


• Enter the Password for the database (default is wsmdb).

Note
If you are using Active Directory, be sure you use a password that meets the
requirements of the policy settings in Active Directory. In addition, be sure to
use the same username and password that you created in the
"Pre-Installation Checklist."

• Confirm the password by re-typing it in the Re-Type Password text box.

Note
If you will be installing WSM Edge Server, be sure to remember the
information you enter in this Database Server window, as you will need this
information when you install WSM Edge Server.

• Click Next to open the SQL Server window.


Installing and Configuring WSM Core Server 21

Figure 7 SQL Server

8. Use the following guidelines to complete the SQL Server window:


• Enter the SQL Server IP Address or Name in the SQL Server text box (you can use
Browse to find the server you want).
• For WSM to successfully install, you must select the SQL Server authentication
using the Login ID ad password below option for your connection.
• Enter the Login ID and Password for the server in the appropriate text boxes.
• Click Next to open the Ready to Install the Program window.
22 Chapter 4

Figure 8 Ready to Install the Program

9. Click Install to begin the installation.


Installing and Configuring WSM Core Server 23

Figure 9 Installing WSM Core Server

Caution
Do not interrupt the installation.

During the installation, the WSM Core Server Config Wizard opens.
24 Chapter 4

Figure 10 WSM Core Server Config Wizard

10.Use the following guidelines to complete the WSM Core Server Config Wizard:
• Select the IP address to be used by the WSM OS Streaming Service from the list of
IP addresses available (the default IP address is first in the list; the Subnet Mask
and Gateway are automatically entered).
• Depending on whether or not you are integrating Active Directory with Wyse
Streaming Manager, select or clear the Enable Active Directory Integration check
box. If you enable Active Directory Integration, enter the Active Directory Server IP
address.
• Enter the OS Authentication and OS Streaming Server Port information (default is
automatically entered).
• Select the Bootstrap file to download from the server (default is automatically
entered, however you can use Browse to make a different selection).
• Click OK to save the configurations, close the WSM Core Server Config Wizard,
and open the InstallShield Wizard Completed window.
Installing and Configuring WSM Core Server 25

Figure 11 InstallShield Wizard Completed

11. Click Finish to close the InstallShield Wizard.


12.Continue with "Starting the Wyse Streaming Manager for the First Time."

Note
If you plan on installing the Edge Server as described in "Installing WSM
Edge Server," you must use the Services Console to stop all WSM Services,
configure the WSM Services to run with the same login credentials as the
Domain User as you configured in the "Pre-Installation Checklist," and then
restart all WSM Services.
26 Chapter 4

This page intentionally blank.


5 Starting the Wyse Streaming
Manager for the First Time
This section provides the detailed procedures you must complete to start the Wyse
Streaming Manager for the first time.

Note
Be sure you have successfully installed the WSM Core Server before you
complete the procedures in this section.

Using the Configuration Wizard


After you successfully install the WSM Core Server, you must use the Configuration
Wizard to add your Core Server License (required) and enable Active Directory integration
with Wyse Steaming Manager (optional).
To complete the Configuration Wizard:
1. Open the Administrator Console login page by clicking Start | WSM Server | WSM on
the machine to which you have installed the WSM Core Server (you can also open a
Web browser from any machine with access to the WSM Core Server and go to http://
<ipaddress>:8080/admin/login.htm).

Figure 12 Login
28 Chapter 5

2. Enter the Admin Username (default is admin) and Password (default is admin) and
click Login to open the Import Server License page.

Figure 13 Import Server License

3. Click Browse to find and select the license.txt file that was provided to you by
Wyse, and then click Import Server License to import the license and view the valid
dates of the license.
Starting the Wyse Streaming Manager for the First Time 29

Figure 14 Valid dates of successfully added license

4. Click Next to open the Configure Active Directory page.

Figure 15 Configure Active Directory

5. Depending on whether or not you want to enable Active Directory integration with
Wyse Streaming Manager select or clear the Enable Active Directory check box.

Note
If you need to configure or re-configure the Active Directory in the future,
refer to the Wyse Streaming Manager Administrators Guide.
30 Chapter 5

If you select the Enable Active Directory check box, the Configure Active Directory
page expands.

Figure 16 Configure Active Directory page - expanded

Use the following guidelines to complete the Configure Active Directory page:
• Enter the Domain of the Active Directory (for example, wsm.com).
• Enter the Active Directory Server Port.
• Enter the Group Root of the Active Directory (if left blank the root is assumed to be
the top level of the Active Directory).
• Enter the Group Synchronizing Polling Frequency time (number of seconds
between synchronizing the members of user groups between the Active Directory
and the Wyse Streaming manager database; the default is 600 seconds, however,
you can turn off the feature by setting the time to 0).

Note
If you have trouble connecting to the Active Directory after clicking Finish, be
sure that the Core Server and the Active Directory Server are part of the
Domain before the administrator of the local system begins installing WSM
Core Server as described in "Pre-Installation Checklist."

6. Click Finish to view the System Overview Congratulations page.


Starting the Wyse Streaming Manager for the First Time 31

Figure 17 System Overview Congratulations

7. After completing the Configuration Wizard, you can view the Core Server Details page
to see that the Core Server Services are successfully running by clicking the Servers
link in the Category list on the System Overview page, and then clicking the Name link
of the Core Server.
32 Chapter 5

Figure 18 Core Server Details page

Now that the Core Server services are running, you can continue to configure the rest of
the Wyse Streaming Manager system according to your environment by following the
appropriate procedures in the Wyse Streaming Manager Administrators Guide.
6 Installing and Configuring WSM
Client
This section provides the detailed procedures you must complete to install the Wyse
Streaming Manager Client. Although you can select customized installation configurations
during the installation, it is recommended that you use the default configurations.

Note
Be sure you have completed all pre-installation requirements as described in
"Preparing for Installation" before you begin installing WSM Client.

Preparing to Install WSM Client


This section contains the procedures you must complete to prepare the environment for
the WSM Client installation. Before you begin installing WSM Client, you must first decide
where and how you want to install the WSM Client and complete all pre-installation
requirements for the installation environment you want. After preparing the environment,
you can install WSM Client as described in "Installing WSM Client."

Installing WSM Client on Wyse Thin Clients


If you are planning to install WSM Client on Wyse thin clients, you must complete the
following:
• Access to reference device VRO with 4GB of flash -
• Use USB CD ROM drive - Although you can use other USB CD ROM drives, the
following are certified for use.
• IBM USB CDROM, Model Part Number 00N8239
• Addonics USB CDROM, Model Part Number AECD2K32UM.
• Install the Microsoft operating system on the flash.

Installing WSM Client in a VMWare Environment


If you are planning to use WSM in a VMWare environment, you must complete the
following:
• Create a target VM machine on an ESX Server as described on the VMWare Web site
and install the Microsoft operating system in VM.
• Use USB CD ROM drive - Although you can use other USB CD ROM drives, the
following are certified for use.
• IBM USB CDROM, Model Part Number 00N8239
• Addonics USB CDROM, Model Part Number AECD2K32UM.
34 Chapter 6

Installing WSM Client


To install WSM Client:
1. After downloading the Wyse Streaming Manager Client software, double-click the
WSM Client.exe to open the InstallShield Wizard.

Figure 19 InstallShield Wizard

2. Click Next to open the License Agreement window.


Installing and Configuring WSM Client 35

Figure 20 License Agreement

3. After reading the agreement, select the I accept the terms in the license agreement
option and click Next to open the Customer Information window.
36 Chapter 6

Figure 21 Customer Information

4. Enter the User Name and Organization and click Next to open the Destination Folder
window.
Installing and Configuring WSM Client 37

Figure 22 Destination Folder

5. Click Next to open the Ready to Install the Program window.


38 Chapter 6

Figure 23 Ready to Install the Program

6. Click Install to begin the installation.

Figure 24 Installing WSM Client


Installing and Configuring WSM Client 39

Note
During installation, Windows Logo testing messages may appear in front of
or behind the wizard windows. If these messages appear, click Continue
Anyway to continue installation.

Figure 25 Windows Logo testing message

During the installation, the Found New Hardware Wizard opens.


40 Chapter 6

Figure 26 Found New Hardware Wizard

7. Select the Install the software automatically (Recommended) option and click Next
to begin installation.
Installing and Configuring WSM Client 41

Figure 27 Installing hardware

After the software is installed, the Completing the Found New Hardware Wizard
window appears.
42 Chapter 6

Figure 28 Completing the Found New Hardware Wizard

8. Click Finish to close the wizard and open the WSM Client Config Wizard.
Installing and Configuring WSM Client 43

Figure 29 WSM Client Config Wizard

9. Use the following guidelines to complete the WSM Client Config Wizard:
• Enter the Authentication Server Info IP address to be used by the WSM OS
Authentication Service (this address is the same as the Core Server). The default
Port information is automatically entered.
• Enter the Imaging Server Info IP address to be used by the WSM OS Streaming
Service (this address is the same as the Authentication Server Info IP Address).
The default Port information is automatically entered.

Note
The default Client Info IP Address and Port, Subnet Mask, and Gateway IP
Address are automatically entered.

• Click OK to close the WSM Client Config Wizard and open the InstallShield Wizard
Completed window.
44 Chapter 6

Figure 30 InstallShield Wizard Completed

10.Click Finish to close the InstallShield Wizard.


After completing the procedures in this section, reboot the system (Escape out of the
network boot by using ESC) and continue with "Capturing an OS Image to the Core
Server."
Installing and Configuring WSM Client 45

Capturing an OS Image to the Core Server


After installing the Wyse Streaming Manager Client software, you must capture an OS
Image to a Core Server.

Note
Be sure you have all peripherals you want to use (for example, keyboard,
mouse, printers and so on) connected before you begin capturing the OS
Image to the Core Server.

To capture an OS Image to the Core Server:


1. After installing the Wyse Streaming Manager Client software, locate the
OSMVDiskImage.exe (default location is C:\Program Files\Wyse\WSM\os).

Figure 31 OSMVDiskImage.exe

2. Double-click the OSMVDiskImage.exe to open the WSM VDisk Image Creation Utility
window.
46 Chapter 6

Figure 32 WSM VDisk Image Creation Utility

3. Enter the Virtual disk size (if you are running in shared mode, the maximum virtual disk
size is 8 GB).
4. Enter a Disk name.
5. (Optional) Enter a Description for the disk.
6. Depending on whether or not you want to integrate WSM Streaming Manager with
Active Directory, select or clear the Enable Active Directory Integration check box.
7. Click OK to begin building the virtual disk.
Installing and Configuring WSM Client 47

Figure 33 Building Virtual Disk

After building is complete, the Done message appears in the WSM VDisk Image
Creation Utility window.

Figure 34 Done message

8. Click Finish to complete the OS Image capturing process.


After completing the procedures in this section, continue with "Configuring the OS Image."
48 Chapter 6

Configuring the OS Image


After capturing an OS Image to a Core Server, you must configure the OS Image using the
Administrator Console.

Note
When a user starts the WSM Client device for the first time, they may
encounter a WSM Client Login in progress message. This will occur for all
users who log in and are not yet registered in the WSM database.
Completing the procedures in this section prevents these users from
encountering these messages.

To configure the OS Image:


1. Log in to the Administrator Console, add the OS Image you created in "Capturing an
OS Image to the Core Server," and assign the OS Image to a Core Server. For
procedures on adding an OS Image and assigning it to a server, refer to the Wyse
Streaming Manager Administrators Guide.

Note
For the Mode be sure to select the No Cache (Private Mode) option when
you add the OS Image.

2. Reboot the machine to which you installed the WSM Client, and use the following
guidelines for the DOS prompts:
• You must enter the client name.
• Entering a description is optional.
• Be sure you select the vdisk you just added in "Capturing an OS Image to the Core
Server."
• Press any key to restart the system.

Note
Upon system restart, close the WSM Client Login in progress message that
appears (right-click the minimized application in the taskbar and select Close
to close the window).

Figure 35 WSM Client Login in progress message


Installing and Configuring WSM Client 49

3. Upon system restart, the System Settings Change message appears; when this
message appears, click No to close the window. Note that this is a good time to clean
up or customize your environment (for example, selecting the desktop background,
and so on, prior to sharing the OS Image on multiple client machines).

Figure 36 System Settings Change message

4. After you have completed customizing your environment, shut down the client
machine.
5. After the client machine has shut down, log in to the Administrator Console.
6. Edit the OS Image you created in "Capturing an OS Image to the Core Server," so that
either the Persistent Cache (Shared Mode) or Volatile Cache (Shared Mode) option
is selected for the Mode. For procedures on editing an OS Image, refer to the Wyse
Streaming Manager Administrators Guide.
After completing the procedures in this section the OS Image is ready to be used by
multiple client machines. For more information on setting up your Wyse Streaming
Manager environment, refer to the Wyse Streaming Manager Administrators Guide.

Note
In the future, if you want to copy or move an OS Image from one streaming
server (for example, a lab environment) to another streaming server (for
example, a production server), or if you want to change the current Active
Directory integration mode (Enabled or Disabled), then that OS Image must
be re-configured as described in "Re-configuring an OS Image."
50 Chapter 6

This page intentionally blank.


7 Installing and Configuring WSM
Edge Server
This section provides the detailed procedures you must complete to install the Wyse
Streaming Manager Edge Server. Although you can select customized installation
configurations during the installation, it is recommended that you use the default
configurations.

Note
Be sure you have completed all pre-installation requirements as described in
"Preparing for Installation" and installed WSM Core Server before you begin
installing WSM Edge Server.

Installing WSM Edge Server


To install WSM Edge Server:
1. After downloading the Wyse Streaming Manager Edge Server software, double-click
the WSMEdgeServer.exe to open the InstallShield Wizard.

Figure 37 InstallShield Wizard


52 Chapter 7

2. Click Next to open the Welcome window.

Figure 38 InstallShield Welcome

3. Click Next to open the License Agreement window.


Installing and Configuring WSM Edge Server 53

Figure 39 License Agreement

4. After reading the agreement, select the I accept the terms in the license agreement
option and click Next to open the Destination Folder window.
54 Chapter 7

Figure 40 Destination Folder

5. Click Next to open the Core Server Information window.


Installing and Configuring WSM Edge Server 55

Figure 41 Core Server Information

6. Enter the IP address of the Wyse Streaming Core Server and click Next to open the
Streaming Directory Information window.

Note
If the WSM Edge Server cannot connect to the Core Server Registry (for
example, the remote registry is disabled on the Core Server for security
reasons), then a warning message appears.

Figure 42 Warning message

Click OK to close the Warning message and open the Database Server window.
56 Chapter 7

Figure 43 Database Server

Use the following guidelines to complete the Database Server window (this information
is the same information you entered in the WSM Core Server Database Server window
when you installed the Wyse Streaming Manager Core Server as described in
“Installing WSM Core Server” ):
Enter the Database Server IP Address in the Database Server text box.
Enter the Database Name.
Enter the Username and Password for the server (be sure to re-enter the Password in
the Re-Type Password text box).
Click Next to open the Streaming Directory Information window.
Installing and Configuring WSM Edge Server 57

Figure 44 Streaming Directory Information

7. Enter a valid Streaming Directory path and click Next to open the Ready to Install the
Program window.
58 Chapter 7

Figure 45 Ready to Install the Program

8. Click Install to begin the installation.


Installing and Configuring WSM Edge Server 59

Figure 46 Installing WSM Edge Server

Caution
Do not interrupt the installation.

During the installation, the WSM Edge Server Config Wizard opens.
60 Chapter 7

Figure 47 WSM Edge Server Config Wizard

9. Click OK to close the WSM Edge Server Config Wizard and open the InstallShield
Wizard Completed window.
If you want to change the default configurations use the following guidelines:
Select the IP address to be used by the WSM OS Streaming Service from the list of IP
addresses available (the default IP address is first in the list; the Subnet Mask and
Gateway are automatically entered).
Select the Bootstrap file to download from the server (default is automatically entered,
however you can use Browse to make a different selection).
Installing and Configuring WSM Edge Server 61

Figure 48 InstallShield Wizard Completed

10.Click Finish to close the InstallShield Wizard.

Note
After installing the Edge Server, you must complete the following procedure
before you can use the Edge Server:
Click Start | Control Panel | Administrative Tools | Services to open the
Services console and start the WSM services as the Domain user that you
created in "Pre-Installation Checklist." In the Services console, be sure that
you start the services in the following order 1) WSM Monitor service, 2) WSM
OS Streaming Service, 3) WSM Multicast Boot Service.
62 Chapter 7

This page intentionally blank.


8 System Maintenance
This section contains information to help you successfully maintain the Wyse Streaming
Manager system.

Passwords
Wyse Streaming Manager uses three sets of username and password credentials. The
following list describes how to change the passwords:

Note
It is strongly recommend that administrators implement a password policy.

• Wyse Streaming Manager Database – If you need to change the database user
account (default is wsmdb) then you will need to make the change in at least three
locations. The account password on the database itself will need to be changed. The
ODBC setup will need to be changed. And finally, the Wyse Streaming Manager
servers store the password encrypted in the windows registry. You will need to run a
utility supplied in your <install dir>\app folder called admin_utils.
• Windows Service – If you change the windows system password on the administrator
user, which is used to start the Wyse Streaming Manager services servers, then you
will need to update the services. This is can be accomplished under the Management
Console for Windows Services by selecting the Log On tab and changing the account
password.
• Wyse Streaming Manager – To change the administrator account password for the
Wyse Streaming Manager provider environment, log in to the Wyse Streaming
Manager as an administrator, select Change Password, and use the Change
Password page.

Logs
Errors pertaining to the Wyse Streaming Manager and related components are logged to
the System Event Viewer. Descriptions of errors regarding licensing, server connections,
database problems, configuration errors, and so on, are available through the System
Event Viewer.
Wyse Streaming Manager stores log files in the database and on your file system. These
have a set size and will rollover when they become too large (making the system
self-maintaining). The default size of these logs is 10,000,000 bytes.
The Profile Log is a log of communication statistics on the server side giving information
on how long request queue is at a given time, the effective bandwidth amount of requests
64 Chapter 8

received so far, and the type of requests received so far. It is located at the
/server-install/log folder with the name in the format of:
prof-<erver-id>-<random>.txt. Format: Date [universal-time]
[start-time] [delta-time] [request-count] [S/M] [CLIENT/CACHE]
[IP address] [app-id] [fileID,pageID] (S=single, M=multiple)

Backup Recovery
It is highly recommended that all system data is backed up for recovery purposes. Wyse
Streaming Manager stores all system, topology, user, application, and usage data within
the database. Since all information is contained in the Wyse Streaming Manager
Database, backing up this database enables you to recover all system data. Use standard
backup procedures common to database servers. For fault-tolerant systems, it is also
recommended to replicate the database for fail-over.

System Monitoring
Wyse Streaming Manager comes with built-in monitoring tools that can be used to watch
and check the health of the system. When an administrator logs into the Administrator
Console, the System Overview page is shown. The System Overview page allows you to
quickly view important summary information for each functional area of the Wyse
Streaming Manager system. It also provides links to all of the functional areas so you can
easily perform many of the Administrator duties that are required to run and maintain your
Wyse Streaming Manager environment. For example, the Overview page allows you to
quickly see that a server requires your attention (since Wyse Streaming Manager has
noted this server problem in the Requires Attention area and provides you a link to the
Server functional area page that you need to address the message.
For fault-tolerant provider systems, it is recommended to have system hardware
monitoring in place. Third-party system monitoring software can be configured to watch
and report on system status including:
• Ping availability and response times
• % CPU Utilization
• Memory Available
• Bandwidth consumption
The following list provides a few examples of system monitoring software:
• Tivoli by IBM
• Big Brother by Quest software
• Nagios by Nagios
• Performance Monitor by Microsoft

Note
For additional information about Wyse Streaming Manager monitoring plug-ins
for many of these systems, contact Wyse Technology Support.
9 Troubleshooting
This section provides information and help on installation, setup, conflicts, and general
troubleshooting. For a complete list of error codes and descriptions, refer to "Error Codes."

Enabling Active Directory for the First Time


Problem: After enabling and configuring the Active Directory for the first time (as described
in "Starting the Wyse Streaming Manager for the First Time"), clicking Finish produces an
error stating that the Active Directory cannot be connected.
Solution: Use the following procedures to solve this problem:
• Be sure that the Core Server and the Active Directory Server are part of the Domain
before the administrator of the local system begins installing WSM Core Server as
described in "Pre-Installation Checklist."
• Ensure that the database user wsmdb is created in Active Directory with the same
password as that of the database.
• Ensure that the display name for the database user is the same as the username.
• Ensure that you can ping the Domain (for example, wsm.com).

Installing WSM Client on Windows XP


Problem: You are installing the WSM Client on Windows XP (without a SP) and you
encounter an error message that a .dll file is missing.

Figure 49 Missing file message

Solution: Obtain winhttp.dll and copy it into the Windows system32 folder. After you
have done this, begin installing the WSM Client as described in "Installing and Configuring
WSM Client."
66 Chapter 9

Network Devices are Unable to be Created in Active Directory


Problem: You are trying to add a Network Device from the WSM Administrator Console
and you encounter an error message.
Solution: Use the following procedures, in the order presented, to solve this problem:
1. Ensure that the Network Device is created in Active Directory.
2. Change the OS Authentication service to run with a User with Account Operator
credentials

HTTP Error:404 /admin/ not found RequestURL=/admin/ powered by jetty


Problem: You are logging in to the Administrator Console and you encounter the following
error message:
“HTTP Error:404 /admin/ not found RequestURL=/admin/ powered by jetty.”
Solution: Use the following procedures, in the order presented, to solve this problem:
1. Ensure your WSM Administration Web Service is running (see "Verifying the Status of
the Wyse Streaming Manager Service Files"). If you still encounter the error, go to Step
2.
2. Ensure that your database is correctly configured and running. If you still encounter the
error, go to Step 3.
3. Open the registry at
HKLM\System\CurrentControlSet\Services\WSMAdminService, add a
multi-string key called DependOnService, set the value to MSSQLSERVER, and then
reboot the Core Server. If you still encounter the error, go to Step 4.
4. Ensure that you downloaded and installed the Microsoft SQL Server 2000 Driver for
JDBC Service Pack 3 onto the Core Server as described in "Pre-Installation Checklist."
If you did not complete this installation, you must now use the custom installation
procedures as described on the Microsoft Web site and install the driver to the
following location:
C:\Program Files\Wyse\WSM\admin\Jetty\webapps\admin\WEB-INF\lib
After you install the driver, be sure to restart the WSM Administration Web Service as
described in "Verifying the Status of the Wyse Streaming Manager Service Files."
Troubleshooting 67

Verifying the Status of the Wyse Streaming Manager Service Files


A successful installation places the following WSM files into the Services folder (you can
view these files by clicking Start | Control Panel | Administrative Tools | Services):
• WSM Administration Web Service - Provides an administration interface for the Wyse
Streaming Manager.
• WSM Monitor - Monitors and controls the WSM Services on the machine to which it is
loaded.
• WSM OS Authentication Service - Allows you to manually start and stop the OS
Authentication service for the Wyse Streaming Manager.
• WSM OS Streaming Service - Allows you to manually start and stop the OS Streaming
service for the Wyse Streaming Manager.
• Content Distribution Service - Allows you to synchronize the repositories of OS and
Application images between the Core and remote servers.

Figure 50 Services folder and WSM files

Note
To start or stop a service, right-click on the service file (for example, WSM
Administration Web Service) and select Start or Restart (to start the service)
or select Stop (to stop the service).
68 Chapter 9

Re-configuring an OS Image
If you want to copy or move an OS Image from one Core Server (for example, a lab
environment) to another Core Server (for example, a production server), then that OS
Image must first be re-configured.
Similarly, if you want to change the current Active Directory integration mode (Enabled or
Disabled), then that OS Image must be re-configured.

Note
These re-configuration procedures must be done on a client machine that
has been booted from this OS Image in No Cache (Private Mode). For
procedures on adding an OS Image and assigning it to a server, refer to the
Wyse Streaming Manager Administrators Guide.

To re-configure an OS Image:
1. (Only required if you want to change the current Active Directory integration from
Disabled to Enabled) Join the OS Image to the domain you specified (when you added
the OS Image using the Administrator Console as described in "Configuring the OS
Image") by using the Microsoft procedures for joining a domain, reboot the system, and
continue with Step 2.
2. Login as a user with administrator privileges on the client machine and locate the
WSMClientPostConfig.exe (default location is C:\Program Files\Wyse\WSM\os).

Figure 51 WSMClientPostConfig.exe
Troubleshooting 69

3. Double-click the WSMClientPostConfig.exe to open the WSM Client Post


Configuration window.

Figure 52 WSM Client Post Configuration

4. Complete WSM Client Post Configuration dialog box using the following guidelines:
• Depending on whether or not you want to integrate WSM Streaming Manager with
Active Directory, select or clear the Enable Active Directory Integration check
box.
• If you want to change the WSM Core Server settings, select the WSM Core Server
settings check box and enter the new IP Address of the Core Server, and Port
settings of the WSM OS Streaming Server.
5. Click OK.
6. Shutdown the client machine.
7. Log in to the Administrator Console and edit the OS Image so that either the
Persistent Cache (Shared Mode) or Volatile Cache (Shared Mode) option is
selected for the Mode. For procedures on editing an OS Image, refer to the Wyse
Streaming Manager Administrators Guide.
8. If the intention of this re-configuration was to move the OS Image to a different Core
Server, the OS Image can be now copied to that new Core Server, and added to the
new Core Server through the Administration Console. For procedures on adding an
OS Image to a server, refer to the Wyse Streaming Manager Administrators Guide.
After completing the procedures in this section the OS Image is ready to be used by
multiple client machines.
70 Chapter 9

Uninstalling Wyse Streaming Manager


To uninstall the Wyse Streaming Manager Core Server you must stop all services listed in
"Verifying the Status of the Wyse Streaming Manager Service Files" (right-click each WSM
file in the Services folder and select Stop), and then use the Windows Add or Remove
Programs dialog box to remove WSM Server from the list of Currently installed programs
(follow the Windows procedures for removing a program).

Note
You can be sure that the WSM services are stopped by viewing that the
status of each of the files is empty (when running the status of the files is
Started).

Figure 53 Add or Remove Programs

Note
If you want to re-install the Wyse Streaming Manager, verify that the
Wyse/WSM directory and all contents are deleted from your installation folder
before you begin to re-install Wyse Streaming Manager. If you want to reuse
your existing OS Images and Application Images, you can copy them before
you delete the folders.
A Error Codes
This section includes the most common errors that you may encounter, either in a
displayed message box or in a log file. For information and help on installation, setup,
conflicts, and general troubleshooting, refer to "System Maintenance."

Table 4 Error codes, symbolic representation, and error description

Code Symbolic Representation Error Description

2 OTERROR_AI_BAD_XML_FORMAT Missing configuration data in


the basicConfig.jsp file
for the AutoInstall routine.

4 OTERROR_AI_SYSCHECK_REJECTED Failed AutoInstall system


check because of existing
MacID.

10 OTERROR_AI_ENVTEST_BAD_OS Unsupported Operating


System version.

15 OTERROR_AI_ENVTEST_NO_APPSERV Could not ping the


Application server, probably
because of an Application
server outage or a firewall
issue.

16 OTERROR_AI_ENVTEST_NO_SLIMSERV Could not ping the


Application Authentication
Server, probably because of
a Application Authentication
Server outage or a firewall
issue.

26 OTERROR_AI_TERMINAL_SESSION_DET Client cannot be installed


using Terminal Services.

3002 to OTERROR_EMS* Network communication


3008 time-out.

3024 to OTERROR_EMS_PROXY* Proxy issues with


3030 authentication or proxy
gateway detection.
72 Appendix A

Table 4 Error codes, symbolic representation, and error description, Continued

Code Symbolic Representation Error Description

5006 OTERROR_SLIM_AT_ALREADY_HELD User attempted to run more


sessions of an application
than allowed (for information
on license management,
refer to the Wyse Streaming
Manager Administrators
Guide).

5010 OTERROR_SLIM_USER_DISABLED Disabled or deleted user


attempted to run an
application session.

7003 OTERROR_APS_BAD_PAGE_NUMBER The page requested is not


valid. Either the appset has
been unloaded or badly
published.

8001 OTERROR_DB_CONNECT_FAILURE Servers could not connect to


the database. Be sure that
the ODBC and JDBC
configurations are correct
and DB is up.

10021 OTERROR_MONITOR_TERMINATED Monitor terminated.

100020 OTERROR_OUT_OF_MEMORY AutoInstall component


cannot download the
configuration XML, usually
because of an old AutoInstall
version.
Figures
1 InstallShield Wizard 15
2 InstallShield Welcome 16
3 License Agreement 17
4 Destination Folder 18
5 Streaming Directory Information 19
6 Database Server 20
7 SQL Server 21
8 Ready to Install the Program 22
9 Installing WSM Core Server 23
10 WSM Core Server Config Wizard 24
11 InstallShield Wizard Completed 25
12 Login 27
13 Import Server License 28
14 Valid dates of successfully added license 29
15 Configure Active Directory 29
16 Configure Active Directory page - expanded 30
17 System Overview Congratulations 31
18 Core Server Details page 32
19 InstallShield Wizard 34
20 License Agreement 35
21 Customer Information 36
22 Destination Folder 37
23 Ready to Install the Program 38
24 Installing WSM Client 38
25 Windows Logo testing message 39
26 Found New Hardware Wizard 40
27 Installing hardware 41
28 Completing the Found New Hardware Wizard 42
29 WSM Client Config Wizard 43
30 InstallShield Wizard Completed 44
31 OSMVDiskImage.exe 45
32 WSM VDisk Image Creation Utility 46
33 Building Virtual Disk 47
34 Done message 47
35 WSM Client Login in progress message 48
36 System Settings Change message 49
37 InstallShield Wizard 51
38 InstallShield Welcome 52
39 License Agreement 53
40 Destination Folder 54
41 Core Server Information 55
42 Warning message 55
43 Database Server 56
44 Streaming Directory Information 57
45 Ready to Install the Program 58
46 Installing WSM Edge Server 59
47 WSM Edge Server Config Wizard 60
48 InstallShield Wizard Completed 61
49 Missing file message 65
50 Services folder and WSM files 67
51 WSMClientPostConfig.exe 68
52 WSM Client Post Configuration 69
74

53 Add or Remove Programs 70


Tables
1 Server Hardware Requirements 7
2 Server Software Requirements 7
3 Example of DHCP server options 12
4 Error codes, symbolic representation, and error description 71
Installation Guide

Wyse Streaming Manager


Issue: 022806

Written and published by:


Wyse Technology Inc., February 2006

Created using FrameMaker® and Acrobat®