Configure OpenShift Container Platform cluster subscriptions

By default, your OpenShift Container Platform cluster automatically registers to the OpenShift Cluster Manager service after it is created. It is then subscribed to a limited 60-day Red Hat evaluation subscription for access to Red Hat support and updates.

Before you begin

  • You must have a Red Hat login.
  • You must have an OpenShift Container Platform cluster.
  • You must have a Red Hat Annual subscription or an OpenShift Container Platform On-Demand subscription enabled from the Red Hat Marketplace with resource limits configured.
    • Check your resource limits on the Subscriptions page in OpenShift Cluster Manager. If no resource limits display, enable On-Demand subscriptions in Red Hat Marketplace.
  • You must have the Cluster Owner or Cluster Editor role on the cluster, or Organization Administrator privileges in your Red Hat account.

About this task

To avoid downtime on your cluster, you must edit the cluster subscription settings in OpenShift Cluster Manager to use your own Red Hat subscription before your evaluation subscription expires.

You can use one of the following Red Hat subscription types to support your OpenShift Container Platform clusters:

  • Annual: A subscription that provides a fixed capacity of resources, pre-purchased from Red Hat.
  • On-Demand: This subscription that allows flexible usage and is billed through the Red Hat Marketplace. Your clusters must be connected to Telemetry in OpenShift Cluster Manager to use this subscription type.

    When you enable an On-Demand subscription in Red Hat Marketplace, you set resource limits for your services to control usage automatically.

You can view your active OpenShift Container Platform subscriptions from the Subscriptions area in OpenShift Cluster Manager.

Note

If you disabled Telemetry or your cluster cannot connect to api.openshift.com, you can alternatively complete the Red Hat registration process online at https://console.redhat.com/openshift/register. See Registering disconnected clusters for more information.

Procedure

  1. View an OpenShift Container Platform cluster in OpenShift Cluster Manager.
  2. Click Actions > Edit subscription settings. You can also access this from the Subscription settings section of the cluster Overview page.
  3. Select your Subscription type:
    • Annual to use your Red Hat fixed capacity subscription
    • On-Demand to use your Red Hat Marketplace flexible usage subscription
    Important

    If On-Demand is not available as an option, contact Red Hat Sales to enable an account and link your billing information in the Red Hat Marketplace. You can also verify whether On-Demand billing is enabled if Marketplace shows as Enabled in the Subscriptions area under OpenShift Container Platform.

    After setting your subscription type, you cannot change a cluster’s subscription type from On-Demand to an Annual subscription.
  4. If you selected Annual, select the options that apply to your Red Hat subscription in the dialog. See OpenShift Container Platform cluster subscription settings for more details about the available settings. If your cluster is disconnected, the subscription type is automatically set to Annual. For On-Demand, all other settings are pre-configured.
  5. Click Save settings.
    Note

    It might take up to two hours for these settings to update in the Subscriptions summary and Red Hat Subscription Management. This delay applies after you make changes to your Red Hat subscription in the Red Hat Customer Portal.

Results

View your cluster’s subscription status and usage in Subscriptions > Container Platform.