diff --git a/modules/ocp4/pages/sop_configure_openshift_container_storage.adoc b/modules/ocp4/pages/sop_configure_openshift_container_storage.adoc new file mode 100644 index 0000000..2178cdd --- /dev/null +++ b/modules/ocp4/pages/sop_configure_openshift_container_storage.adoc @@ -0,0 +1,29 @@ +== Configure the Openshift Container Storage Operator + + +=== Resources + +- [1] https://docs.openshift.com/container-platform/4.8/storage/persistent_storage/persistent-storage-ocs.html[Official Docs] +- [2] https://github.com/red-hat-storage/ocs-operator[Github] + +=== Installation +For full detailed instructions please refer to the official docs at: [1]. For general instructions see below: + +- In the webconsole, click the Operators menu +- Click the OperatorHub menu +- Search for `OpenShift Container Storage` +- Click install +- Choose the update channel to match the major.minor version of the cluster itself. +- Installation mode, A specified namespace on the cluster +- Installed namespace, Operator Recommended +- Update approval, automatic +- Click install + + +=== Configuration +When the operator is finished installing, we can continue, please ensure that a minimum of 3 nodes are available. + +- A `StorageCluster` is required to complete this installation, click the Create StorageCluster. +- + + diff --git a/modules/ocp4/pages/sop_configure_userworkload_monitoring_stack.adoc b/modules/ocp4/pages/sop_configure_userworkload_monitoring_stack.adoc new file mode 100644 index 0000000..3116300 --- /dev/null +++ b/modules/ocp4/pages/sop_configure_userworkload_monitoring_stack.adoc @@ -0,0 +1,40 @@ +== Enable User Workload Monitoring Stack + +=== Resources +- [1] https://docs.openshift.com/container-platform/4.8/monitoring/enabling-monitoring-for-user-defined-projects.html[Official Docs] +- [2] https://docs.openshift.com/container-platform/4.8/monitoring/enabling-monitoring-for-user-defined-projects.html#granting-users-permission-to-monitor-user-defined-projects_enabling-monitoring-for-user-defined-projects[Providing Access to the UWMS features] +- [3] https://docs.openshift.com/container-platform/4.8/monitoring/enabling-monitoring-for-user-defined-projects.html#granting-user-permissions-using-the-web-console_enabling-monitoring-for-user-defined-projects[Providing Access to the UWMS dashboard] + +=== Configuration +To enable the stack edit the `cluster-monitoring` ConfigMap like so: + +---- +oc -n openshift-monitoring edit configmap cluster-monitoring-config +---- + +Set the `enableUserWorkload` to `true` like so: + +---- +apiVersion: v1 +kind: ConfigMap +metadata: + name: cluster-monitoring-config + namespace: openshift-monitoring +data: + config.yaml: | + enableUserWorkload: true +---- + +Save the configmap changes. Monitor the rollout progress of the User Workload Monitoring Stack with the following: + +---- +oc -n openshift-user-workload-monitoring get pod +NAME READY STATUS RESTARTS AGE +prometheus-operator-6f7b748d5b-t7nbg 2/2 Running 0 3h +prometheus-user-workload-0 4/4 Running 1 3h +prometheus-user-workload-1 4/4 Running 1 3h +thanos-ruler-user-workload-0 3/3 Running 0 3h +thanos-ruler-user-workload-1 3/3 Running 0 3h +---- + +To provide access to users to create `PrometheusRule` and `ServiceMonitor` and `PodMonitor` objects see [2]. To allow access to the User Workload Monitoring Stack dashboard see [3]. diff --git a/modules/ocp4/pages/sops.adoc b/modules/ocp4/pages/sops.adoc index c82528b..0e74933 100644 --- a/modules/ocp4/pages/sops.adoc +++ b/modules/ocp4/pages/sops.adoc @@ -8,4 +8,5 @@ - xref:sop_configure_oauth_ipa.adoc[SOP Configure oauth Authentication via IPA/Noggin] - xref:sop_disable_provisioners_role.adoc[SOP Disable the Provisioners Role] - xref:sop_configure_local_storage_operator.adoc[SOP Configure the Local Storage Operator] - +- xref:sop_configure_openshift_container_storage.adoc[SOP Configure the Openshift Container Storage Operator] +- xref:sop_configure_userworkload_monitoring_stack.adoc[SOP Configure the Userworkload Monitoring Stack]