Product Documentation

Installing and Configuring XenApp

Oct 09, 2015
XenApp installation and configuration are separate tasks available through a graphical user interface or command line.
  • For a wizard-based XenApp installation or configuration, use the Server Role Manager.
  • For a command-line installation, use the XenAppSetupConsole command to install XenApp roles and the XenAppConfigConsole command to configure XenApp roles.
This task division provides flexibility when using provisioning tools and disk imaging:
  • Use startup scripts to install and configure XenApp when a disk image is launched.
  • Install XenApp on the disk image and use startup scripts to configure XenApp when the instance is launched.
  • Install and configure XenApp on the disk image and run startup scripts that modify the configuration when the image is launched. You can use this option to modify your XenApp configuration on the fly, without having to reconfigure or reimage disks.

For information about provisioning and imaging using Citrix products, see the Citrix Web site.

Using the Server Role Manager

XenApp for Windows Server 2008 R2 uses roles for XenApp features and technologies. The XenApp Server Role Manager provides a graphical user interface that guides you through installing (that is, adding) certain XenApp roles, using the Server Role Installer. In addition to expediting prerequisite and role installation, this tool detects the deployment phase for each role and displays the next task required to complete the installation and configuration of that role. From the Server Role Manager, you can:
  • Add server roles
  • Launch installers for partially-integrated roles
  • Automatically install many role prerequisites
  • Launch configuration tools such as the XenApp Server Configuration Tool to configure the XenApp server
  • Initiate a XenApp server restart (reboot)

You can run the XenApp Server Role Manager at any time. It initially runs 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 rerun it 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.

Each XenApp role has an integration level:
Integration Level Description


Role prerequisites and the role software install automatically. Fully integrated roles include XenApp, Citrix License Server, Web Interface, Single sign-on service, and Provisioning Server.


Role prerequisites install automatically. The role is added to the Server Role Manager task list, where you can launch the role installer (that is, the wizard for that role). Partially integrated roles include Secure Gateway, Power and Capacity Management Administration, SmartAuditor Server, and EdgeSight Server.

Information-only or media-only

Roles you cannot install using the Server Role Manager. Information-only roles include Merchandising Server, which is a virtual appliance that requires a virtual machine.

The XenApp installation media contains installation files for media-only roles. See the role documentation for installation instructions.

Using the Command Line

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