Upgrading OpenShift AI Cloud Service

Procedure

1. Log in to the OpenShift cluster web console as a cluster administrator.
2. In the Administrator perspective, in the left menu, select Operators → Installed Operators.
3. Click the Red Hat OpenShift AI Operator.
4. Click the Subscription tab.

5. Under Update approval, click the pencil icon and select one of the following update strategies:

   • Automatic: New updates are installed as soon as they become available.
   • Manual: A cluster administrator must approve any new update before installation begins.
6. Click Save.

1. Log in to the OpenShift Console.
2. In the Administrator perspective, click Administration → CustomResourceDefinitions.
3. In the search field, enter multik.

4. Update the MultiKueueCluster CRD as follows:

   1. Click the CRD name, and click the YAML tab.

   2. Ensure that the metadata:labels section includes the following entry:

      Copy to Clipboard Toggle word wrap

      app.opendatahub.io/kueue: 'true'

   3. Click Save.
5. Repeat the above steps to update the MultiKueueConfig CRD.

6. Remove the MultiKueueCluster and MultiKueueConfig CRDs, by completing the following steps for each CRD:

   1. Click the Actions menu.
   2. Click Delete CustomResourceDefinition.
   3. Click Delete to confirm the deletion.

Procedure

1. Log in to the OpenShift web console as a cluster administrator.
2. In the web console, click Operators → Installed Operators and then click the Red Hat OpenShift AI Operator.
3. Click the Data Science Cluster tab.
4. On the DataScienceClusters page, click the default object.

5. Click the YAML tab.

   An embedded YAML editor opens showing the default custom resource (CR) for the DataScienceCluster object, similar to the following example:

   Copy to Clipboard Toggle word wrap

   apiVersion: datasciencecluster.opendatahub.io/v1
   kind: DataScienceCluster
   metadata:
     name: default-dsc
   spec:
     components:
       codeflare:
         managementState: Removed
       dashboard:
         managementState: Removed
       datasciencepipelines:
         managementState: Removed
       kserve:
         managementState: Removed
       kueue:
         managementState: Removed
       modelmeshserving:
         managementState: Removed
       ray:
         managementState: Removed
       trainingoperator:
         managementState: Removed
       trustyai:
         managementState: Removed
       workbenches:
         managementState: Removed

6. In the spec.components section of the CR, for each OpenShift AI component shown, set the value of the managementState field to either Managed or Removed. These values are defined as follows:

   Managed

   The Operator actively manages the component, installs it, and tries to keep it active. The Operator will upgrade the component only if it is safe to do so.

   Removed

   The Operator actively manages the component but does not install it. If the component is already installed, the Operator will try to remove it.

   Important
   • To learn how to install the KServe component, which is used by the single-model serving platform to serve large models, see Installing the single-model serving platform.
   • If you have not enabled the KServe component (that is, you set the value of the managementState field to Removed), you must also disable the dependent Service Mesh component to avoid errors. See Disabling KServe dependencies.
   • To learn how to install the distributed workloads feature, see Installing the distributed workloads components.

7. Click Save.

   For any components that you updated, OpenShift AI initiates a rollout that affects all pods to use the updated image.

8. If you are upgrading from OpenShift AI 2.19 or earlier, upgrade the Authorino Operator to the stable update channel, version 1.2.1 or later.

   1. Update Authorino to the latest available release in the tech-preview-v1 channel (1.1.2), if you have not done so already.

   2. Switch to the stable channel:

      1. Navigate to the Subscription settings of the Authorino Operator.
      2. Under Update channel, click on the highlighted tech-preview-v1.
      3. Change the channel to stable.
   3. Select the update option for Authorino 1.2.1.