Product Documentation

Install, set up, and uninstall

Oct 09, 2015

Before installing and configuring

To install and configure StoreFront, complete the following steps in order.

  1. If you plan to use StoreFront to deliver XenDesktop and XenApp resources to users, ensure that the StoreFront server is joined to either the Microsoft Active Directory domain containing your users' accounts or a domain that has a trust relationship with the user accounts domain.

    Note: StoreFront cannot be installed on a domain controller.
  2. If not already present, StoreFront requires Microsoft .NET 4.5 Framework, which can be downloaded from Microsoft. You must have Microsoft .NET 4.5 installed before you can install StoreFront.
  3. Optionally, if you plan to configure a multiple server StoreFront deployment, set up a load balancing environment for your StoreFront servers.

    To use NetScaler for load balancing, you define a virtual server to proxy your StoreFront servers. For more information on configuring NetScaler for load balancing, see Load balancing with NetScaler.

    1. Ensure that load balancing is enabled on your NetScaler appliance.
    2. For each StoreFront server, create individual HTTP or SSL load balancing services, as appropriate, using the StoreFront monitor type.

    3. Configure the services to insert the client IP address into the X-Forwarded-For HTTP header of requests forwarded to StoreFront, overriding any global policies.

      StoreFront requires users' IP addresses to establish connections to their resources.

    4. Create a virtual server and bind the services to the virtual server.
    5. On the virtual server, configure persistence on the basis of source IP address.

      Persistence ensures that only the initial user connection is load balanced, after which subsequent requests from that user are directed to the same StoreFront server.

  4. Optionally, enable the following features.

    • .NET Framework 4.5 Features > .NET Framework 4.5, ASP.NET 4.5

    Optionally, enable the following roles and their dependencies on the StoreFront server.

    • Web Server (IIS) > Web Server > Common HTTP Features > Default Document, HTTP Errors, Static Content, HTTP Redirection
    • Web Server (IIS) > Web Server > Health and Diagnostics > HTTP Logging
    • Web Server (IIS) > Web Server > Security > Request Filtering, Windows Authentication
    • On Windows Server 2012 servers:

      Web Server (IIS) > Web Server > Application Development > .NET Extensibility 4.5, Application Initialization, ASP.NET 4.5, ISAPI Extensions, ISAPI Filters

      On Windows Server 2008 R2 servers:

      Web Server (IIS) > Web Server > Application Development > .NET Extensibility, Application Initialization, ASP.NET, ISAPI Extensions, ISAPI Filters

    • Web Server (IIS) > Management Tools > IIS Management Console, IIS Management Scripts and Tools

    The StoreFront installer checks that all the features and server roles above are enabled.

  5. Install StoreFront.
  6. Optionally, configure Microsoft Internet Information Services (IIS) for HTTPS if you plan to use HTTPS to secure communications between StoreFront and users' devices.

    HTTPS is required for smart card authentication. By default, Citrix Receiver requires HTTPS connections to stores. You can change from HTTP to HTTPS at any time after installing StoreFront, provided the appropriate IIS configuration is in place.

    To configure IIS for HTTPS, use the Internet Information Services (IIS) Manager console on the StoreFront server to create a server certificate signed by your domain certification authority. Then, add HTTPS binding to the default website. For more information about creating a server certificate in IIS, see http://technet.microsoft.com/en-us/library/hh831637.aspx#CreateCertificate. For more information about adding HTTPS binding to an IIS site, see http://technet.microsoft.com/en-us/library/hh831632.aspx#SSLBinding.

  7. Ensure your firewalls and other network devices permit access to TCP port 80 or 443, as appropriate, from both inside and outside the corporate network. In addition, ensure that any firewalls or other devices on your internal network do not block traffic to any of the unassigned TCP ports.

    When you install StoreFront, a Windows Firewall rule is configured enabling access to the StoreFront executable through a TCP port randomly selected from all unreserved ports. This port is used for communications between the StoreFront servers in a server group.

  8. Use the Citrix StoreFront management console to configure your server.

Install StoreFront

  1. Download the installer from the download page.
  2. Log on to the StoreFront server using an account with local administrator permissions.
  3. Ensure that the required Microsoft .NET 4.5 Framework is installed on the server.
  4. Browse the download package, locate CitrixStoreFront-x64.exe, and run the file as an administrator.
    Note: On Windows Server 2008 R2 servers, a message may be displayed indicating that the .NET feature will be enabled. If this message appears, click Yes.
  5. Read and accept the license agreement, and click Next.
  6. If the Review prerequisites page appears, click Next.
  7. On the Ready to install page, check the prerequisites and StoreFront components that are listed for installation and click Install.

    Before the components are installed, the following roles are enabled if they are not already configured on the server.

    • Web Server (IIS) > Web Server > Common HTTP Features > Default Document, HTTP Errors, Static Content, HTTP Redirection
    • Web Server (IIS) > Web Server > Health and Diagnostics > HTTP Logging
    • Web Server (IIS) > Web Server > Security > Request Filtering, Windows Authentication
    • On Windows Server 2012 servers:

      Web Server (IIS) > Web Server > Application Development > .NET Extensibility 4.5, Application Initialization, ASP.NET 4.5, ISAPI Extensions, ISAPI Filters

      On Windows Server 2008 R2 servers:

      Web Server (IIS) > Web Server > Application Development > .NET Extensibility, Application Initialization, ASP.NET, ISAPI Extensions, ISAPI Filters

    • Web Server (IIS) > Management Tools > IIS Management Console, IIS Management Scripts and Tools

    The following features are also enabled if they are not already configured.

    • .NET Framework 4.5 Features > .NET Framework 4.5, ASP.NET 4.5
  8. When the installation is complete, click Finish. The Citrix StoreFront management console starts automatically. You can also open StoreFront from the Start screen.

  9. In the Citrix Storefront management console, click Create a new deployment.
    1. Specify the URL of the StoreFront server in the Base URL box.
    2. On the Store Name page, specify a name for your store, and click Next.
  10. On the Delivery Controllers page, list the infrastructure – the details of the XenApp or XenDesktop services – that is providing the resources you want to make available in the store. You can enter a “dummy” server here; however, no apps will display in the store.
  11. Set the Transport type and the Port. You can specify HTTP and port 443 and click OK. Alternatively, copy settings from an existing Web Interface or StoreFront deployment.
  12. On the Remote Access page, select None. If you are using NetScaler Gateway, select No VPN Tunnel and enter your gateway details.
  13. On the Remote Access page, select Create. Once the store has been created, click Finish.
Your store is now available for users to access through the Receiver for Web site, which enables users to access their desktops and apps through a webpage.

The URL for users to access the Receiver for Web site for the new store is displayed. For example: example.net/Citrix/MarketingWeb/. Log on and you will access the new user interface in Citrix Receiver.

To install StoreFront at a command prompt

  1. Log on to the StoreFront server using an account with local administrator permissions.
  2. Ensure that all of the requirements for installation of StoreFront are met before installing StoreFront. Refer to Before installing and configuring for details.
  3. Browse your installation media or download package, locate CitrixStoreFront-x64.exe, and copy the file to a temporary location on the server.
  4. At a command prompt, navigate to the folder containing the installation file and type the following command.
    CitrixStoreFront-x64.exe [-silent] [-INSTALLDIR installationlocation] 
      [-WINDOWS_CLIENT filelocation\filename.exe] 
      [-MAC_CLIENT filelocation\filename.dmg]
    

    Use the -silent argument to perform a silent installation of StoreFront and all the prerequisites. By default, StoreFront is installed at C:\Program Files\Citrix\Receiver StoreFront\. However, you can specify a different installation location using the -INSTALLDIR argument, where installationlocation is the directory in which to install StoreFront.

    By default, if a Receiver for Web site cannot detect Citrix Receiver on a Windows or Mac OS X device, the user is prompted to download and install the appropriate Citrix Receiver for their platform from the Citrix website. You can modify this behavior so that users download the Citrix Receiver installation files from the StoreFront server instead. For more information, see Make Citrix Receiver installation files available on the server.

    If you plan to make this configuration change, specify the -WINDOWS_CLIENT and -MAC_CLIENT arguments to copy Receiver for Windows and Receiver for Mac installation files, respectively, to the appropriate location in your StoreFront deployment. Replace filelocation with the directory containing the installation file that you want to copy and filename with the name of the Citrix Receiver installation file. Receiver for Windows and Receiver for Mac installation files are included on your StoreFront installation media or download package.

Configure StoreFront

When the Citrix StoreFront management console first starts, two options are available.

  • Create a new deployment. Configure the first server in a new StoreFront deployment. Single-server deployments are ideal for evaluating StoreFront or for small production deployments. Once you have configured your first StoreFront server, you can add more servers to the group at any time to increase the capacity of your deployment. 
  • Join existing server group. Add another server to an existing StoreFront deployment. Select this option to rapidly increase the capacity of your StoreFront deployment. External load balancing is required for multiple server deployments. To add a new server, you will need access to an existing server in the deployment.
  • Configure Receiver for Web.
  • Configuring and managing featured app groups.

Uninstall StoreFront

Updated: 2014-08-04

In addition to the product itself, uninstalling StoreFront removes the authentication service, stores, Receiver for Web sites, Desktop Appliance sites, and XenApp Services URLs, and their associated configurations. The subscription store service containing users' application subscription data is also deleted. In single-server deployments, this means that details of users' application subscriptions are lost. However, in multiple server deployments these data are retained on other servers in the group. Prerequisites enabled by the StoreFront installer, such as the .NET Framework features and the Web Server (IIS) role services, are not removed from the server when StoreFront is uninstalled.

  1. Log on to the StoreFront server using an account with local administrator permissions.
  2. On the Windows Start screen or Apps screen, locate the Citrix StoreFront tile. Right-click the tile and click Uninstall.
  3. In the Programs and Features dialog box, select Citrix StoreFront and click Uninstall to remove all StoreFront components from the server.
  4. In the Uninstall Citrix StoreFront dialog box, click Yes. When the uninstallation is complete, click OK.