Product Documentation

Configure the Hosted Apps and Desktops service

Jun 05, 2015
Updated: 2014-03-20

Configure the Hosted Apps and Desktops service after you install it.

To import the service package, you must have the Service Schema Administrator security role. To configure the service, you must have the Service Provider Administrator security role.

If you intend to use the CloudPortal Services Manager API to access the service that is deployed with App Orchestration, ensure you have created the datacenter you want to use through the App Orchestration web management console before you configure the service. You can then specify the datacenter when you configure the service at the location level. This is required because the API cannot use the default datacenter registered in App Orchestration. For more information about this requirement, see Plan to deploy the Hosted Apps and Desktops service.

Important: If you have an earlier version of the Hosted Apps and Desktops service installed, you must remove it before importing the new version's service package. For instructions, see If you have an earlier version of the service installed.

To configure the Hosted Apps and Desktops service

  1. Import the service package into the control panel:
    1. From the Services Manager menu bar, click Configuration > System Manager > Service Schema.
    2. Under Services Management, click Import a service.
    3. On the Service Import page, click Browse and locate the Hosted Apps and Desktops.package file. Click Open.
    4. Click Preview. Services Manager displays the contents of the file for your review.
    5. Click Import at the bottom of the page. Services Manager imports the file and reports Import Complete.
  2. On the Services Manager provisioning server, either restart the CortexQueueMonitor service or restart the machine.
  3. In the control panel, enable the service at the top level:
    1. Under Service Filter, select Top Environment Services.
    2. From the Services Manager menu bar in the control panel, choose Configuration > System Manager > Service Deployment and then expand Hosted Apps and Desktops. Click Save
  4. Enable the service at the location level and, if applicable, specify the App Orchestration datacenter:
    1. Under Service Filter, select Active Directory Location Services and choose a Location Filter, if applicable.
    2. Expand Hosted Apps and Desktops, click Service Settings. and then expand App Orchestration.
    3. Select the App Orchestration Datacenter check box and click Reload to populate the setting's list with the datacenters that are registered in App Orchestration. From the list, select the datacenter you want to use with the Hosted Apps and Desktops service.
    4. Click Apply Changes and then click Save.
  5. Verify credentials:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Credentials.
    2. Create the administrative impersonation account for the Hosted Apps and Desktops service by clicking Add, and then entering a username, password, and domain (preferably in Fully Qualified Domain Name form).
      Note: When adding credentials, encryption is enabled by default. Citrix recommends encrypting credentials when Services Manager is deployed in a production environment. Use plain-text credentials only for debugging.
  6. Enable the server:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Servers.
    2. If the server on which you installed the service is not listed, click Refresh Server List.
    3. Expand the entry for the server and verify that Server Enabled is selected.
  7. Assign server roles:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Server Roles, and then expand the entry for the server.
    2. Under Server Connection Components, select Hosted Apps and Desktops, and then click Save.
  8. Add a server connection:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Server Connections, select a Location Filter if applicable, click New Connection, and then select or type the following information for the web service.
      Server Role
      Select or type Hosted Apps and Desktops.
      Server
      Select the server where the web service is installed.
      Credentials
      Select or type the credentials for the server.
      URL Base
      Select or type /CSMXenAppWS/v1 for XenApp, /CSMXenDesktopWS/v1 for XenDesktop, and /cam/api for the App Orchestration Configuration Tool.
      Protocol
      Select http for XenApp and XenDesktop, https for App Orchestration.
      Port
      Type 8095 for XenApp or XenDesktop, 443 (default) for App Orchestration.
      Timeout
      Defaults to 200000 milliseconds. If a large number of applications or desktops will be made available, set this value to -1 (unlimited).
      Version
      Select the installed service component: App Orchestration for the App Orchestration Configuration Tool, XenDesktop Direct for the XenDesktop web service, or XenApp Direct for the XenApp web service.
    2. Click Save.
    3. On the Server Connectionspage, click the icon in the Test column for the server. The icon turns green for a successful connection. A red icon indicates an unsuccessful connection. Mouse over it for information about the failed connection.

After you configure the service, configure offerings.