Add instructions for RHOAI 2.17; drop RHOAI 2.15

Author: dgrove-oss

SETUP.md

@@ -10,8 +10,9 @@ defines a `mlbatch-edit` role which enforces these restrictions and
 will be used in the setup process for each team of MLBatch users that
 is onboarded.
 
-This setup has been developed on Red Hat OpenShift 4.14 and Kubernetes 1.27 and
-is intended to support Red Hat OpenShift 4.14 and up and/or Kubernetes 1.27 and up.
+This setup has been developed on Red Hat OpenShift 4.14, Red Hat OpenShift 4.16,
+and Kubernetes 1.29 and is intended to support Red Hat OpenShift 4.14 and up
+and/or Kubernetes 1.29 and up.
 
 To start with, recursively clone and enter this repository:
 ```sh
@@ -35,7 +36,7 @@ Instructions are provided for the following Red Hat OpenShift AI ***stable*** re
    + [RHOAI 2.16 Team Setup](./setup.RHOAI-v2.16/TEAM-SETUP.md)
    + [UPGRADING from RHOAI 2.13](./setup.RHOAI-v2.16/UPGRADE-STABLE.md)
    + [UPGRADING from RHOAI 2.15](./setup.RHOAI-v2.16/UPGRADE-FAST.md)
-   + [RHOAI 2.16 Uninstall](./setup.RHOAI-v2.15/UNINSTALL.md)
+   + [RHOAI 2.16 Uninstall](./setup.RHOAI-v2.16/UNINSTALL.md)
 + Red Hat OpenShift AI 2.13
    + [RHOAI 2.13 Cluster Setup](./setup.RHOAI-v2.13/CLUSTER-SETUP.md)
    + [RHOAI 2.13 Team Setup](./setup.RHOAI-v2.13/TEAM-SETUP.md)
@@ -44,11 +45,11 @@ Instructions are provided for the following Red Hat OpenShift AI ***stable*** re
    + [RHOAI 2.13 Uninstall](./setup.RHOAI-v2.13/UNINSTALL.md)
 
 Instructions are provided for the following Red Hat OpenShift AI ***fast*** releases:
-+ Red Hat OpenShift AI 2.15
-   + [RHOAI 2.15 Cluster Setup](./setup.RHOAI-v2.15/CLUSTER-SETUP.md)
-   + [RHOAI 2.15 Team Setup](./setup.RHOAI-v2.15/TEAM-SETUP.md)
-   + [UPGRADING from RHOAI 2.14](./setup.RHOAI-v2.15/UPGRADE.md)
-   + [RHOAI 2.15 Uninstall](./setup.RHOAI-v2.15/UNINSTALL.md)
++ Red Hat OpenShift AI 2.17
+   + [RHOAI 2.17 Cluster Setup](./setup.RHOAI-v2.17/CLUSTER-SETUP.md)
+   + [RHOAI 2.17 Team Setup](./setup.RHOAI-v2.17/TEAM-SETUP.md)
+   + [UPGRADING from RHOAI 2.16](./setup.RHOAI-v2.17/UPGRADE.md)
+   + [RHOAI 2.17 Uninstall](./setup.RHOAI-v2.17/UNINSTALL.md)
 
 ## Kubernetes
 

setup.RHOAI-v2.15/CLUSTER-SETUP.md renamed to setup.RHOAI-v2.17/CLUSTER-SETUP.md

@@ -7,7 +7,7 @@ cluster roles, and priority classes.
 
 Create `default-priority`, `high-priority`, and `low-priority` priority classes:
 ```sh
-oc apply -f setup.RHOAI-v2.15/mlbatch-priorities.yaml
+oc apply -f setup.RHOAI-v2.17/mlbatch-priorities.yaml
 ```
 
 ## Coscheduler
@@ -20,15 +20,15 @@ helm install scheduler-plugins --namespace scheduler-plugins --create-namespace
 ```
 Patch Coscheduler pod priorities:
 ```sh
-oc patch deployment -n scheduler-plugins --type=json --patch-file setup.RHOAI-v2.15/coscheduler-priority-patch.yaml scheduler-plugins-controller
-oc patch deployment -n scheduler-plugins --type=json --patch-file setup.RHOAI-v2.15/coscheduler-priority-patch.yaml scheduler-plugins-scheduler
+oc patch deployment -n scheduler-plugins --type=json --patch-file setup.RHOAI-v2.17/coscheduler-priority-patch.yaml scheduler-plugins-controller
+oc patch deployment -n scheduler-plugins --type=json --patch-file setup.RHOAI-v2.17/coscheduler-priority-patch.yaml scheduler-plugins-scheduler
 ```
 
 ## Red Hat OpenShift AI
 
 Create the Red Hat OpenShift AI subscription:
 ```sh
-oc apply -f setup.RHOAI-v2.15/mlbatch-subscription.yaml
+oc apply -f setup.RHOAI-v2.17/mlbatch-subscription.yaml
 ````
 Identify install plan:
 ```sh
@@ -45,11 +45,11 @@ oc patch ip -n redhat-ods-operator --type merge --patch '{"spec":{"approved":tru
 ```
 Create DSC Initialization:
 ```sh
-oc apply -f setup.RHOAI-v2.15/mlbatch-dsci.yaml
+oc apply -f setup.RHOAI-v2.17/mlbatch-dsci.yaml
 ```
 Create Data Science Cluster:
 ```sh
-oc apply -f setup.RHOAI-v2.15/mlbatch-dsc.yaml
+oc apply -f setup.RHOAI-v2.17/mlbatch-dsc.yaml
 ```
 The provided DSCI and DSC are intended to install a minimal set of Red Hat OpenShift
 AI managed components: `codeflare`, `kueue`, `ray`, and `trainingoperator`. The
@@ -64,6 +64,7 @@ AI configuration as follows:
   - `batch/job` integration is disabled,
   - `waitForPodsReady` is disabled,
   - `LendingLimit` feature gate is enabled,
+  - `fairSharing` is enabled,
   - `enableClusterQueueResources` metrics is enabled,
 - Codeflare operator:
   - the AppWrapper controller is enabled and configured as follows:
@@ -79,14 +80,14 @@ AI configuration as follows:
 
 Create Kueue's default flavor:
 ```sh
-oc apply -f setup.RHOAI-v2.15/default-flavor.yaml
+oc apply -f setup.RHOAI-v2.17/default-flavor.yaml
 ```
 
 ## Cluster Role
 
 Create `mlbatch-edit` role:
 ```sh
-oc apply -f setup.RHOAI-v2.15/mlbatch-edit-role.yaml
+oc apply -f setup.RHOAI-v2.17/mlbatch-edit-role.yaml
 ```
 
 ## Slack Cluster Queue

setup.RHOAI-v2.15/TEAM-SETUP.md renamed to setup.RHOAI-v2.17/TEAM-SETUP.md

@@ -1,11 +1,11 @@
-# Upgrading from RHOAI 2.14
+# Upgrading from RHOAI 2.16
 
-These instructions assume you installed and configured RHOAI 2.14 following
-the MLBatch [install instructions for RHOAI-v2.14](../setup.RHOAI-v2.14/CLUSTER-SETUP.md)
-and are subscribed to the fast channel.
+These instructions assume you installed and configured RHOAI 2.16 following
+the MLBatch [install instructions for RHOAI-v2.16](../setup.RHOAI-v2.16/CLUSTER-SETUP.md)
+or the [fast stream upgrade instructions for RHOAI-V2.16](../setup.RHOAI-v2.16/UPGRADE-FAST.md)
 
 Your subscription will have automatically created an unapproved
-install plan to upgrade to RHOAI 2.15.
+install plan to upgrade to RHOAI 2.17.
 
 Before beginning, verify that the expected install plan exists:
 ```sh
@@ -14,12 +14,17 @@ oc get ip -n redhat-ods-operator
 Typical output would be:
 ```sh
 NAME            CSV                     APPROVAL   APPROVED
-install-kpzzl   rhods-operator.2.15.0   Manual     false
-install-nqrbp   rhods-operator.2.14.0   Manual     true
+install-kpzzl   rhods-operator.2.17.0   Manual     false
+install-nqrbp   rhods-operator.2.16.0   Manual     true
 ```
 
 Assuming the install plan exists you can begin the upgrade process.
 
+First, update the MLBatch modifications to the default RHOAI configuration maps.
+```sh
+oc apply -f setup.RHOAI-v2.17/mlbatch-upgrade-configmaps.yaml
+```
+
 There are no MLBatch modifications to the default RHOAI configuration maps
 beyond those already made in previous installs. Therefore, you can simply
 approve the install plan replacing the example plan name below with the actual