Product Documentation

Citrix Services

Jun 05, 2015

CloudPortal Services Manager Citrix Services deliver on-demand apps and hosted desktops from the cloud.

Prerequisites

  • Install CloudPortal Services Manager Citrix Web Service on a server in a Citrix XenApp farm.
  • Create and configure a new security group:
    • Create the security group "Cortex Service Computers" on the domain. You can create this group within the CortexSystem OU.
    • Add all XenApp controllers to the security group.
    • Assign the security group to any Services Manager root customer OUs and any existing customers created in the location.
    • Assign read permissions to the security group on the OU.
    • In the Advanced Security Settings for the OU, find the security group "Cortex Service Computers" and edit the permissions to apply to "this object and all descendant objects."
    • Restart all computers added to the security group.
  • Set up a file server to be used by the Citrix Service to create file shares with permissions, store profiles, and so on. You can use the same server for Citrix Services and File Sharing Services.

To configure Citrix Services

  1. Enable the service (top level): From the main menu, choose Configuration > System Manager > Service Deployment, expand Citrix, and click Save.
  2. Enable the service (location level): Under Service Filter, select Active Directory Location Services, choose a Location Filter if applicable, expand Citrix, and click Save.
  3. Verify credentials: From the main menu, choose Configuration > System Manager > Credentials and verify that the administrative impersonation account for the Citrix service exists. If it does not, create the account.
  4. Enable the server:
    1. From the main menu, choose Configuration > System Manager > Servers.
    2. If the XenApp server is not listed, click Refresh Server List.
    3. Expand the entry for the server and verify that Server Enabled is selected.
  5. Assign server roles:
    1. From the main menu, choose Configuration > System Manager > Server Roles and then expand the entry for the server.
    2. Under Server Connection Components, select Citrix App and then click Save.
  6. Add a server connection:
    1. From the main menu, choose Configuration > System Manager > Server Connections, click New Connection, and then select or type the following information for the web service.
      Server Role
      Choose Citrix App.
      Server
      Choose the XenApp server where the Services Manager Web Service is installed.
      Credentials
      Choose the credentials for the XenApp server.
      Protocol
      Defaults to http.
      Port
      Defaults to 8095. If you change the port here, change it also in the Services Manager Web Service.
      Timeout
      Defaults to 200000 milliseconds. If a large number of applications are published on the Citrix farm, set this value to -1 (unlimited).
    2. Click Save.
    3. From the main menu, choose Configuration > System Manager > Server Connections and click the icon in the Test column for the XenApp 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.
  7. Create a server collection: A server collection can be assigned to a customer before applications are installed on the servers.
    1. From the main menu, choose Configuration > System Manager > Server Collections.
    2. If the Location Filter appears, select the relevant location from the list.
    3. Click New Server Collection.
    4. Enter a Name for the collection, such as CitrixFarm01. You cannot change or delete a collection name after provisioning the server collection to a customer or after saving applications, application groups, or resources on the server collection.
    5. From the Service list, choose Citrix.
    6. In the Servers list, select each XenApp server to be managed under this server collection and then click Save.
  8. Update service properties as needed: From the main menu, choose Configuration > System Manager > Service Deployment, select Active Directory Location Services, choose a Location Filter if applicable, expand Citrix, and then click Service Settings.

To import applications from a XenApp farm to a server collection

  1. From the main menu, choose Services > Citrix > Configuration > Citrix Applications, choose a Location (if applicable), and choose a Server Collection.
  2. Change the New Application Settings as needed for the server collection.
    • Set new applications to 'default' for customer selection – Select this option to automatically select it for provisioning to customers and users. You can override this setting at the reseller level.
    • Make new applications public to all customers – Select this option to provision all new applications for public access.
    • Generate missing application groups – Select this option to automatically create a security group in Active Directory for applications. The application group name is in the form of CitrixApp {DatabaseID} or CitrixApp {Name}, based on the Application Group Name service setting.
  3. Click Refresh to start the import operation.
  4. If a timeout occurs during the import operation, change the Timeout value on the connection (Configuration > System Manager > Server Connections).
  5. Repeat steps 1 - 3 for each server collection.