Transfer ownership of a connected cluster

You can transfer ownership of a connected OpenShift Container Platform cluster to another user in your organization or a different organization using OpenShift Cluster Manager.

Before you begin
Copy link

  • You must have a Red Hat login.
  • You must have an OpenShift Container Platform cluster.
  • You must be the Cluster Owner, or an Organization Administrator in the associated Red Hat account. See User access concepts in OpenShift Cluster Manager for more information.
Note

To create a new user to take over cluster ownership, see How to Create and Manage Users on the Red Hat Customer Portal.

About this task
Copy link

Note

This procedure outlines transferring connected clusters. To transfer a disconnected cluster, see Transfer ownership of a disconnected cluster.

To transfer a connected cluster to another owner, you must:

  1. Initiate the transfer in OpenShift Cluster Manager.
  2. Change the cluster pull secret to the new owner’s pull secret from the command line within five days of initiating the transfer.

Procedure
Copy link

  1. Log into OpenShift Cluster Manager as the current cluster owner.
  2. Initiate the transfer:
    1. Select the cluster that you want to transfer from the Clusters list.
    2. Click Actions > Transfer cluster ownership at the top of the cluster’s details page.
    3. Click Initiate transfer to confirm this action.
      Important
      1. You must change the cluster’s pull secret within five days of initiating the transfer and register the cluster with the new Red Hat account or the transfer is cancelled.
      2. You can cancel the ownership transfer anytime before the pull secret has been changed by clicking Actions > Cancel ownership transfer.

      You have now initiated the ownership transfer. The next step is to change the cluster’s pull secret to the pull secret of the new cluster owner. See Update the global pull secret when transferring cluster ownership.

Results
Copy link

Log into OpenShift Cluster Manager as the new owner of the cluster. You can verify the transfer was successful by checking these details in the cluster Overview:

  • In Details, the Owner has been updated.
  • In Cluster history, details of the transfer appear.

If the cluster was transferred to a different organization, you can log into that organization to verify the update. The cluster now appears in the target Red Hat account’s clusters list, and has been removed from the previous Red Hat account clusters list.

The transfer is complete when OpenShift Cluster Manager receives Telemetry data from the cluster with the new pull secret.

Initiate ownership transfer of a ROSA Classic cluster
Copy link

You can use OpenShift Cluster Manager to transfer ownership of a Red Hat OpenShift Service on AWS (ROSA) Classic cluster to another user in your organization or in a different Red Hat organization.

Before you begin
Copy link

  • A ROSA Classic cluster
  • The Cluster Owner role on the cluster, or Organization Administrator privileges in your Red Hat account
Note

To create a new user to take over cluster ownership, see How to Create and Manage Users on the Red Hat Customer Portal.

Procedure
Copy link

  1. On the Clusters page, from the overflow menu for the cluster you want to transfer, select Transfer cluster ownership.
  2. Enter the username of the new cluster owner, the account ID, and the organization ID, and then click Initiate transfer.
    The new owner receives an email request to approve the transfer. The request expires after 15 days.
  3. Optional: To view your transfer requests, click the Cluster Requests tab on the Clusters page.

    To cancel a transfer request, click Cancel next to it.

Accept ownership transfer of a ROSA Classic cluster
Copy link

A ROSA Classic cluster owner can initiate the transfer of a ROSA Classic cluster to you. After the transfer has been initiated, you must accept the transfer in OpenShift Cluster Manager to complete the transfer.

Before you begin
Copy link

  • You must have a Red Hat login.
  • You must have a ROSA Classic cluster.
  • You must be a ROSA Classic cluster owner, or an Organization Administrator in the associated Red Hat account. See User access concepts in OpenShift Cluster Manager for more information.

Procedure
Copy link

  1. Log in to OpenShift Cluster Manager.
    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.
  2. Select Cluster List from the left navigation panel and then click View cluster requests. The Transfer Ownership Request window opens.
  3. For the cluster that you want to transfer, click Accept/Decline. The Complete cluster transfer window opens.
  4. Click Approve Transfer. The transfer can take up to 24 hours to complete.

Results
Copy link

  • Verify that the cluster transfer was successful:
    • In Details, the Owner has been updated.
    • In Cluster history, details of the transfer display.
    • If the cluster was transferred to a different organization, log in to that organization to verify the update. The cluster now appears in the target Red Hat account clusters list, and has been removed from the previous Red Hat account clusters list.