Skip to content

Commit

Permalink
added classroom instructions for partners (#33)
Browse files Browse the repository at this point in the history
* added classroom instructions for partners

* fixed broken xref in upgrade section

* updated control plane and worker node count and capacity

* expanded details for filling out RHDP form
  • Loading branch information
rsriniva authored Jan 9, 2024
1 parent 1b32e74 commit d5c50f3
Show file tree
Hide file tree
Showing 2 changed files with 42 additions and 7 deletions.
45 changes: 41 additions & 4 deletions modules/ROOT/pages/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -23,18 +23,26 @@ The PTL team acknowledges the valuable contributions of the following Red Hat as
* John Hurlocker
* Ravi Srinivasan

== Classroom Environment
== Classroom Environment for Red Hat Associates

Red Hat associates should use the Red Hat Demo Platform to provision a classroom.

Use the https://demo.redhat.com/catalog?search=Red+Hat+OpenShift+Container+Platform+4.13+Workshop&item=babylon-catalog-prod%2Fopenshift-cnv.ocp413-wksp-cnv.prod[Red Hat OpenShift Container Platform 4.13 Workshop] catalog item from Red Hat Demo Platform (RHDP).

When ordering this demo item:

* Select at least two users in the `User Count` field.
Having two users is required for the user management exercise.
* Select `Practice/Enablement` for the `Activity` field, and `Learning about the product` for the `Purpose`.

* Leave the `Salesforce ID` blank.

* Select *5* users in the `User Count` field.
Having at least two users is required for the user management exercise.

* In the `OpenShift worker memory size` field, select `64Gi`.
This size might be required if you run multiple workbenches and pipelines simultaneously.

* Review the auto-stop and auto-destroy timers. You can change this later after classroom provisioning by opening a ticket with the RHDP team.

[IMPORTANT]
====
RHOAI workbenches and pipelines use large container images.
Expand All @@ -47,14 +55,23 @@ Make sure that your worker nodes have enough memory to accommodate pods that con
This classroom does *NOT* have RHOAI pre-installed.
You install and configure a basic RHOAI instance, and then continue using this instance with other courses in the learning path.

=== Alternative classroom environment on AWS
=== Alternative classroom environment on AWS for Red Hat Associates

You can also use an AWS cluster by ordering the https://demo.redhat.com/catalog?search=AWS+with+OpenShift+Open+Environment&item=babylon-catalog-prod%2Fsandboxes-gpte.sandbox-ocp.prod[AWS with OpenShift Open Environment].

This classroom does *NOT* have RHOAI pre-installed.
You install and configure a basic RHOAI instance, and then continue using this instance with other courses in the learning path.

If you use this item, you must:

* Select `Practice/Enablement` for the `Activity` field, and `Learning about the product` for the `Purpose`.

* Leave the `Salesforce ID` blank.

* Make sure that you select `3` as the control plane count and `4.13` as the OpenShift version.

* Review the auto-stop and auto-destroy timers. You can change this later after classroom provisioning by opening a ticket with the RHDP team.

* Configure users and authentication.
The AWS item is only preconfigured with the `kubeadmin` user, which does not have the `cluster-admin` role assigned.
The exercises in this course, however, assume the existence of an `admin` user with the `cluster-admin` role and five non-admin users (`user1...user5`).
Expand All @@ -70,6 +87,26 @@ $ *oc replace -f authentication.yaml*
The password for the `admin` and `user1...user5` users is `openshift23`.
====

== Classroom Environment for Red Hat Partners

Red Hat partners should provision their own Red Hat OpenShift cluster using the Red Hat Hybrid Cloud Console at https://console.redhat.com/openshift/overview.

* Ensure that you provision an OpenShift 4.13 cluster with a minimum of 3 control plane nodes (each with 4vCPU and 16GB RAM), and 3 worker nodes (each with 8 vCPU, and 64GB of RAM).

* Configure users and authentication.
The exercises in this course assume the existence of an `admin` user with the `cluster-admin` role and five non-admin users (`user1...user5`). You need to create an *admin* user along with the users *user1...user5*.
To configure authentication for these users, use the sample xref:attachment$authentication.yaml[authentication.yaml] file and customize it for your environment.
+
[subs=+quotes]
----
$ *oc replace -f authentication.yaml*
----

[INFO]
====
The password for the `admin` and `user1...user5` should be `openshift23`.
====

== Prerequisites

* Basic knowledge of OpenShift (or Kubernetes) administration
Expand Down
4 changes: 1 addition & 3 deletions modules/chapter1/pages/upgrading-rhods.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,10 @@ install-w6lqv rhods-operator.2.1.0 Manual true <2>
<2> *Installplan* for the currently installed version. It's been approved and the version is currently installed.


Installplan is approved either automatically when a new version is available without user's intervention or requires a manual approval. Whether the approval is automatic or manual depends on the value of the xref:rhods-install-cli.adoc#subscription[installPlanApproval] attribute of the operator's subscription. When it is set to _Automatic_ the *installplan* is approved automaticaly and installation starts without user's intervention. _Manual_ value requires a manual approval.
Installplan is approved either automatically when a new version is available without user's intervention or requires a manual approval. Whether the approval is automatic or manual depends on the value of the *installPlanApproval* attribute of the operator's subscription. When it is set to _Automatic_ the *installplan* is approved automaticaly and installation starts without user's intervention. _Manual_ value requires a manual approval.

Approvals can be set from the web console as well as from the CLI.

Manual approvals done from the CLI are discussed in the xref:rhods-install-cli.adoc#manual_approval[Approving Installation Manualy] section and are exactly the same as for the installation.

The following demonstration shows an upgrade with a manual approval done from the web console.

== Demo: Upgrading Red{nbsp}Hat OpenShift AI
Expand Down

0 comments on commit d5c50f3

Please sign in to comment.