Professional Documents
Culture Documents
www.citrix.com
Contents
Introduction ........................................................................................................................................................ 3 Getting Started ................................................................................................................................................... 4 Architectural Diagram ................................................................................................................................... 4 System and Software Requirements ............................................................................................................ 4 Requirements for the Client Computer .................................................................................................. 4 Requirements for XenApp Servers ......................................................................................................... 5 Requirements for the Database Server ................................................................................................... 5 Requirements for Access Gateway ......................................................................................................... 6 Requirements for EdgeSight for reporting (Optional)......................................................................... 6 Mapping the XenApp DVD image ............................................................................................................. 6 Citrix Online Plug-in Transform ............................................................................................................. 6 Web Interface Installation Package ......................................................................................................... 6 Enhanced Desktop Experience Setup .................................................................................................... 6 Preparing the Client Computer.................................................................................................................... 7 Step One: Install setup tools .................................................................................................................... 7 Step Two: Configure the Deployment ................................................................................................... 7 Setting up the Farm ....................................................................................................................................... 8 Working with Tenants ....................................................................................................................................... 9 Adding New Tenants to the Farm .............................................................................................................. 9 Removing Tenants from the Farm.............................................................................................................. 9 Adding and Removing Farm Capacity .....................................................................................................10 Managing Desktops .........................................................................................................................................11 Enabling Windows 7 Look and Feel for Users .......................................................................................11 Restricting Access to Allocated Servers ...................................................................................................11 Usage Reporting ...............................................................................................................................................13 Helpful hints .....................................................................................................................................................14
Page 2
Introduction
The Citrix Service Provider program makes it easy to deliver the power of hosted enterprise applications and desktops to SMBs on a rental, subscription, or services basis. In order to deliver these services to their customers, partner organizations must have an efficient and reliable method of deploying Citrix XenApp farms. This document explains how Citrix Service Providers can use PowerShell scripts to install and configure XenApp farms, add tenants, and manage farm capacity for each tenant.
Page 3
Getting Started
Architectural Diagram
To deploy XenApp in a hosted environment, Citrix provides setup tools that are comprised of several PowerShell scripts. The setup tools are designed to deploy the Citrix recommended reference architecture as shown in the figure below. You can learn more about this reference architecture in the Citrix Knowledge Center: http://forums.citrix.com/thread.jspa?threadID=276053&tstart=0.
Page 4
If you are creating the farm database automatically, the user account must have permissions to create the database on the SQL server. The user account running the scripts must have permissions to create Active Directory (AD) objects (e.g., organizational units (OUs), user groups, and Group Policy objects (GPOs)) and to move machines between the Computers folder and OUs.
Requirements for XenApp Servers Ensure you have the computers necessary to assume the following roles in your deployment: Data collector for the XenApp farm Backup data collector for the XenApp farm Web Interface server Additional machines to be used as XenApp servers for adding capacity for a tenant
Each XenApp server must have the following components installed: Windows Server 2008 R2 operating system must be installed. NET Framework 3.5 SP1 PowerShell execution policy must be set to AllSigned. PowerShell remoting enabled. For more information, see the Microsoft TechNet article about_Remote_Requirements. The servers must be joined to the same domain as the client machine.
For more information about XenApp server requirements, see the topic System Requirements for XenApp 6 for Windows Server 2008 R2 in Citrix eDocs. Requirements for the Database Server SQL Server 2008 or higher must be installed. If you are creating a database on SQL Server using the infrastructure setup scripts, ensure that: SQL Server is set up as the default instance. SQL PowerShell provider, included with SQL Management Studio, is installed on the server. PowerShell remoting is enabled. For more information, see the Microsoft TechNet article about_Remote_Requirements. Windows authentication is configured. The user account running the scripts has permissions to create the database.
Page 5
If you are creating database the manually: Assign db_owner permissions on the database to the user account for IMA Use either Windows authentication or SQL Authentication
Requirements for Access Gateway For information about requirements for including Access Gateway in your deployment, see the Access Gateway documentation in Citrix eDocs. Requirements for EdgeSight for reporting (Optional) For information about requirements for including EdgeSight in your deployment for usage reporting, see the EdgeSight documentation in Citrix eDocs.
These changes are not necessary when using a XenApp Technical Preview DVD image. Citrix Online Plug-in Transform 1. Download the zip file from this KB article - http://support.citrix.com/article/CTX123761. 2. Extract the .mst transform file to <DVD_ROOT> \Citrix Receiver and Plugins\Windows\Online Plug-In. Web Interface Installation Package Replace the <DVD_ROOT>\Web Interface\WebInterface.exe file with the installation package for Web Interface 5.4, available as a download from the Citrix Web site. Enhanced Desktop Experience Setup If you want to enable the Enhanced Desktop Experience role, copy the CitrixAppDeliverySetupTools.exe file to the <DVD_ROOT> folder.
Page 6
Page 7
Depending on the configuration options chosen for the database, the script creates a new database for the farm or uses an existing database. Re-deploying an existing farm can cause the farm database to be corrupted. To avoid this, the configuration file is updated after the farm has been successfully deployed to prevent further editing with Save-SetupConfig or re-creating the farm database with Install-CtxFarm. If you want to specify a new configuration file with the same name, you must include the overwrite flag for the SaveSetupConfiguration script. After farm setup is complete, you can begin hosting multiple tenants.
Page 8
Note: Before removing a tenant, be sure to remove all capacity that has been allocated.
You can clean up the tenant objects by running the Unregister-Tenant script. As with the RegisterTenant script, there is some flexibility when running this script and the available options can be viewed in the help included with the script.
Page 9
If the Tenant parameter is used with the Unregister-Tenant script, all objects in Active Directory are deleted. However, if the OU parameter is used, then only the user group is deleted from Active Directory. To clean up the worker group, the script evaluates all worker groups in the farm and removes any references to the tenants Computer OU. If the worker group is empty after removing this reference, the script deletes it from the farm. This script does not affect any of the tenants published applications or desktops, so you will have to delete them manually, if necessary.
Note: Before removing a tenant, be sure to remove all capacity that has been allocated.
Page 10
Managing Desktops
To manage and configure restrictions within published desktops, use the NewCtxManagedDesktopGPO script. This creates three user GPOs CtxStartMenuTaskbarUser, CtxPersonalizableUser, CtxRestrictedUser and one computer GPO CtxRestrictedComputer. After these GPOs are created in Active Directory, link the user GPOs to the desired user accounts and the computer GPO to the XenApp servers. Be aware that simply applying these policies is not enough to deliver a secure, locked-down desktop. You still need to follow your organizations security best practices for ensuring the servers and the desktops they deliver are protected. View the detailed settings that are configured in each of the GPOs using the Group Policy Management Console.
To see a complete list of the settings, view the GPO in the Group Policy Management Console.
Page 12
Usage Reporting
A set of EdgeSight reports is available for easier tracking of users in a cloud environment. For more information on accessing and using these reports, refer to the article Citrix Service Providers Guide to Using Citrix EdgeSight. This resource is included in the Citrix Service Provider Toolkit, available from the Citrix Web site. .
Page 13
Helpful hints
Use the following tips for managing or troubleshooting your XenApp farm; Do not edit the setup and configuration scripts directly. Instead, copy the scripts to a separate directory and make your changes. The farm setup and capacity management scripts assume the servers are joined to the same domain and are accessible through PowerShell remoting. The scripts do not provision any machines automatically. The farm configuration scripts restart the servers to join the farm. Do not use any VMs that will lose changes when restarting occurs. Enabling the Enhanced Desktop Experience feature may degrade the performance and lower the user density on the server. If the user has an existing profile, some of the GPO settings may not apply correctly. To install the Enhanced Desktop Experience setup scripts only, run the CitrixAppDeliverySetupTools.exe file with the ADDLOCAL=EnhancedDesktopSetup parameter. To install the Infrastructure Setup scripts only, run the CitrixAppDeliverySetupTools.exe file with the ADDLOCAL=InfrastructureSetup parameter.
Page 14