Manifests

Manifests facilitate a means to easily transfer subscriptions from a hosted candlepin server to an on-premis, or stand-alone instance. A distributor consumer’s entitlements can be exported into a manifest file which can then be imported into an on-premis candlepin resulting in subscriptions that can then be used by on-premis consumers (systems).

Basic Workflow

  1. User creates a distributor on the hosted candlepin server and attaches entitlements to it.
  2. User exports the distributor.
  3. User downloads the manifest file.
  4. User uploads the manifest file to an on-premis candlepin server where it is imported and results in available subscriptions.

Deprecated APIs

In Candlepin versions prior to 2.1, the import/export APIs were synchronous and have since been made asynchronous. In version 2.1 and beyond, the asynchronous APIs should be used exclusively. While the old APIs remain functional, clients should be updated to use the new version. Newer import/export functionality will not be supported in the deprecated APIs going forward.

To learn about the the updated APIs, see:

  1. Exporting A Manifest
  2. Importing A Manifest

The deprecated APIs are:

  1. Export GET /consumers/:uuid/export
  2. Import POST /owners/:key/imports
Last modified on 1 March 2024