Product Documentation

Configuring XenApp Using the Wizard-based Server Configuration Tool

Oct 09, 2015
Note: This procedure applies to configuring XenApp servers for the first time, unless otherwise indicated.

To configure XenApp using the wizard-based Server Configuration Tool:

  1. Access the XenApp Server Role Manager.

    The XenApp Server Role Manager runs every time you log on to the XenApp server, unless you disable that feature. You can run the XenApp Server Role Manager from Program Files (x86)\Citrix\XenApp\XenAppServerRoleManager\XenAppServerRoleManager.

  2. In the XenApp Server Role Manager task list, click Configure under XenApp. The Server Configuration Tool launches.
  3. Indicate the task you want to perform. If you have not yet configured the XenApp server role, you can create a farm or add the server to (join) an existing farm. The remainder of this procedure assumes you are creating a new farm or adding a server to an existing farm; see the Note for information about other scenarios.
    • When you install XenApp for Windows Server 2008 R2 on the first server, that server is where you create a new farm.
    • After you install XenApp on other servers, you add each server to (join) an existing farm.
    Note:
    • If you previously configured the XenApp server role, and you are using the XenApp Server Configuration Tool from the XenApp 6 for Windows Server 2008 R2 installation media, you can create a farm, add the server to (join) an existing farm, or leave (remove the server from) the farm. If you choose to create a farm or add the server to an existing farm, the server will be removed from its current farm before creating or joining another farm.
    • If you previously configured the XenApp server role, and you installed the updated XenApp Server Configuration Tool, you can prepare the server for imaging and provisioning, or leave (remove the server from) the farm.
  4. When creating a farm, on the Enter basic information page:
    • Enter a farm name, up to 32 characters (can include spaces). If you are using Oracle as your Configuration Logging database, do not use hyphens in the farm name.
    • Specify the domain and username for a user who will be the first Citrix administrator. The administrator has full permissions to the farm and can create additional administrator accounts.
  5. When creating a farm, specify Citrix License Server information. Choose one of the options:
    • To use an existing license server, enter the license server name. By default, the license server uses port 27000 unless you deselect that option and specify a different port number.
    • Defer specifying license server information.

    For complete information, see the licensing documentation.

  6. Select the data store database type and connection information.
    If you choose the entry for Action

    New database

    When creating a farm, the Server Configuration Tool installs the Microsoft SQL Server Express database automatically, with the instance name CITRIX_METAFRAME and database name MF20; the database uses Windows authentication.

    Existing Microsoft SQL Server database

    You are prompted for the instance name, the database name, and the authentication method. This database can be located on a remote SQL server.

    Existing Oracle database

    You are prompted for the Net Service name. (The Oracle entry appears only if the Oracle client is installed on the server where you are configuring the XenApp role.)

  7. Specify the database credentials. Specify the user name in the form <DBMACHINE>\<USER> or <DOMAIN>\<USER>.

    SQL Server Express requires an existing Windows account, but it does not need to be a server or system administrator. The XenApp Server Configuration Tool adds two database administrators to SQL Server Express: (local)\administrators and the supplied credentials for the local or domain user.

    When adding a server to (joining) a farm, you can optionally test the connection to the database. The result does not affect Server Configuration Tool operations.

  8. The default session shadowing settings (which allow shadowing) are recommended for most farms. Shadowing settings supplied during XenApp configuration override system or domain policy for user-to-user shadowing.
    Important: Shadowing features are permanent and should be changed only if you wish to permanently prevent system or domain policy from affecting that setting. If you disable shadowing or change shadowing features during configuration, you cannot reconfigure them later.
    Option Description

    Prohibit shadowing of user session on this server

    Disables user session shadowing on this server. If selected, shadowing cannot be enabled on this server through policies. Default = unselected

    Allow shadowing of user sessions on this server

    Enables user session shadowing on this server. Default = selected

    When you enable shadowing, you can apply the following features (default = all unselected):

    • Prohibit remote control. If selected:
      • Authorized users can view sessions but do not have keyboard and mouse input
      • Remote control is permanently prohibited; this cannot be enabled on this server through policies.
    • Force a shadow acceptance prompt. If selected:
      • Authorized users must send an acceptance prompt when attempting to shadow a session.
      • A shadow acceptance prompt is shown on every shadowing attempt; this cannot be disabled on this server through policies.
    • Force logging of all shadow connections. If selected:
      • All shadowing attempts, successes, and failures are logged in the Windows event log.
      • Shadow connections are always logged; this cannot be disabled on this server through policies.
  9. If you do not change the following server settings, the Server Configuration Tool uses default values.
    Setting Description

    License Server

    (Displays only when adding a server to (joining) a farm). Choose one of the options:
    • Enter the name of an existing license server name (NetBIOS computer name, fully-qualified domain name (FQDN), or IP address). By default, the license server uses port 27000 unless you deselect that option and specify a different port number.
    • (Default) To use the global farm settings for the license server, select this option.

    Zone

    The default zone name is ‘Default Zone.’ To create a custom zone name, select the checkbox and enter the name.

    XML Service

    By default, XenApp server role installation configures the Citrix XML Service and Internet Information Service (IIS) to share the same TCP/IP port (80) for communications. In this case, you cannot change the XML Service setting. See System Requirements for more information.

    Online plug-in

    Server name or URL of the Web Interface server used by the Citrix online plug-in.

    Remote Desktop Users

    Only members of the Remote Desktop Users group can connect to published applications. Until you add users to this group, only administrators can connect remotely to the server. Select one or more of the following.
    • Add Anonymous users. Adds anonymous users to the Remote Desktop Users group. Default = selected
    • Add the Authenticated users. Adds current (and future) domain accounts in the Windows Users group to the Remote Desktop Users group. Default = unselected
    • Add the list of users from the Users group. Adds all current users from the Users group to the Remote Desktop Users group. If you add users later, you must add them manually to the Remote Desktop Users group. Default = selected
  10. If you installed the plug-in (or agent) for Single sign-on, SmartAuditor, EdgeSight, or Power and Capacity Management on this server, specify the requested information to enable communications with them. (The plug-in (or agent) roles use separate tools for their configuration.)
  11. Review the summary page and click Apply.
After configuration completes, you are returned to the XenApp Server Role Manager task list, which indicates if any requirements remain, such as a server restart. The XenApp Server Role Manager updates the task list after any task completes.
  • To initiate a server restart, click Reboot.
  • To change a role configuration, click Edit Configuration.