Product Documentation

Install the Windows Web Hosting web service

Jun 05, 2015
Updated: 2013-02-15

The Windows Web Hosting web service is installed on all web servers in your environment that you want to make available for provisioning web sites to customers. You can install the Windows Web Hosting web service using either the graphical interface of the Services Manager installer 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 Windows Web Hosting web service using the graphical interface

The installation process includes preliminary configuration to create the web service account, local file share, and FTP site. This process also creates an FTP User Isolation account for accessing each customer's service OU in Active Directory.

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 Add Services & Locations.
  2. On the Add Services & Locations page, select Install Services.
  3. Accept the License Agreement and then click Next.
  4. On the Select Web Services page, select Windows Web Hosting Service and then click Next.
  5. On the Ready to Install page, review your selection and then click Install.
  6. After the installation finishes, click Finish.
  7. On the Installed Services page, click Configure next to the IIS web service list item.
  8. 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 web service account. The default user name is csm_iis_svc. This field is unavailable when you elect to auto-generate credentials.
    • Password: Enter a password for the 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 web service. The default port is 8095.
  9. On the Create FTP Site page, enter the following information and then click Next:
    • External address: Enter the name of the server that customers will access to manage their hosted content. By default, the local server name is entered.
    • Binding IP: Enter the IP address through which the server receives incoming connections. By default, all IP addresses are included.
    • Use SSL: Select this option to secure FTP transmissions with SSL. Citrix strongly recommends this option if you are deploying the service in a production environment.
    • SSL Certificate: Specify the SSL certificate you want to use. This item is not available if you do not elect to use SSL.
    • Content file share: Specify the file share that customers will access to store hosted content. The default file share is C:CsmWebHosting.
  10. On the FTP User Isolation page, enter the following information and then click Next:
    • Auto-generate credentials: Leave this check box selected to allow the Configuration Tool to generate service account credentials automatically.
    • User name: Enter a user name for the web service account. The default user name is IISFTPUser. This field is unavailable when you elect to auto-generate credentials.
    • Password: Enter a password for the 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.
  11. 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 web service and displays progress.
  12. Click Finish and then click Exit to close the Configuration Tool.

To install the Windows Web Hosting web service through the command line

  1. On an IIS server in your environment, 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:WinWebHosting. The Setup Tool installs the web service and returns the command prompt.
  4. At the command prompt, enter install-locationServicesWinWebHostingWSConfigurationIISConfigConsole.exe and specify the following properties:
    Property Description
    /UserName:username Impersonation account for the Windows Web Hosting service. This parameter is optional if you are using /GenerateCredentials.
    /Password:password The application pool password. This parameter is optional if you are using /GenerateCredentials.
    /ServicePort:port Inbound port to be used and added to the CortexServices web site. Default = 8095
    /AutoCreateUser:True | False Optional. Create the service account in Active Directory.
    /GenerateCredentials:True | False Optional. Generate password for the service account.
    /FtpFileShare:file-path Optional. The location of the FTP file share. Default = %SystemDrive%WebHosting
    /FtpSiteIp:ip-address Optional. The site binding IP address. Default = * (all assigned)
    /FtpSiteName:site-name Optional. The name of the FTP site. Default = Services Mgr Web Hosting FTP
    /FtpSslCertThumbprint Optional. The thumbprint of the SSL certificate used to secure the FTP site.
    /FtpUseSsl:True | False Optional. Whether or not SSL is used for the FTP site.

    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 installation command string

The following command performs the initial configuration of the web service.
install-locationServicesCitrixWSConfigurationIISConfigConsole.exe /UserName:iis_svc_acct /Password:password /ServicePort:8095