Citrix Virtual Apps and Desktops

Install core components

Important:

Citrix collects basic licensing data as necessary for its legitimate interests, including license compliance. For more information, see Citrix Licensing Data.

The core components are the Citrix Delivery Controller, Citrix Studio, Web Studio, Citrix Director, and Citrix License Server.

Note:

Citrix Studio is a Windows-based management console that lets you configure and manage your on-premises Citrix Virtual Apps and Desktops deployment. Web Studio is the next generation of Citrix Studio — a web-based management console offering full feature parity with Citrix Studio. For more information about Web Studio, see Install Web Studio.

(In versions before 2003, core components included Citrix StoreFront. You can still install StoreFront by clicking the Citrix StoreFront tile or running the command available on the installation media.)

Before you start an installation, review this article and Prepare to install.

This article describes the installation wizard sequence when installing core components. Command-line equivalents are provided. For more information, see Install using the command line.

Step 1. Download the product software and launch the wizard

Use your Citrix account credentials to access the Citrix Virtual Apps and Desktops download page. Download the product ISO file.

Unzip the file. Optionally, burn a DVD of the ISO file.

Log on to the machine where you are installing the core components, using a local administrator account.

Insert the DVD in the drive or mount the ISO file. If the installer does not launch automatically, double-click the AutoSelect application or the mounted drive.

Step 2. Choose which product to install

Product selection page in component installer

Click Start next to the product to install: Virtual Apps or Virtual Apps and Desktops.

(If the machine already has Citrix Virtual Apps and Desktops components installed on it, this page does not appear.)

Command-line option: /xenapp to install Citrix Virtual Apps. Citrix Virtual Apps and Desktops is installed if option is omitted.

Step 3. Choose what to install

Component selection page in component installer

If you’re just getting started, select Delivery Controller. (On a later page, you select the specific components to install on this machine.)

If you’ve already installed a Controller (on this machine or another) and want to install another component, select the component from the Extend Deployment section.

Command-line option: /components

Step 4. Read and accept the license agreement

License agreement page in component installer

On the Licensing Agreement page, after you read the license agreement, indicate that you have read and accepted it. Then click Next.

Step 5. Select the components to install and the installation location

Core components page in component installer

On the Core components page:

  • Location: By default, components are installed in C:\Program Files\Citrix. The default is fine for most deployments. If you specify a different location, it must have execute permissions for network service.
  • Components: By default, the check boxes for all core components are selected. Installing all of the core components on one server is fine for proof of concept, test, or small production deployments. For larger production environments, Citrix recommends installing Director, StoreFront, and the License Server on separate servers. It is recommended to install Secure Private Access along with StoreFront.

    Note:

    If you’re installing components on more than one server, install the Citrix License Server and licenses first, before installing other components on other servers. For guidance, see the Automatic installation section of the Licensing Guide for Citrix Virtual Apps and Desktops.

    An icon alerts you when you choose not to install a required core component on this machine. That alert reminds you to install that component, although not necessarily on this machine.

Click Next.

Command-line options: /installdir, /components, /exclude

Hardware check

When you install or upgrade a Delivery Controller, the hardware is checked. The installer alerts you if the machine has less than the recommended amount of RAM (5 GB), which can affect site stability. For more information, see Hardware requirements.

Graphical interface: A dialog box appears.

  • Recommended: Click Cancel to stop the installation. Add more RAM to the machine and then start the installation again.
  • Alternatively, click Next to continue with the installation. The site might have stability issues.

Command-line interface: The install/upgrade ends. The install logs contain a message that describes what was found and the available options.

  • Recommended: Add more RAM to the machine and then run the command again.
  • Alternatively, run the command again with the /ignore_hw_check_failure option to override the warning. Your site might have stability issues.

When upgrading, you’re also notified if the OS or SQL Server version is no longer supported. See Upgrade a deployment.

Step 6. Enable or disable features

Features page in component installer

On the Features page:

  • Choose whether to install Microsoft SQL Server Express for use as the site database. By default, this selection is enabled. If you’re not familiar with the Citrix Virtual Apps and Desktops databases, review Databases.
  • When you install Director, Windows Remote Assistance is installed automatically. You choose whether to enable shadowing in Windows Remote Assistance for use with Director user shadowing. Enabling shadowing opens TCP port 3389. By default, this feature is enabled. The default setting is fine for most deployments. This feature appears only when you are installing Director.

Click Next.

Command-line options: /nosql (to prevent installation), /no_remote_assistance (to prevent enabling)

Step 7. Open Windows firewall ports

Firewall page in component installer

By default, the ports on the Firewall page are opened automatically if the Windows Firewall Service is running, even if the firewall is not enabled. The default setting is fine for most deployments. For port information, see Network ports.

Click Next.

(The graphic shows the port lists when you install all the core components on this machine. That type of installation is usually for test deployments only.)

Command-line option: /configure_firewall

Step 8. Review prerequisites and confirm installation

Summary page in component installer

The Summary page lists what will be installed. Use the Back button to return to earlier wizard pages and change selections, if needed.

When you’re ready, click Install.

The display shows the progress of the installation:

In-progress display during component installation

Step 9. Sharing diagnostics information with Cloud Software Group

Diagnostics page in component installer

On the Diagnostics page, choose whether to participate in Citrix Call Home.

This page appears when installing a Delivery Controller using the graphical interface. When you install StoreFront (but not a Controller), the wizard displays this page. When you install other core components (but not a Controller or StoreFront), the wizard does not display this page.

During an upgrade, this page does not appear if Call Home is already enabled or if the installer encounters an error related to the Citrix Telemetry Service.

If you choose to participate (the default), click Connect. When prompted, enter your Citrix account credentials. You can change your enrollment choice later, after installation.

After your credentials are validated (or if you choose not to participate), click Next.

If you click Connect on the Diagnostics page without first selecting Collect diagnostic information, after you close the Connect to Citrix Insight Services dialog the Next button is disabled. You cannot move to the next page. To reenable the Next button, select and immediately deselect Collect diagnostic information.

For more information, see Call Home.

Step 10. Sharing License Server data with Cloud Software Group

License Server Data

On the License Server Data page, we request that you share either Call Home data or Customer Experience Improvement Program (CEIP) data to assist us. In addition, Cloud Software Group also requires the collection of basic licensing data, including license compliance, as necessary for its legitimate interests.

The License Server Data page appears when you have installed License Server:

  • As a standalone.
  • As a core component, during installation of a Delivery Controller.

During an upgrade, this page does not appear if the configuration is already set in the /CITRIX.opt: file.

License Server monitors several types of user data, such as licensing data, Call Home data and CEIP data. To enable Call Home data and CEIP data collection, you must choose to participate (opt in).

For more information about how to enable Call Home and CEIP data collection when installing by using the command line, see Command line options for installing core components.

For more information about Cloud Software Group licensing data collection, see Citrix Licensing data collection programs.

Step 11. Finish this installation

Finish page in component installer

The Finish page contains green check marks for all prerequisites and components that installed and initialized successfully.

Click Finish.

Step 12. Install remaining core components on other machines

If you installed all the core components on one machine, continue with Next steps. Otherwise, run the installer on other machines to install other components. You can also install more Controllers on other servers.

Next steps

After you install all the required components, use Studio to create a site.

After creating the site, install VDAs.

At any time, you can use the full-product installer to extend your deployment with the following components: