Product Documentation

Configure the Citrix service

Jun 05, 2015
Updated: 2013-04-18
Before configuring the Citrix service, review the following topics and ensure all requirements have been met:

To configure the Citrix service

  1. Enable the service (top level):
    1. From the Services Manager menu bar, choose Configuration > System Manager > Service Deployment.
    2. Expand Citrix and then click Save.
  2. Enable the service (location level):
    1. Under Service Filter, select Active Directory Location Services and choose a Location Filter, if applicable.
    2. Expand Citrix and then click Save.
  3. Verify credentials:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Credentials.
    2. Verify that the administrative impersonation account for the Citrix service exists. If it does not, create the account.
      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 purposes.
  4. Enable the server:
    1. From the Services Manager menu bar, 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 Services Manager menu bar, 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 Services Manager menu bar, 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 Services Manager menu bar, 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 Services Manager menu bar, 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.