Manage OpenShift Dedicated cluster subscriptions

OpenShift Cluster Manager allows you to create OpenShift Dedicated clusters using your Red Hat subscriptions. These clusters are managed by Red Hat and come with Premium-level support. You must enter your subscription details when creating an OpenShift Dedicated cluster.

Before you begin
Copy link

  • You must have a Red Hat login.
  • You must have an active Red Hat OpenShift Dedicated subscription with sufficient quota to create a cluster. See https://www.openshift.com/products/dedicated/ for more information.
  • You must have the Cluster Owner or Cluster Editor role, or Organization Administrator privileges in your Red Hat account.

About this task
Copy link

You can use one of the following types of Red Hat subscriptions to create OpenShift Dedicated clusters:

  • Annual: A subscription providing a fixed capacity of resources, pre-purchased from Red Hat. Cluster provisioning is based on available quota. Quota is allocated from your Red Hat subscriptions and is required to scale up a cluster.
  • On-Demand: A subscription allowing flexible usage, billed through the Red Hat Marketplace. When you enable an On-Demand subscription in Red Hat Marketplace, you set resource limits for your services to control usage automatically.
  • OpenShift Dedicated trial: You can try OpenShift Dedicated for 60 days free of charge with a trial Red Hat subscription. You can upgrade your cluster to a paid Red Hat subscription at any time. See About the OpenShift Dedicated Trial for more details.

You can view your quota and resource limits, based on your active OpenShift Dedicated clusters, from the Subscriptions menu in OpenShift Cluster Manager.

Important

You must select the subscription type when creating the cluster. You cannot change the subscription type on an existing OpenShift Dedicated cluster, with the exception of upgrading a trial subscription. To create a new cluster, see Creating an OpenShift Dedicated cluster.

Procedure
Copy link

To view a summary of all subscriptions for OpenShift Dedicated purchased by your organization or granted by Red Hat, go to OpenShift Cluster Manager and click Subscriptions. The summary also shows how much of your quota and resource limits have been used by your OpenShift Dedicated clusters, broken down by subscription type.

Determine your cluster ID
Copy link

Every OpenShift cluster is assigned an ID (in the form of a UUID) when created, but each cluster also has an internal cluster identifier used by OpenShift Cluster Manager. The internal cluster identifier can be changed to a human-readable name displayed in OpenShift Cluster Manager if desired.

Before you begin
Copy link

  • A Red Hat login
  • A Red Hat OpenShift cluster

About this task
Copy link

You can find this information in OpenShift Cluster Manager, using the command line, or in the OpenShift web console.

Additionally, when OpenShift Container Platform clusters register to OpenShift Cluster Manager, the only identifying information might be the cluster UUID. If multiple OpenShift Container Platform clusters have been registered at the same time, it might be necessary to use the cluster UUID to tell them apart.

Procedure
Copy link

  • Your clusters are listed by ID in OpenShift Cluster Manager in the Clusters area. From here, you can search for a cluster by name or ID. You can also filter your search by cluster type: OpenShift Container Platform (OCP), OpenShift Dedicated (OSD), or Red Hat OpenShift Service on AWS (Red Hat OpenShift Service on AWS).
    Note

    To rename your cluster to a human-readable name, see Rename your cluster.
  • You can also get your OpenShift cluster ID by running the following command locally or on the cluster itself (after logging into the cluster using oc login): 
    $ oc get clusterversion <version> -o jsonpath='{.spec.clusterID}{"\n"}'
  • You can also find your OpenShift cluster ID in the OpenShift Container Platform web console if you are logged in as an administrator:
    • In the details pane on the Home/Dashboards page
    • On the Administration/Cluster Settings page Note

      You cannot log in to your Red Hat account with your email unless your email is your Red Hat login. For more information, see Finding your login.

Rename your cluster
Copy link

You can give your cluster a display name to use in place of its UUID, which makes the cluster easier to find in OpenShift Cluster Manager and to reference when you open a support case.

Before you begin
Copy link

  • A Red Hat login
  • A Red Hat OpenShift cluster
  • The Cluster Owner or Cluster Editor role on the cluster, or Organization Administrator privileges in your Red Hat account

About this task
Copy link

OpenShift Cluster Manager identifies each cluster by a 36-character UUID, which can be hard to search for or reference. A custom display name makes your cluster easier to locate and manage.

Procedure
Copy link

  1. On the Clusters page, click the name of the cluster you want to rename.
    The cluster Overview tab opens.
  2. From the Actions menu, select Edit display name.
  3. Enter a new name, and then click Edit.

Results
Copy link

The new name displays on the Cluster List tab.