Product Documentation

Make Citrix Receiver installation files available on the server

Dec 18, 2014

By default, when a user accesses a Receiver for Web site from a computer running Windows or Mac OS X, the site attempts to determine whether Citrix Receiver is installed on the user's device. If Citrix Receiver cannot be detected, the user is prompted to download and install the appropriate Citrix Receiver for their platform from the Citrix website.

If you copy Receiver for Windows and Receiver for Mac installation files to the StoreFront server, you can configure the site to provide users with these local files rather than redirecting them to the Citrix website. When Citrix Receiver installation files are available on the StoreFront server, you can also configure the site to offer users with older clients the option to upgrade to the version on the server. To configure deployment of Receiver for Windows and Receiver for Mac, you run Windows PowerShell scripts and edit the site configuration file.
Note: These changes cannot be reverted. If you are not changing other configuration settings, you may revert with the following workaround: Back up the web.config file under C:\inetpub\wwwroot\citrix\<storename> before you change the download link and restore the web.config file when you want to revert it back. Make a copy of the default setting to refer to. The StoreFront and PowerShell consoles cannot be open at the same time. Always close the StoreFront admin console before using the PowerShell console to administer your StoreFront configuration. Likewise, close all instances of PowerShell before opening the StoreFront console.
Important: In multiple server deployments, use only one server at a time to make changes to the configuration of the server group. Ensure that the Citrix StoreFront management console is not running on any of the other servers in the deployment. Once complete, propagate your configuration changes to the server group so that the other servers in the deployment are updated.
  1. Copy the Receiver for Windows and Receiver for Mac installation files to \Receiver Clients\Windows\ and \Receiver Clients\Mac\ directories, respectively, in the StoreFront installation, which is typically located at C:\Program Files\Citrix\Receiver StoreFront\.

    You also have the option to copy Citrix Receiver installation files to the server when installing StoreFront at a command prompt. For more information, see To install StoreFront at a command prompt.

  2. Using an account with local administrator permissions, start Windows PowerShell and, at a command prompt, type the following commands to update StoreFront with the Citrix Receiver installation file names.
    & "installationlocation\Scripts\UpdateWindowsReceiverLocation.ps1" 
      -ClientLocation "Windows\filename.exe" 
    & "installationlocation\Scripts\UpdateMacOSReceiverLocation.ps1" 
      -ClientLocation "Mac\filename.dmg"

    Where installationlocation is the directory in which StoreFront is installed, typically C:\Program Files\Citrix\Receiver StoreFront\, and filename is the name of the Citrix Receiver installation file.

  3. On the StoreFront server, use a text editor to open the web.config file for the Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  4. Locate the following element in the file.
    <pluginAssistant ... upgradeAtLogin="false"> 
  5. Set the value of the upgradeAtLogin attribute to true to offer users with older clients the option to upgrade to the versions available on the server.