Product Documentation

Install and Configure

Dec 15, 2011
XenApp installation and configuration are separate tasks. This task division provides flexibility when using provisioning tools and disk imaging.
  • For a wizard-based XenApp installation or configuration, use the XenApp Server Role Manager.
  • From the command line, use the XenAppSetupConsole.exe command to install the XenApp server role and the XenAppConfigConsole.exe command to configure the XenApp server role.
XenApp uses roles for XenApp features and related technologies. The wizard-based XenApp Server Role Manager uses the Server Role Installer to help you add certain XenApp roles. It detects the deployment phase for each role and displays the next task required to complete the installation and configuration of that role. From the XenApp Server Role Manager, you can:
  • Install role prerequisites
  • Install fully-integrated server roles (such as XenApp, Citrix licensing, Single sign-on service, and Provisioning Server)
  • Launch installers for partially-integrated roles (such as Power and Capacity Management Administration, SmartAuditor Server, EdgeSight Server)
  • Launch the Citrix License Configuration Tool to configure the XenApp role license parameters (mode, server, and port)
  • Launch the XenApp Server Configuration Tool to configure the XenApp server role
  • Launch configuration tools for other roles
  • Initiate a XenApp server restart (reboot)
  • Remove a server from a farm
  • Prepare a server for imaging and provisioning
  • Remove fully-integrated XenApp 6.5 roles and components
  • Upgrade roles (other than the XenApp server role) in XenApp 6 deployments

For command-line installation or configuration, enter the command with valid options and properties at a Windows Server command prompt.

Accessing the Server Role Manager

The XenApp Server Role Manager runs initially from the XenApp installation media. After you install a role, the Server Role Manager is installed locally and runs every time you log on to the XenApp server (you can disable this feature by selecting a checkbox on the main Server Role Manager page). You can also run the Server Role Manager from Start > All Programs > Administrative Tools > Citrix > XenApp Server Role Manager, or from its Program Files location (Program Files (x86)\Citrix\XenApp\ServerRoleManager\XenAppServerRoleManager). If a Server Role Manager is installed locally and you invoke a different one from the XenApp installation media, the version on the installation media is used.

Using the XenApp Media to Install and Upgrade

Citrix recommends using the XenApp 6.5 media to perform a clean install of the XenApp server role on a Windows Server 2008 R2 or Windows Server 2008 R2 SP1 server. Clean install means that there is no previous version of the XenApp server role installed on the server. If you have an earlier XenApp version installed (including an early release or Technical Preview version), reimage the server before installing the XenApp 6.5 server role.

If you cannot coordinate that recommended process, Citrix provides a XenApp 6.0 to 6.5 Upgrade Utility that you can customize for your servers; see CTX130614.

After you install and configure XenApp 6.5, you can migrate settings from a server running a XenApp 5 or XenApp 6.0 to the new XenApp 6.5 farm. For details, see XenApp Migration Center.

You can also remove a XenApp server role that was installed using the XenApp 6.5 media; however, you cannot use this functionality to remove an earlier version of the XenApp server role.

If you run the Server Role Manager from the XenApp 6.5 media on a XenApp 6.0 server, new software may be available for installed roles and components other than the XenApp server role. In these cases, the Server Role Manager will display Upgrade next to the role or component; clicking that link starts the upgrade process.
Important: Do not attempt to upgrade components and features in a XenApp 6.0 deployment using MSIs from the XenApp 6.5 media, unless explicitly instructed to do so.