Professional Documents
Culture Documents
Citrix Desktop Server Administrator's Guide PDF
Citrix Desktop Server Administrator's Guide PDF
Copyright and Trademark Notice Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. Other than printing one copy for personal use, no part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Citrix Systems, Inc. Copyright 2007 Citrix Systems, Inc. All rights reserved. Citrix, ICA (Independent Computing Architecture), and Program Neighborhood are registered trademarks, and Citrix Desktop Server, Citrix Presentation Server, Citrix Access Gateway, SpeedScreen and GoToAssist are trademarks of Citrix Systems, Inc. in the United States and other countries. This product includes software developed by The Apache Software Foundation (http://www.apache.org/). Adobe, Reader, and PostScript are trademarks or registered trademarks of Adobe Systems Incorporated in the U.S. and/or other countries. Internet Explorer, Microsoft, MS-DOS, Windows, Windows Server, Windows NT, Windows XP, Win32, Access, Visual J#, and Active Directory are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Java is a trademark of Sun Microsystems, Inc. in the United States and other countries. Netscape Navigator and Communicator are registered trademarks of AOL LLC. VMware is a trademark of VMware Inc. XenSource is a trademark of XenSource Inc. All other trademarks and registered trademarks are the property of their owners. Last Updated: April 17, 2007 (SC)
C ONTENTS
Contents
Chapter 1
Introduction
How to Use this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Finding More Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 Using PDF Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 Getting Service and Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 Subscription Advantage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 Citrix Developer Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 Education and Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 Introducing Citrix Desktop Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Key Benefits and Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Desktop Delivery Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Usage Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 How Citrix Desktop Server Works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Connecting to Server Desktops. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Connecting to Workstation Desktops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Chapter 2
Chapter 3
Chapter 4
Chapter 5
Publishing Desktops
Publishing Server Desktops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45 Publishing Workstation Desktops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46 Step 1: Creating and Populating Desktop Groups . . . . . . . . . . . . . . . . . . . . . . .47 Step 2: Publishing Workstation Desktops. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Chapter 6
Chapter 7
Troubleshooting
Workstation Desktop Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57 Printing Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59 Other Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
Appendix A
Appendix B
C HAPTER 1
Introduction
This chapter introduces you to Citrix Desktop Server. Topics include: How to use this guide An introduction to Citrix Desktop Server, describing its key features and benefits How Citrix Desktop Server works
Chapter 1
Introduction
Another source of support, Citrix Preferred Support Services, provides a range of options that allows you to customize the level and type of support for your organizations Citrix products.
Subscription Advantage
Subscription Advantage gives you an easy way to stay current with the latest server-based software functionality and information. Not only do you get automatic delivery of feature releases, software upgrades, enhancements, and maintenance releases that become available during the term of your subscription, you also get priority access to important Citrix technology information. You can find more information on the Citrix Web site at http://www.citrix.com/services/ (select Subscription Advantage). You can also contact your Citrix sales representative or a member of the Citrix Solutions Advisors Program for more information.
10
Virtualized desktops provide the benefits of thin clients, including IT consolidation cost savings, better security, flexibility, manageability, and application access. Meanwhile, users enjoy all the benefits and personal control of stand-alone Windows desktops while avoiding many of the disadvantages of a fat client, including susceptibility to theft and viruses, extended downtime during a hard drive failure, or having to rebuild their preferences and settings after each client refresh. Citrix Desktop Server is ideal for organizations interested in reducing the costs and provisioning challenges associated with desktop refreshes and new desktops. With Citrix Desktop Server, your organization can respond to business needs by: Accelerating the provisioning of new staff Prolonging the life of existing hardware Reducing security risks by controlling hardware centrally
Chapter 1
Introduction
11
Centralized security. Citrix Desktop Server enables you to: Keep company data within the secure data center, and leverage economies of scale for data storage Centralize and simplify tasks such as anti-virus endpoint security Facilitate user data backup and restore during desktop refreshes or for disaster recovery Safely virtualize the desktop over a secure data path, across any network, to any location More easily achieve corporate compliance to configuration, performance, and security standards
Flexibility. You can deliver desktops on demand over any network, giving users the exact resources they need, when they need them: Pool together all your computing power and deliver it to users in the right amounts to get their jobs done with the best performance Provide the best desktop capability for every office worker role, from those with simple, repetitive tasks to those who require high computing power and complete control over their desktop, even allowing them to restart or install their own applications Securely and quickly extend the workplace to anywhere
12
Use outsourced, partner, and offshore workforces without fear for data security
Single sign-on. Users can log on once to a desktop and have their user credentials reused throughout the duration of their sessions. Easy management interface. You use the well established Citrix management consoles to manage and control all the components of your deployment.
Chapter 1
Introduction
13
Usage Scenarios
The types of desktop described above enable you to support a variety of scenarios in the enterprise workplace while purchasing only one product. A single solution that supports various deployments independent of the underlying architecture enables IT departments to quickly respond to changing business needs: you can always deliver the right desktop to the right user at the right time. Simple. Workers who perform identical, routine tasks using a limited range of applications need access to a reliable, efficient desktop, but do not need to personalize it. Server desktops are ideally suited to this scenario. Staff in call centers, branch banks, or retail centers are typical examples of the types of worker who will find that the simple desktop model meets their needs. Personal. Office workers who perform non-repetitive tasks using a wide range of applications need a standard desktop that they can then customize. Assigned workstation desktops running on virtual machines in the data center provide these users, who typically work in the accounting, finance, and marketing areas, with the flexibility they need. Powerful. High-performance desktops are essential for anyone whose work involves carrying out complex, knowledge-based tasks that require rapid switching between applications, and resource-intensive applications. Such users also need to be able to add and remove their own applications and retain local configuration and work data. The high levels of availability, performance, and flexibility required by workers such as design engineers, visualization analysts, and software developers are provided by assigned workstation desktops running on blade servers in the data center.
14
2. 3. 4. 5.
The subsequent interactions depend on whether the user requested a server desktop or a workstation desktop.
Connecting to a server desktop If the user requested a server desktop, the ICA session runs on a server in the farm. This server runs the standard desktop environment for Windows Server 2003: typically, this is Windows Explorer. The appearance of the desktop is controlled by the users profile, which may be a roaming profile. You can use policy settings to make the desktop appear more like a Windows XP desktop, if appropriate.
Chapter 1
Introduction
15
Connecting to a workstation desktop Connections to workstation desktops are managed by the Desktop Broker, which provides an RDP client wrapper that proxies access to workstation desktops through ICA. After an ICA session is established: 1. The Desktop Broker session manager is started within the users ICA session. The session manager is the component used to open a workstation desktop connection. The session manager interacts with the Desktop Broker database service to select the appropriate workstation desktop and exchange information about the current state of the desktop connection. The Desktop Broker database service is the component that is responsible for managing database transactions and providing connection details for workstation desktops to the session manager. It uses the information in the database to provide the key functionality of machine brokering and session tracking. The database tables needed by the database service are created and initialized by the database schema. If you selected the pass through credentials option when you published the desktop, the users credentials used to log on to the session are securely conveyed to the session manager, which can then in turn provide them to the RDP client. 2. The session manager contacts the database service and requests connection details to the appropriate desktop.
16
3. 4. 5. 6.
The database service returns connection details for the specified desktop to the session manager. The session manager launches the RDP client and passes it the connection details for the desktop. The RDP client connects to the desktop and starts an RDP session. The session manager informs the database service that the user has successfully logged on to the desktop and that a session is in progress.
When a user logs off from the desktop, the following interactions take place before the desktop is released by the system: 1. Logging off from the desktop results in an RDP session logoff. 2. 3. 4. The session manager informs the database service about the logoff event and the desktop is released. The database service updates the status of the desktop as idle/available. The session manager terminates the ICA session.
C HAPTER 2
Before you install Citrix Desktop Server and publish desktops for your users you need to plan your deployment to ensure that it meets your organizations needs effectively. This chapter provides information about the following topics: Supported deployments Hosted desktops supported System requirements Pre-installation tasks
Supported Deployments
You can deploy Citrix Desktop Server in any of the following configurations: Single server. This is a simple, default installation that provides you with a working Citrix Desktop Server deployment on one computer. This option enables you to get Citrix Desktop Server up and running quickly and easily for evaluation purposes. Master server and support servers. This typical server farm scenario enables you to use additional management features, such as load balancing. The farm must consist only of computers running Citrix Desktop Server: you cannot have computers running Citrix Presentation Server and computers running Citrix Desktop Server in the same farm. Separate components. This more advanced option allows you increased flexibility in where you install the various components of Citrix Desktop Server.
18
Single server configuration of Citrix Desktop Server All components are installed on one server. Within this simple installation scenario you do, however, have the option of using an existing license server. You can also use an existing SQL Server computer to host the farm data store and Desktop Broker database.
Chapter 2
19
Multiple server configuration of Citrix Desktop Server The master server includes all the components of Citrix Desktop Server. The support servers exclude the consoles, the Web Interface, licensing components, the farm data store, and the Desktop Broker database and schema.
20
Chapter 2
21
This option provides you with the flexibility to set up several different scenarios, depending on what your priorities and objectives are: If you want to manage your servers remotely, you can install the management consoles on a separate workstation Using the Web Interface on a separate computer has the following advantages: Integration with existing Web Interface deployments Scalability and robustness
Installing the clients separately allows end users to remotely access desktops
In addition, Virtual Iron and XenSource were not tested but are likely to work satisfactorily.
Note The only operating system that was tested for this release is Windows XP x86. Connecting through other operating systems that support RDP connections is likely to be successful, but no other operating system was tested.
22
System Requirements
This section describes the requirements for installing Citrix Desktop Server, based on the configuration choices available to you through the installer.
Disk space requirements: 400 MB for Citrix Desktop Server 50 MB for the Presentation Server Console 25 MB for the Access Management Console 30 MB for the licensing components
Terminal Services running in application mode If you do not have this on your server, you are prompted for the Windows Server 2003 CD during Citrix Desktop Server installation, and it is installed for you.
Microsoft .NET Framework, Version 2.0 If you do not have this on your server, it is installed automatically for you along with Citrix Desktop Server. The Citrix Desktop Server CD also contains this installer in the Support\DotNet20 folder.
Java Runtime Environment (JRE) Version 1.5.0_09 If you do not have this on your server, it is installed automatically for you along with Citrix Desktop Server. The Citrix Desktop Server CD also contains this installer in the Support\JRE1.5 folder.
Chapter 2
23
Microsoft Internet Information Services (IIS) Version 5.0 or later and ASP.NET If you do not have this on your server, you are prompted for the Windows Server 2003 CD during Citrix Desktop Server installation, and it is installed for you.
Microsoft Visual J# 2.0 Redistributable Package If you do not have this on your server, it is installed automatically for you along with Citrix Desktop Server. The Citrix Desktop Server CD also contains this installer in the Support\Jsharp20 folder.
Database Requirements
Farm Data Store Requirements
Citrix Desktop Server supports the following types of database for a farms data store: Microsoft Access: Microsoft Access Jet Database Engine for Windows Server 2003 with Service Pack 1 Microsoft Access Jet Database Engine for Windows Server 2003 x64
An Access database is automatically created on the master server during the product installation process unless you choose to use an existing SQL Server computer. The database is created here: c:\Program Files\Citrix\Independent Management Architecture and is called mf20.mdb. Microsoft SQL Server: Microsoft SQL Server 2005 Express Edition (32-bit) with Service Pack 1 for Windows Server 2003 with Service Pack 1 Microsoft SQL Server 2005 Express Edition (32-bit) with Service Pack 1 for Windows Server 2003 x64 Microsoft SQL Server 2000 with Service Pack 4 for Windows Server 2003 with Service Pack 1 Microsoft SQL Server 2005 for Windows Server 2003 with Service Pack 1 Microsoft SQL Server 2005 for Windows Server 2003 x64
24
For further information about sizing and setting up farm data stores, see Appendix E, Data Store Database Requirements of the Citrix Presentation Server Administrators Guide, and Planning and Configuring a Data Store in Chapter 2 of the Citrix Presentation Server Administrators Guide.
An SQL 2005 Express Edition database called DESKTOPSERVER is created automatically on the master server during the product installation process unless you choose to use an existing SQL Server computer.
Chapter 2
25
26
To run the Access Management Console and Presentation Server Console: One of the following operating systems: Windows Server 2003 (Standard, Enterprise, or Datacenter Edition) with Service Pack 1 or 2 installed Windows Server 2003 R2 (Standard, Enterprise, or Datacenter Edition) Windows XP Professional with Service Pack 2 Windows 2000 Server (Advanced Server, Enterprise, Datacenter Server, or Professional) with Service Pack 4 installed
Microsoft .NET Framework 2.0 If you do not have this on your workstation, it is installed automatically for you along with the consoles. The Citrix Desktop Server CD also contains this installer in the Support\DotNet20 folder.
Java Runtime Environment (JRE) Version 1.5.0_09 If you do not have this on your server, it is installed automatically for you along with the consoles. The Citrix Desktop Server CD also contains this installer in the Support\JRE1.5 folder.
To run reports from the summary database on farms using Microsoft SQL Server as the data store or summary database: Microsoft Data Access Component (MDAC) Version 2.6. Microsoft Windows Installer (MSI) 3.1 If you do not have this on your workstation, it is installed automatically for you along with the consoles.
You cannot install the License Management Console separately from the license server. It is not, therefore, included in the consoles installation.
Chapter 2
27
Clients Requirements
Machines on which you are installing the clients have the following requirements: Windows NT 4.0 or later, Windows 2000, Windows XP, Windows XP Embedded, Windows 2003, or Windows Fundamentals for Legacy PCs. Internet Explorer Version 5.0 or later; Netscape Navigator or Communicator Version 4.78, 6.2, or later; Mozilla Firefox 1.0 or later. For network connections to the server farm, a network interface card (NIC) and the appropriate network transport software are required. Supported connection methods and network transports are TCP/IP+HTTP and SSL/TLS+HTTPS.
Pre-Installation Tasks
Before starting to install Citrix Desktop Server, carry out the following tasks: In all configurations, ensure that all computers are in an Active Directory domain.
Note If the Active Directory domain has been set up to be Permissions compatible with pre-Windows 2000 server operating systems (configured during Active Directory installation), you must carry out the steps described in Using Citrix Desktop Server in an Active Directory Domain that has Backwards Compatibility for pre-Windows 2000 Servers on page 60.
Remap server drive letters, if you decide this would be useful in your environment. Server drive remapping involves changing the server drives to use letters that are not likely to be used by client devices. This ensures that client drives retain their original drive letters. By changing the server to use higher drive letters, such as M, N, or O, the original lower drive letters become available for assignment to the drives on client devices. This can make the use of drives on client devices less confusing for users, because they see their drives identified by typical drive letters. For more information, see Changing Server Drive Letters in Chapter 2 of the Citrix Presentation Server Administrators Guide. If you do decide to remap server drive letters you must do this before you install any system requirements, including the Microsoft .NET Framework 2.0. Remapping server drive letters after you install Citrix Desktop Server
28
can cause unstable performance by the server, operating system components, and installed applications. Create the data store, if you are creating a new server farm and plan to use Microsoft SQL Server or SQL Server 2005 Express Edition (32-bit) for the farm data store. For more information, see the Planning and Configuring a Data Store section of Chapter 2 in the Citrix Presentation Server Administrators Guide. If you plan to install the Web Interface on a separate server from your master server, this server must have IIS, ASP.NET, .NET Framework 2.0, and the Access Management Console installed on it before you install the Web Interface. If you plan to have your farm data store and Desktop Broker database on a separate computer running SQL Server, enable remote access on that computer. Detailed instructions about enabling remote connections and configuring firewalls, if necessary, are provided in the Microsoft Knowledgebase article at http://support.microsoft.com/kb/914277/en-us. If you use HP ProtectTools in your environment, install them before installing Citrix Desktop Server.
C HAPTER 3
This chapter provides information about the following topics: Installing Citrix Desktop Server on a single server and creating a server farm Using an existing SQL Server computer for the farm data store and Desktop Broker database Adding support servers to your farm Installing the Web Interface remotely Installing the management consoles remotely Installing the clients remotely Uninstalling Citrix Desktop Server
1.
Insert the Citrix Desktop Server CD in the appropriate drive. If the Welcome page does not appear automatically, use Windows Explorer to open autorun.exe on the CD.
2.
30
3.
Select I accept the license agreement, then click Next. You cannot click Back on this page. To change the installation option you chose, you must click Cancel, then restart the installation.
4. 5.
On the Select Installation Type page, select Master Server. Type a name for the farm. This must: Be a maximum of 32 characters Exclude the characters \ / ; : . * ? = < > | [ ] ( ) # Be unique: you cannot use the name of an existing Citrix Desktop Server or Presentation Server farm
Click Next. 6. On the Optional Server Configuration page, you can configure: Shadowing. Shadowing is enabled by default, but if you want to disable Shadowing, select Disable Shadowing. Using an existing SQL Server computer. By default, an Access database for the farm data store, and an SQL Express database for the Desktop Broker database, will be created automatically on your master server. If you want to use an existing SQL Server computer instead, select Use an existing SQL Server. Licensing. By default, the Citrix license server will be installed on your master server, but if you are already managing Citrix licensing on a different computer, select Use an existing license server.
If you selected to use an existing SQL Server computer, you are then prompted for the details. For further information about this, see Using an Existing SQL Server Computer on page 31. If you have selected to use an existing license server, you are then prompted for the license servers name or IP address and port number. If you have selected to use both an existing SQL Server computer and an existing license server, you are first prompted for the SQL Server details, then for the license server details. Click Next.
Chapter 3
31
7.
On the Start Installation page, click Next. A progress indicator page then appears, which shows you the installation progress for each component.
Note Near the end of the installation you are prompted to restart your server. If you are installing from a network share, you need to connect to your network share after restarting for the installation to continue.
When installation is complete, click Next. 8. On the Setup complete page, if you do not want to start the Access Management Console, clear the check box. Click Finish. If you chose to start the Access Management Console, the console then appears and the discovery process starts. For further details about this, see Starting the Access Management Console on page 40.
1. 2. 3.
When the Optional Server Configuration page of the installation wizard appears, select Use an existing SQL Server. On the Database Configuration page, click Configure. The dialog boxes that follow are the standard Microsoft user interface for configuring ODBC settings. Refer to Microsoft documentation for details about these. When you complete them, you are returned to the Database Configuration page, which displays the name of the database you have selected for the farm data store. Click Next.
32
4.
If you selected Windows NT authentication when you were configuring ODBC settings, the Database Credentials page appears. Enter the details of the user account that will be used to manage the databases. Click Next. If you did not select to use Windows NT authentication, continue to Step 5 below.
5.
If, on the Database Configuration page, you also chose to use an existing license server, you are now prompted for the license server details. Otherwise, the Start Installation page appears, and the installation continues as described in Step 7 on page 31.
Note If you reinstall Citrix Desktop Server, and you are using a separate SQL Server computer for the databases, you must delete all Citrix Desktop Server users from the database server before starting the reinstallation. If you do not do this, when you start the Desktop Broker Console, an error message appears telling you that the database cannot be contacted.
1.
Insert the Citrix Desktop Server CD in the appropriate drive. If the Welcome page does not appear automatically, use Windows Explorer to open autorun.exe on the CD.
2. 3.
Click Install Server. The End User License Agreement appears. Select I accept the license agreement, then click Next. You cannot click Back on this page. To change the installation option you chose, you must click Cancel, then restart the installation.
4. 5.
On the Select Installation Type page, select Support Server. Type the name of the master server for the farm you want to join, then click Next.
Chapter 3
33
6.
On the Optional Server Configuration page, you can configure: Shadowing. Shadowing is enabled by default, but if you want to disable it, select Disable Shadowing. Using an existing SQL Server computer. You must configure support servers so that they use the same databases as the farm master server. If the farm to which you are adding this server has its data store and Desktop Broker database on the master server, leave this check box cleared. If the farm uses a separate SQL Server computer as a database server, select this check box. You are then prompted for the details. For further information about this, see Using an Existing SQL Server Computer on page 31.
Note When you are installing a support server, you cannot choose to use a different license server from the one specified for your master server. To use a different license server, you must modify the servers properties in the Access Management Console after installation is complete.
Click Next. 7. On the Start Installation page, click Next. A progress indicator page appears, which shows you the installation progress for each component.
Note Near the end of the installation you will be prompted to restart your server. If you are installing from a network share, you need to connect to your network share after restarting for the installation to continue.
When installation is complete, click Next. 8. On the Setup complete page, click Finish.
34
1.
Insert the Citrix Desktop Server CD in the appropriate drive. If the Welcome page does not appear automatically, use Windows Explorer to open autorun.exe on the CD.
2. 3. 4. 5.
Click Install Components (optional). On the next page, click Install Citrix Web Interface. Select the appropriate language, then click Next. The End User License Agreement appears. Select I accept the license agreement, then click Next. You cannot click Back on this page. To change the installation option you chose, you must click Cancel, then restart the installation. The Citrix Web Interface Installation wizard starts.
6. 7. 8.
On the Welcome page, click Next. Accept or update the folder location, then click Next. On the Clients page, you can choose whether or not to install the clients: this is optional. To install the clients, select Install the Clients from the Components CD-ROM, then click Next.
Note Citrix Desktop Server does not have a separate Components CD. The clients are installed from the product CD that is already in the drive.
9. 10. 11. On the Clients page, click Browse and select the Clients folder. Click OK, then Next. On the Ready to install the application page, click Next, then when the installation is complete, click Finish.
Chapter 3
35
1.
Insert the Citrix Desktop Server CD in the appropriate drive. If the Welcome page does not appear automatically, use Windows Explorer to open autorun.exe on the CD.
2. 3. 4.
Click Install Components (optional). On the next page, click Install Management Consoles. The End User License Agreement appears. Select I accept the license agreement, then click Next. You cannot click Back on this page. To change the installation option you chose, you must click Cancel, then restart the installation.
5.
On the Console Configuration page, type the name of a server running the Desktop Broker database service in the farm you want to manage. All the servers in the farm run the database service, so you can use the name of the master server or any of the support servers. Click Next. On the Start Installation page, click Next. A progress indicator page then appears, which shows you the installation progress for each component. When installation is complete, click Next. On the Setup complete page, if you do not want to start the Access Management Console, clear the check box. Click Finish. If you chose to start the Access Management Console, the console then appears and the discovery process starts. For further details about this, see Starting the Access Management Console on page 40.
6.
7. 8.
36
1.
Insert the Citrix Desktop Server CD in the appropriate drive. If the Welcome page does not appear automatically, use Windows Explorer to open autorun.exe on the CD.
2.
On the Citrix Components page, click Install Components (optional), then Install Clients. The Citrix Presentation Server Client Setup wizard guides you through the process of installing the clients. Note that on the Server Address page, you type the URL of the farm master server.
3.
Chapter 3
37
To have a completely clean image after uninstalling, you should also manually remove the following files and registry keys, although this is not essential for a successful reinstallation. C:\Documents and Settings\username\management console\ima.ini. where username is the user who installed Citrix Desktop Server. If the user installed Citrix Desktop Server as an administrator, the path would be: C:\Documents and Settings\administrator\management console\ima.ini The following files from C:\Program Files\Citrix\System32\: HotfixTools HotfixPersistent Tools
If Citrix Desktop Server was installed on the 64-bit version of Windows 2003 Server, these files are in the Program Files (x86) directory. The following files from C:\WINDOWS\inf: \007\CtxSecGwyTAPerf\... \009\CtxSecGwyTAPerf\... \009\ Desktop Broker Database Service\... \00A\CtxSecGwyTAPerf\... \00C\CtxSecGwyTAPerf\... \011\CtxSecGwyTAPerf\... \inc\Desktop Broker Database Service\... \inc\CtxSecGwyTAPerf\...
where \ means any files in the current folder and subdirectories. The following registry keys: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\... along with its subdirectories HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ Session Manager\Environment\ ..
38
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\ CurrentVersion\SharedDlls\ C:\Program Files\Citrix\System32\IMACOM.dll DWORD 0x00000011 C:\Program Files\Citrix\System32\radecom.dll DWORD 0x00000009
HKEY_CURRENT_USER\Software\Citrix\... and all sub directories. HKEY_CLASSES_ROOT\TypeLib\{076FA4F7-95CE-427D-83A4D5C292225384}\1.0\0\win32\ (default) String C:\Program Files\Citrix\System32\RMCOM.dll HKEY_CLASSES_ROOT\TypeLib\{076FA4F7-95CE-427D-83A4D5C292225384}\1.0\HELPDIR\ (default) String C:\Program Files\Citrix\System32\ HKEY_CLASSES_ROOT\TypeLib\{29D9C087-5D2B-44B38AD9-0545BE9EC17E}\1.0\ (default) String Citrix CPSCOM 1.0 Type Library 0\ HKEY_CLASSES_ROOT\TypeLib\{29D9C087-5D2B-44B38AD9-0545BE9EC17E}\1.0\0\ win32\ HKEY_CLASSES_ROOT\TypeLib\{29D9C087-5D2B-44B38AD9-0545BE9EC17E}\1.0\0\win32\ (default) String C:\Program Files\Citrix\System32\CPSCOM.dll HKEY_CLASSES_ROOT\TypeLib\{35B38513-2C69-4931-BEC1C3CD73648BA0}\1.0\0\win32\ (default) String C:\Program Files\Citrix\System32\SMACOM.dll HKEY_CLASSES_ROOT\TypeLib\{AF586AAE-B62A-420EB796-294E7EE64C70}\1.0\0\win32\ (default) String C:\Program Files\Common Files\Citrix\Presentation Server - Administration Snap-in\msrdp.ocx HKEY_CLASSES_ROOT\TypeLib\{AF586AAE-B62A-420EB796-294E7EE64C70}\1.0\HELPDIR\ (default) String C:\Program Files\Common Files\Citrix\Presentation Server - Administration Snap-in\ HKEY_CLASSES_ROOT\TypeLib\{BBBF5405-E091-11D8AD76-005056C00008}\1.0\0\win32\ (default) String C:\Program Files\Common Files\Citrix\System32\SmaLib.tlb
C HAPTER 4
After you install and license Citrix Desktop Server, you need to configure your environment to ensure that desktops are managed and used in the most effective way. This chapter describes the procedures and concepts you need to be aware of to configure your environment successfully. At a high level, you must perform the following tasks: 1. Start the Access Management Console and discover the servers in your farm. See Starting the Access Management Console on page 40 for details. Create any administrative or user accounts you need for your farm. See Users and Accounts in the Citrix Presentation Server Administrators Guide for details. Create Web Interface sites. To enable users to access desktops through a Web browser, you need to create an Access Platform site. To enable users to use Program Neighborhood Agent to access desktops, you need to create a Program Neighborhood Services site. See the Citrix Web Interface Administrators Guide for details. When you set up your Web Interface sites, do not enable access through RDP if users are going to be connecting to workstation desktops. For workstation desktops, the initial connection to the server must be made through ICA. If you want users to be able to use RDP to connect to server desktops, you must configure separate Web Interface sites for this purpose. 4. Perform any additional customizations that you require, such as setting policies, configuring printing, and load balancing. See information throughout this chapter, the Citrix Presentation Server Administrators Guide, and the Load Manager Administrators Guide for details. Publish desktops. See Publishing Desktops on page 45 for details.
2.
3.
5.
40
6.
Create client packages to deploy to users. For details, see Deploying Client Software to Users in the Citrix Presentation Server Administrators Guide.
1. 2. 3.
On the Welcome page of the wizard, click Next. On the Select Products or Components page, click Next. On the Configuration Servers page, if you want to be able to configure Web Interface settings, select Contact the following servers running the configuration service, then add the name of the server running the Citrix XML Service. Typically, this is the name of your farm master server. On the Select Servers page, add the name of one of the servers in the farm. On the Preview Discovery page, ensure that the correct information appears, then click Next. When discovery is complete, click Finish. The Access Management Console can now display all the contents of your farm and is ready for you to begin any Citrix management or configuration tasks you need to carry out.
4. 5. 6.
Using Policies
You can set up Citrix and Microsoft policies that control connection settings for groups of users, clients, or servers. For example, you can create policies that apply one set of rules to connections from workstations in company headquarters and another set of rules to connections from lender laptops that you provide to a roaming sales force. General details about how to set up Citrix policies are provided in Using Policies to Configure Access to Published Resources in the Citrix Presentation Server Administrators Guide.
Chapter 4
41
This section provides details about policies that Citrix recommends you set up for Citrix Desktop Server. Workstations and servers you deploy as desktops must be members of a domain to which group policies can be applied. To open the Microsoft Group Object Policy Editor from the command line, you can use gpedit.msc.
42
If you enable this policy, users attempting to start the Task Manager will see a message explaining that a group policy disabling access to the Task Manager is in force.
Printing
For details about how to use the Presentation Server Console to configure and administer printing for your users, see the Citrix Presentation Server Administrators Guide. However, note that the Universal Printer Driver is not available to users connecting to workstation desktops. You therefore need to map printer drivers as described below.
Chapter 4
43
1. 2. 3.
In the Presentation Server Console, expand the Printer Management node and select Drivers. From the Actions menu, select Printer Management > Mapping. In the Driver Mapping dialog box, select a server platform and add the names of client printer drivers that correspond to the drivers you installed on servers in the farm.
1.
Add mapping entries for the specific client and server driver names to the Wtsuprn.txt template file located in the /Program Files/Citrix/System32/ directory. Rename the file to Wtsuprn.inf and copy it to the same directory on all servers on which you want to apply similar mappings.
2.
Note You can use wildcards to match a range of client driver names using a single mapping entry; for example, hp laserjet* will match any client driver with an identical prefix.
44
C HAPTER 5
Publishing Desktops
This chapter provides information about the following topics: Publishing server desktops (Windows Server 2003 desktops that users connect to through a direct ICA connection) Publishing workstation desktops (Windows XP desktops that users connect to through an RDP client wrapper that proxies access through ICA)
1. 2.
In the Citrix Desktop Server node of the Access Management Console, select your server farm. In the task pane, select New > Publish desktop. The Publish Desktop wizard then guides you through the tasks you need to complete to publish the desktop.
Note You cannot create desktops by importing settings from a Citrix Presentation Server farm; there is no interoperability between Citrix Desktop Server farms and Citrix Presentation Server farms.
On the Publish immediately page of the wizard you need to decide whether or not you want to modify the advanced settings. These comprise the following:
46
Access control. The default is to allow all connections made through the Access Gateway Advanced Edition. You can modify this to restrict allowed connections to those that meet the criteria of specified filters. Limits. You can limit the number of instances of the desktop that are allowed to run concurrently in the farm. You can also change the CPU priority level from the default setting of Normal. Client options. You can configure the settings for the following: Legacy audio, which is enabled by default SSL/TLS, which is not enabled by default Encryption, for which the default level is Basic Printing: by default the desktop starts without waiting for printers to be created
Appearance. You can modify the session window size, which defaults to full screen, and you can also modify the colors, which default to true color (24 bit). True color is the maximum supported by the Citrix clients.
Details about these basic steps are provided in the following sections. Before configuring workstation desktops, check that: The target operating system images can be accessed using a direct RDP console connection from the servers running Citrix Desktop Server. As a minimum test, you should verify and check IP addresses or FQDNs for responses using the ping command from the server, because the Desktop Broker Console does not validate target entries. All relevant users have RDP permissions to the workstation desktops you plan to publish. When a user connects to an assigned workstation desktop, user assignment takes place before successful logon completes. Any user without RDP permissions to the desktop but with permission to open the ICA connection
Chapter 5
Publishing Desktops
47
will be ultimately denied access to the desktop. This user will however be permanently assigned the desktop even though he has insufficient RDP privileges to connect. The only way to un-assign an incorrectly assigned desktop is to use the Desktop Broker Console to delete the desktop and recreate it.
48
To manage workstation desktops and connections to them you use the Desktop Broker Console, which you start by selecting Start > Programs > Citrix > Management Consoles > Desktop Broker Console:
Desktop group Desktop revision Workstation desktop entries
Left pane
Command buttons
Details pane
The Desktop Broker Console The left pane contains the console tree The details pane on the right displays items and information associated with the selected node in the console tree The tool bar at the bottom of the details pane displays command buttons associated with the contents of the details pane
Typically, you move around in the console as follows: Selecting a node in the left pane updates the items and information displayed in the details pane To modify or administer an item, you select it in the details pane, then click a command button in the tool bar at the bottom of the details pane
1. 2. 3.
In the Desktop Broker Console, select the Desktop Broker node. From the Action menu, select Add Desktop Group. The Add Desktop Group dialog box appears. Type the desktop group name, for instance, Finance01. The maximum name length is 128 characters.
Chapter 5
Publishing Desktops
49
4. 5.
The Enable Desktop Group check box is selected by default. To disable the desktop group, clear the check box. To create the desktop group, click OK.
1. 2. 3. 4. 5.
In the Desktop Broker Console, select the desktop group (for example, Finance01). From the Action menu, select Add Desktop Revision. The Add Desktop Revision dialog box appears. Type the desktop revision name, for instance, WinXP_SP2. The maximum name length is 128 characters. Type a description in the Description field. The maximum description length is 1024 characters. If you want the desktops in this revision to be permanently allocated to individual users on first use, select the Contains Assigned Desktops check box. To complete creation of the new desktop revision, click Add.
6.
1. 2. 3.
In the Desktop Broker Console, select the relevant desktop revision. From the Action menu, select Add Desktops. The Add Desktop dialog box appears. Type the hostname, IP address, or FQDN for the desktop you want to add. To add multiple entries, enter details of each desktop on a separate line. Each entry has a maximum length of 256 characters.
Important Ensure that the IP address, FQDN, or host name exists. The system does not verify this for you.
4. 5. The Enable Desktop check box is selected by default. To disable the desktop, clear the check box. To add the desktop to the revision, click Add.
50
After you add a desktop, its state appears in the Desktop Broker Console: Idle: No connection exists. The desktop is available for allocation to a user. Initializing: A request for a desktop connection has been received. Authenticating: Authentication required for a connection is taking place. Logged On: An active connection to a desktop exists. Disconnected: This can happen because of an interruption to the desktop connection, possibly due to a network failure. The desktop is still associated with the current user, who can reconnect by clicking the desktop icon. Failed: The connection to the desktop was interrupted because the database service cannot be contacted, or the desktop is unavailable. When a desktop is in a failed state, you can reset it, so that it is made available for use. To reset a desktop, right-click it in the details pane, then select Reset.
1. 2.
In the Citrix Desktop Server node of the Access Management Console, select your server farm. In the task pane, select New > Publish desktop. The Publish Desktop wizard then guides you through the tasks you need to complete to publish the desktop. For information about the advanced settings that you can configure on the Publish immediately page of the wizard, refer to the corresponding information for publishing server desktops above (page 45).
C HAPTER 6
To manage and monitor your Citrix Desktop Server deployment you use the Access Management Console and the Desktop Broker Console. The Desktop Broker Console is described on page 48. The Access Management Console tree for Citrix Desktop Server looks like this:
52
Managing and monitoring your deployment is described in the Citrix Presentation Server Administrators Guide. This chapter provides details about any differences between Citrix Presentation Server and Citrix Desktop Server that you need to be aware of, and also describes how to manage the Desktop Broker components.
Database Service
This section describes recommended best practices for ongoing maintenance of the database service.
Chapter 6
53
54
The synchronization service reads its configuration values from the registry key, HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Virtual Machine Server\Machine Manager. Configuration values are determined from the following registry values:
Key PollVmInterval Description Specifies how frequently the synchronization service is run. System performance issues could occur if this value is too small, causing the synchronization service to run too frequently. To avoid timing issues, ensure that the value of PollVmInterval is not significantly greater than TimeUntilVmIsDisconnected or TimeUntilVmIsFailed. Specifies the time interval after which a workstation desktop session in a Logged On state is set to the Disconnected state. Specifies the time interval after which a workstation desktop session in a Disconnected state is set to the Failed state. Specifies the logging level for the event log created by the database service. 0 = NoMessages 1 = FatalOnly 2 = FatalAndError 3 = FatalErrorAndWarning 4 = All Type DWORD Units Seconds Default 300 (5 minutes)
TimeUntilVmIsDisconnected
DWORD
Seconds
300 (5 minutes)
TimeUntilVmIsFailed
DWORD
Seconds
LoggingLevel
DWORD
Number
Chapter 6
55
56
C HAPTER 7
Troubleshooting
This chapter provides information about issues that may arise when you are using Citrix Desktop Server and, where possible, information about how to resolve or work around them.
58
This is a known issue. In fact, the RDP segment of the workstation desktop connection is still associated with the user account, and the user can reconnect to it. Disconnected RDP sessions are kept alive for 72 hours after which they are set to a failed state. This situation could occur if you did not disable group policies as recommended in ICA Connection Policies on page 42.
2.
Chapter 7
Troubleshooting
59
Configuring Multiple Assigned Workstation Desktops for a Single User or Preassigning an Assigned Desktop to a User
There is currently no direct way to either preassign a particular remote operating system image, or to assign multiple images to a particular user. Preassigning means that an RDP connection to a particular image is made when the user logs on for the first time. At this release, Citrix Desktop Server picks an image from a reserved pool and marks it as assigned only after the first use. A workaround is to create a desktop group containing an active desktop revision that contains only a single pointer to a desktop image. This means that a user sees one or more workstation desktop icons in the application list, but each icon points only to a single, dedicated image.
Printing Issues
Printing to USB Printers
If you expect your users to print to a USB printer from a workstation desktop session, you must install the printer driver for the USB printer on the client device, and on the server, as well as on the desktop.
60
Other Issues
Using the chfarm Utility
If you use the chfarm utility to move a server to another farm, the server is added to the IMA data store, appears in the Access Management Console and Presentation Server Console as part of the farm, and provides server desktops to users. However, the chfarm utility does not update the Desktop Broker database settings, so the migrated server still references the Desktop Broker database of the previous farm for providing workstation desktops to users.
To update the migrated server to use the Desktop Broker database of the new farm
1. 2. 3.
In the Windows Control panel of the migrated server, select Add or Remove Programs. From the list of currently installed programs, select Desktop Broker Database Service, then select Remove. When the database service has been successfully removed, open the Citrix Desktop Server CD and from the Desktop Broker folder open DatabaseService.msi. The Desktop Broker Database Service Installation wizard opens. Follow the steps in the wizard, ensuring that you specify the database for the new farm.
4.
Using Citrix Desktop Server in an Active Directory Domain that has Backwards Compatibility for pre-Windows 2000 Servers
In all configurations, all computers must be in an Active Directory domain. However, if the Active Directory domain is set up to be Permissions compatible with pre-Windows 2000 server operating systems (configured during Active Directory installation), the installation of Citrix Desktop Server completes successfully but the account used by servers to authenticate and check out computers from the Desktop Broker database has insufficient rights to perform these functions. To resolve this issue you must do the following: 1. Change the account used by the Citrix Desktop Broker Session Reaper service (for example, local administrator or domain administrator) so that it authenticates against the Desktop Broker database. Change the identity that the Citrix Desktop Broker database service COM+ service runs to the same account. The identity is in the properties of that COM+ service, which you access by selecting Start > Programs > Administrative Tools > Component Services and then expanding Computers > COM+ Applications.
2.
Chapter 7
Troubleshooting
61
3. 4. 5. 6. 7.
Add the account selected in Step 1 to the database server hosting the Desktop Broker database as a logon. Add a user who uses that logon to the cvmdb database. Add that user to the cvmm database role in the cvmdb database. Restart the COM+ service on the server running Citrix Desktop Server. Restart the Citrix Desktop Broker Session Reaper service on the server.
62
A PPENDIX
Citrix recommends you use the Citrix Presentation Server documentation set in conjunction with Citrix Desktop Server documentation because the two products share many of the same features. To help you get the most out of the Citrix Presentation Server documentation set, this appendix lists the Presentation Server features that are not available with Citrix Desktop Server. In addition, certain Presentation Server features are available in Citrix Desktop Server when clients connect to a server desktop, but not when connecting to a workstation desktop; these are also listed below.
64
A PPENDIX
The setup.exe file supports several command-line options for controlling the installation of Citrix Desktop Server.
-autologon <password>
-support <master>
66
Description File specifying an ODBC DSN file for accessing the database. This option is supported only when used with the -support option. User name for accessing the database. This option is supported only when used with the -support option. Password for accessing the database. This option is supported only when used with the -support option.
Examples
The -quiet option is an efficient way to install a large number of support servers compared with using the Installation wizard on individual servers. The following example shows how to add a support server when the master server is installed with all the components on the same computer: setup.exe -quiet -autologon buster01 -support server1 where buster01 is the current users password and server1 is the name of the master server. The following example shows how to add a support server when the farm is using an external SQL database: setup.exe -quiet -autologon buster01 -support server1 -dnsfilepath c:\MF20.dsn -dbusername alexco -dbpassword libby02 where buster01 is the current users password, server1 is the master server, c:\MF20.dsn is the path to the dsn file, alexco is the user name for accessing the database, and libby02 is the password for accessing the database. Note that you can copy the MF20.dsn file from the master server to the support server before installing the support server.
I NDEX
Index
A
Access Management Console starting 40 assigned desktops definition 12 pre-assigning 59
C
Citrix Authorized Learning Centers 9 Citrix Desktop Server benefits and features 11 how it works 14 overview 10 Citrix Developer Network 9 Citrix Solutions Advisors Program 8 client printer driver remapping 43 clients requirements 27 command-line parameters for setup.exe 65
desktop revisions creating 47 duplicate names 58 error message 58 desktop types 12 Disconnect option removing 41 discovery running 40 documentation using PDF 8 duplicate desktop revision names 58
E
education 9
F
farm data store creating 28 features of Citrix Desktop Server 11
D
data store creating 28 database requirements 23 deployments, supported 17 Desktop Broker components managing 52 Desktop Broker Console 48 Desktop Broker database service 15 backing up 52 maintaining 52 session synchronization 53 viewing status and error messages 53 Desktop Broker session manager 15 desktop delivery models 12 desktop groups creating and populating 47 error when adding 59
H
HP ProtectTools 28
I
ICA connection policies 42 installation command-line parameters 65 installing on a single server 29
L
logoff failure for workstation desktop session 58
M
management console requirements 26 My Knowledge 55
68
O
overview 10
U
unavailable Presentation Server features in Citrix Desktop Server 63 uninstalling Citrix Desktop Server 36
P
passwords, inability to change 57 PDF, using 8 policies ICA connection 42 using 40 pooled desktops definition 12 pre-installation tasks 27 printer driver remapping 43 printing 42 to USB printers from workstation desktop sessions 59 Program Neighborhood Agent installing 36 publishing server desktops 45 workstation desktops 46
W
Web Client installing 36 Web Interface creating sites 39 requirements 25 workstation desktops adding to a group 47 definition 12 publishing 46, 50
R
remapping client printer drivers 43 reset failure for workstation desktop session 58
S
server desktops definition 12 publishing 45 server drive letters, remapping 27 servers, adding to farm 32 session expiry group policy 57 session synchronization Desktop Broker database service 53 setup.exe command-line parameters 65 Shut Down command removing 41 Subscription Advantage 9 support 8 support servers 32 supported deployments 17 system requirements 22
T
Task Manager preventing user access 4142