How to migrate from a separately installed CodeFlare Operator in your data science cluster

Solution Verified - Updated

Environment

  • Red Hat OpenShift Data Science
    • Version: 2.4
  • Red Hat OpenShift AI
    • Version: 2.5 or later

Starting from version 2.5, Red Hat OpenShift Data Science is renamed to Red Hat OpenShift AI. For more details, see the 2.5 Release Notes.

Issue

  • Cannot use a separately installed instance of the CodeFlare Operator in Red Hat OpenShift Data Science 2.4 or later

In Red Hat OpenShift Data Science 2.4 or later, the CodeFlare Operator is included in the base product and not in a separate Operator. Separately installed instances of the CodeFlare Operator from Red Hat or the community are not supported.

Resolution

Summary

This workaround involves the following steps:

  1. Uninstall any installed CodeFlare Operators.
  2. Remove unnecessary resources.
  3. Install Red Hat OpenShift Data Science 2.4 or later.
  4. Enable the Data Science Cluster.

Procedure

  1. Uninstall any installed CodeFlare Operators, as follows:
    (a) Log in to the OpenShift Container Platform cluster web console as a cluster administrator.
    (b) Click Operators > Installed Operators.
    (c) Search for CodeFlare Operator.
    (d) If any CodeFlare Operator is installed, either the Community CodeFlare Operator or the Red Hat CodeFlare Operator, uninstall it: select the Operator, and from the actions menu, click Uninstall Operator.

  2. In a terminal window, remove any resources from the previous installation that are no longer needed, as follows:

    oc delete crd instascales.codeflare.codeflare.dev mcads.codeflare.codeflare.dev quotasubtrees.ibm.com appwrappers.mcad.ibm.com schedulingspecs.mcad.ibm.com
    
  3. Install Red Hat OpenShift Data Science 2.4 or later, as described in the relevant installation guide.

  4. Enable the Data Science Cluster, as follows:
    (a) In the OpenShift Container Platform cluster web console, click Home > Search.
    (b) From the Resources list, select the DataScienceCluster Custom Resource Definition (CRD).
    (c) Click the default instance name to open the instance details page.
    Starting from Red Hat OpenShift Data Science 2.4, the default instance name for new installations is default-dsc. The default instance name for earlier installations, rhods, is preserved during upgrade.
    (d) Click the YAML tab to show the instance specifications.
    (e) Enable the codeflare component by setting the managementState field to Managed.
    (f) Click Save.

For more information about Red Hat OpenShift AI, see the product documentation.
For more information about Red Hat OpenShift Data Science 2.4, see the This content is not included.2.4 product 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.