Personal tools
     DOCUMENTATION

rPath Appliance Platform/Entitlement Service:Services

From rPath Wiki

Jump to: navigation, search

Contents

In rPath Appliance Platform Entitlement Service a service defines resources provided by rPath Appliance Platform Update Service Update Service appliance or another Entitlement Service appliance. Entitlements are assigned to allow product updates to access the necessary resources defined by those services.

Access the Services page of the Entitlement Service appliance by expanding the rPath Entitlement Server menu in the rPath Appliance Platform Agent web interface and clicking Services. Use the tabs as described in the following sections.

Providers

Enlarge
Add providers on one of the appliances to represent an upstream Entitlement Service appliance configured to provide access to particular resources. Go to Providers tab in rPath Entitlement Server --> Services, and select to Add a provider. Complete the fields with the resource type as rPath Entitlement Server and the information provided by the upstream entitlement service (see the graphic at the right).

Associate the provider with services by clicking the Services tab, selecting the new provider in the Provider drop-down list, and completing the remaining fields with information provided by the upstream entitlement service.

Image:Bulbgraph.png   To become an upstream entitlement service provider for downstream Entitlement Service appliances, such as for resellers of your product, see instructions provided in Products.

Services

Each service pushes entitlements to one or more the Update Services through a service provider, which consists of a list of related Update Service appliances. The Update Service administrators should provide an administrative entitlement and other information needed to configure the Entitlement Service to provide the appropriate Update Service access.

Go to Providers tab in rPath Entitlement Server --> Services, and select to Add a provider. Complete the fields with the resource type as rPath Update Service and the information provided by the upstream entitlement service. Note the following about some of the fields:

  • Entitlement key -- should be the administrative entitlement for the Update Service appliance
  • Host -- in the case of multiple Update Service appliances, separate each hostname with a comma
  • Managed channel -- leave this blank for Update Service providers

Click add and verify the list displays the new provider. Associate the provider with services by clicking the Services tab, selecting the new provider in the Provider drop-down list, and completing the remaining fields with information appropriate to the Update Service. rPath suggests choosing a name based on the software to which the service provides access. If the Can Mirror drop-down appears, it may be left at the default setting No.

Additional new services may be listed after you have created your service, each in a disabled state (which you cannot modify). These services represent all the preexisting access groups on the Update Service appliance. Also, each new service that is added on the Entitlement Service appliance becomes an access group on the Update Service appliance.

Modify the access permissions associated with the new service using the Access Controls tab.

Access Controls

Enlarge
Access controls on services identify objects (troves) in an Update Service repository and what access the service should have on those objects.

Go to Access Control tab in rPath Entitlement Server --> Services, and select to Add another permission. Complete the form with the following considerations:

  • Services Affected -- hold down the control (Ctrl) key to select two or more services from the list
  • Trove -- use the trove name in the Update Service repository to which this permission applies, using regular expressions to identify multiple troves with the same strings in the trove name (such as .*:runtime); type ALL instead of the trove name if this should apply to all troves
  • Label -- An exact label that the permission applies to, or ALL to apply to all labels
  • Advanced -- rPath recommends leaving the default permissions of read-only, which is sufficient to provide Conary updates; do not add other permissions unless you are certain this is absolutely necessary

Use the Edit and Delete options for each list item to modify or delete access controls.


<< PREVIOUS: Concepts NEXT: Products >>