How to manage subscriptions in Openshift Container Platform 4.x

Solution In Progress - Updated -


  • OpenShift Container Platform 4.x


  • We're in the process of building a new Openshift 4.1 cluster on UPI, with vSphere. Our current subscriptions are bound to an Openshift 3.11 cluster that is not being used anymore. How do we update/migrate these subscriptions to Openshift 4.x?


  • With Openshift Container Platform 4.1, content distribution and over-the-air updates are tied to the OpenShift Cluster Manager (OCM). This was required as CoreOS tech was integrated into OpenShift/RHEL. We improved the evaluation, installation, upgrade, and management experience for OCP. As part of our content distribution system, the OpenShift Cluster Manager has to be subscription-aware to gate access.

  • Openshift Container Platform 4.1 clusters are registered into OpenShift Cluster Manager through outbound telemetry. Red Hat OpenShift Cluster Manager (OCM) provides the centralized set of services required for Red Hat to distribute, manage, and support OpenShift 4 as well as offerings that are built from, or run on top of, OpenShift Container Platform. OCM is provided as a free service on The public-facing management console is available at, with APIs available at

  • Openshift Container Platform 4.1 clusters register to OpenShift Cluster Manager through telemetry. A service runs on a 24-hour cron to register and update clusters from OpenShift Cluster Manager (OCM) in Red Hat Subscription Manager (RHSM).

* 1 cluster in OCM = 1 virtual machine in RHSM
  • When you view your cluster in OCM, you’ll see an alert that tells you if your cluster is under-subscribed with a link over to RHSM, where you can attach subscriptions to your cluster’s VM record. Subscriptions, therefore, are managed at the cluster level, rather than the host level

  • To know more about telemetry, please refer to the official documentation.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.