Product Documentation

Install the Citrix web service

Jun 05, 2015
Updated: 2014-08-14

The Citrix web service is installed on all XenApp servers in your environment that you want to make available for provisioning hosted apps and desktops to users. You can install the Citrix web service using either the graphical interface of the Services Manager Setup Tool or through the command line. After the installation process finishes, you can enable the service and continue configuration through the control panel.

To install the Citrix web service using the graphical interface

The installation process includes preliminary configuration to create the web service account and IIS application pool, and define the service port.

This task assumes the Services Manager installer is running and the Select Deployment Task page is displayed.

  1. On the Select Deployment Task page, select Install CloudPortal Services Manager.
  2. On the Install CloudPortal Services Manager page, select Add Services.
  3. On the Add Services page, select Install Services.
  4. Accept the License Agreement and then click Next.
  5. On the Select Web Services page, select Citrix Web Service and then click Next.
  6. On the Review Prerequisites page, review the list of software that will be installed to support the web service and then click Next.
  7. On the Ready to Install page, click Install.
  8. After the installation finishes, click Finish.
  9. On the Add Services page, select Configure Services.
  10. On the Installed Services page, click Configure next to the XenApp Web Service item. The Configuration Tool attempts to contact the Encryption Service to retrieve the encrypted key. If the service cannot be contacted, the Configuration Tool prompts you to import the encrypted key using a key file. To generate the key file, see Generate and export keyfiles for the Encryption Service.
  11. If required, import the Encryption Service key file:
    1. In Key File Path, click Browse and locate the key file you generated from the Encryption Service web site.
    2. In Password, enter the password that was specified when the key file was generated. Click Next.
  12. On the Configure IIS page, enter the following information and then click Next:
    • Auto-generate credentials: Select this check box to allow the Configuration Tool to generate service account credentials automatically.
    • User name: Enter a user name for the Citrix web service account. The default user name is csm_citrix_svc. This field is unavailable when you elect to auto-generate credentials.
    • Password: Enter a password for the Citrix web service account. This field is unavailable when you elect to auto-generate credentials.
    • Create if doesn't exist: Leave this check box selected to allow the web service account to be created if it does not already exist in Active Directory.
    • Service port: Enter the port used by the Citrix web service. The default port is 8095.
  13. On the Summary page, review the configuration information. If you want to change anything, return to the appropriate configuration page. When the summary contains the settings you want, click Next. The Configuration Tool configures the Citrix web service and displays progress.
  14. Click Finish and then click Exit to close the Configuration Tool.

To install the Citrix web service from the command line

Before installing the Citrix web service, ensure the following pre-requisites are met:
  • You have installed .NET Framework 4, located in the Support folder of the Services Manager installation media, on the XenApp server.
  • The XenApp servers are running supported versions of Citrix XenApp.
  • You have created the Citrix web service account in Active Directory.
  • The Citrix web service account is a Citrix administrator with Full Administration permissions on the XenApp servers where you install the Citrix web service.
  • The XenApp server allows inbound connections from the Web platform server on the appropriate port. The default port is 8095.
When you install the Citrix service from the command line, you perform two actions:
  • Install the web service and create the required Services Manager directory where the web service resides.
  • Perform initial configuration of the web service using the Configuration Tool.
  1. On the XenApp server, log on as an administrator.
  2. Open a command line window and navigate to the CortexSetup directory on the Services Manager installation media.
  3. At the command prompt, enter CortexSetupConsole.exe /Install:Citrix. The Setup Tool installs the web service and returns the command prompt.
  4. At the command prompt, enter install-locationServicesCitrixWSConfigurationCitrixServiceConfigConsole.exe and specify the following properties:
    Property Description
    /UserName:ctx_svc_acct Impersonation account for the Citrix service. This account must be a Citrix administrator.
    /Password:password Password for the Citrix service account.
    /ServicePort:port Inbound port to be used/added to the CortexServices web site. Default = 8095

    Install-location denotes the web service installation directory on the local computer. The default directory is C:Program Files (x86)CitrixCortex.

    The Configuration Tool performs initial configuration of the web service and returns the command prompt.

Sample command string

The following command performs the initial configuration of the web service.
 /UserName:ctx_svc_acct /Password:password /ServicePort:8095

When the installation process is finished, log on to the control panel and configure the web service. For instructions, see Configure the Citrix service.