DOCUMENTATION

From rPath Wiki

In rPath Appliance Platform Entitlement Service, an entitlement is a software access key that provides access to a product managed by the Entitlement Service appliance. Each product is a group of services on which appropriate permissions (access controls) are applied.

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

Contents 1 Entitlements 2 Generate Entitlements 3 Add Entitlements 4 Synchronize Entitlements

Entitlements

The table at the bottom of the Entitlements tab lists the entitlements for the currently selected product channel. A drop-down list of channels at the top of the tab can be used to select which channel's entitlements to view, and a search text box is provided to help locate entitlements by key or comment. Generate and add form fields and links on this tab provide the same functions as the Generate Entitlements and Add Entitlements tabs.

Use the links beside an entitlement in the list to Revoke an entitlement or to generate an ad hoc Report for that entitlement. The report is the list of troves to which that entitlement has access.

Generate Entitlements

Create new entitlements as needed for previously established product channels. The entitlement is a randomly generated string of a length specified in the initial Entitlement Service appliance configuration and when creating a product.

Go to the Generate Entitlements tab in rPath Entitlement Server --> Entitlements, and complete the fields with the following considerations:

• Select a product channel from the drop-down list to identify to which product the entitlements apply.
• Type the whole number of entitlements you need to generate for the product channel.

Verify the newly generated entitlements are listed on the Entitlements tab.

Add Entitlements

Add one or more entitlements as needed for upstream services. Go to the Add Entitlements tab in rPath Entitlement Server --> Entitlements, and complete the fields with the following considerations:

• The class to place new entitlements should match the product channel to which the entitlement services should apply.
• List each entitlement string by placing each new string on a new line in the text box. You may want to copy and paste this list from a text file provided by the upstream Entitlement Service appliance.
• If desired, type a space after each entitlement string, and type a comment on the same line to aid in identifying the entitlement with its recipient.

Synchronize Entitlements

Synchronization of entitlements will push out Services and Permissions, Products and Channels, as well as all entitlements to all mirrors. This is Synchronize Entitlements pushes out all entitlements to your mirrors. This ensures that if something is desynchronized it is resynchronized with the click of a button.

Use the synchronization function by logging into the rPath Appliance Platform Agent and performing the following actions:

• Select rPath Entitlement Server
• Select Synchronize from the submenu
• Click on the Sync button to perform the synchronization.
• Status of synchronization will be reported after the previous step

<< PREVIOUS: Products

NEXT: Logs and Reports >>