Skip to content

Commit 893e1fc

Browse files
committed
updating demo section
1 parent 1d15ad7 commit 893e1fc

File tree

5 files changed

+33
-165
lines changed

5 files changed

+33
-165
lines changed

content/patterns/medical-diagnosis/cluster-sizing.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Cluster Sizing
3-
weight: 20
3+
weight: 30
44
aliases: /medical-diagnosis/cluster-sizing/
55
---
66

content/patterns/medical-diagnosis/demo-script.adoc

Lines changed: 32 additions & 127 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Demo Script
3-
weight: 60
2+
title: Verifying the demo Medical diagnosis pattern
3+
weight: 20
44
aliases: /medical-diagnosis/demo/
55
---
66

@@ -19,152 +19,57 @@ image::../../images/medical-edge/aiml_pipeline.png[link="/images/medical-edge/ai
1919

2020
[NOTE]
2121
====
22-
We simulate the function of the remote medical facility with an application called `image-generator`
22+
We simulate the function of the remote medical facility with an application called the `image-generator`.
2323
====
24+
//Module to be included
25+
//:_content-type: PROCEDURE
26+
//:imagesdir: ../../../images
27+
[id="viewing-the-grafana-based-dashboard-getting-started"]
28+
== Enabling the Grafana based dashboard
2429

25-
[id="demo-objectives"]
30+
The Grafana dashboard is a visual representation of the AI/ML workflow. It provides the CPU and Memory metrics for the pod running the risk assessment application. The dashboard also provides visual representation of the AI/ML workflow from the images being generated at the remote medical facility. Carry out the following steps to view the dashboard:
2631

27-
== Objectives
32+
This showcase application is deployed using self-signed certificates that are untrusted by our browser. Unless you have provisioned valid certificates for your OpenShift cluster you must accept the invalid certificates for:
2833

29-
In this demo you will complete the following:
34+
. Accept the SSL certificates on the browser for the dashboard. In the {ocp} web console, go to the Routes for *All Projects*. Click the URL for the `s3-rgw`.
35+
+
36+
image::../../images/medical-edge/storage-route.png[s3-rgw route]
37+
+
38+
Ensure that you see some XML and not the access denied error message.
39+
+
40+
image::../../images/medical-edge/storage-rgw-route.png[link="/images/medical-edge/storage-rgw-route.png"]
3041

31-
* Prepare your local workstation
32-
* Update the pattern repo with your cluster values
33-
* Deploy the pattern
34-
* Access the dashboard
42+
. While still looking at Routes, change the project to `xraylab-1`. Click the URL for the `image-server`. Ensure that you do not see an access denied error message. You must to see a `Hello world` message.
3543

36-
[id="getting-started"]
44+
This showcase application does not have access to a x-ray machine hanging around that we can use for this demo, so one is emulated by creating an s3 bucket and hosting the x-ray images within it. In the "real world" an x-ray would be taken at an edge medical facility and then uploaded to an OpenShift Data Foundations (ODF) S3 compatible bucket in the Core Hospital, triggering the AI/ML workflow.
3745

38-
== Getting Started
46+
To emulate the edge medical facility we use an application called `image-generator` which (when scaled up) will download the x-rays from s3 and put them in an ODF s3 bucket in the cluster, triggering the AI/ML workflow.
3947

40-
* Follow the link:../getting-started[Getting Started Guide] to ensure that you have met all of the pre-requisites
41-
* Review link:../getting-started/#preparing-for-deployment[Preparing for Deployment] for updating the pattern with your cluster values
48+
Turn on the image file flow. There are couple of ways to go about this.
4249

43-
[NOTE]
44-
====
45-
This demo begins after `./pattern.sh make install` has been executed
46-
====
47-
48-
[id="demo"]
49-
50-
== Demo
51-
52-
Now that we have deployed the pattern onto our cluster, we can begin to discover what has changed, and then move onto the dashboard.
53-
54-
[id="admin-view"]
55-
56-
=== Administrator View - Review Changes to cluster
57-
58-
Login to your cluster's console with the `kubeadmin` user
59-
60-
Let's check out what operators were installed - In the accordion menu on the left:
61-
62-
* click Operators
63-
* click Installed Operators
64-
65-
[NOTE]
66-
67-
====
68-
Ensure that **All Projects** is selected
69-
====
70-
71-
image::../../images/medical-edge/admin_developer-contexts.png[link="/images/medical-edge/admin_developer-contexts.png"]
72-
73-
74-
If you started with a new cluster then there were no layered products or operators installed. With the Validated Patterns framework we describe or declare what our cluster's desired state is and the GitOps engine does the rest. This includes creating the instance of the operator and any additional configuration between other API's to ensure everything is working together nicely.
75-
76-
77-
[id="dev-view"]
78-
79-
=== Developer View - Review Changes to cluster
80-
81-
Let’s switch to the developer context by click on `Administrator` in the top left corner of the accordion menu then click `Developer`
82-
83-
* Change projects to `xraylab-1`
84-
* Click on `Topology`
85-
86-
87-
image::../../images/medical-edge/dev-topology.png[link="/images/medical-edge/dev-topology.png"]
88-
89-
Look at all of the resources that have been created for this demo application. What we see in this interface is the collection of all components required for this AI/ML workflow to properly execute. There are even more resources and configurations that get deployed but because we don't directly interact with them we won't worry too much about them. The take away here is when you utilize the framework you are able to build in automation just like this which allows your developers to focus on their important developer things.
90-
91-
92-
[id="certificate-warn"]
93-
94-
=== Invalid Certificates
95-
96-
We are deploying this demo using self-signed certificates that are untrusted by our browser. Unless you have provisioned valid certificates for your OpenShift cluster you must accept the invalid certificates for:
97-
98-
* image-server | xraylab-1 namespace
99-
* s3-rgw | openshift-storage namespace
100-
* grafana | xraylab-1 namespace
101-
102-
[source,shell]
103-
----
104-
IMAGESERVER_ROUTE=https://$(oc get route -n xraylab-1 image-server -o jsonpath='{.spec.host}')
105-
106-
echo $IMAGESERVER_ROUTE
107-
108-
S3RGW_ROUTE=https://$(oc get route -n openshift-storage s3-rgw -o jsonpath='{.spec.host}')
109-
110-
echo $S3RGW_ROUTE
111-
112-
GRAFANA_ROUTE=https://$(oc get route -n xraylab-1 grafana -o jsonpath='{.spec.host}')
113-
114-
echo $GRAFANA_ROUTE
115-
----
116-
117-
[WARNING]
118-
119-
====
120-
You must accept the security risks / self signed certificates before scaling the image-generator application
121-
====
122-
123-
[id="scale-up"]
124-
125-
=== Scale up the deployment
126-
127-
As we mentioned earlier, we don't have an x-ray machine hanging around that we can use for this demo, so we emulate one by creating an s3 bucket and hosting the x-ray images within it. In the "real world" an x-ray would be taken at an edge medical facility and then uploaded to an OpenShift Data Foundations (ODF) S3 compatible bucket in the Core Hospital, triggering the AI/ML workflow.
128-
129-
To emulate the edge medical facility we use an application called `image-generator` which (when scaled up) will download the x-rays from s3 and put them in an ODF s3 bucket in the cluster, triggering the AI/ML workflow.
130-
131-
Let's scale the `image-generator` deploymentConfig up to start the pipeline
132-
133-
[NOTE]
134-
====
135-
Make sure that you are in the `xraylab-1` project under the `Developer` context in the OpenShift Console
136-
====
137-
138-
In the Topology menu under the Developer context in the OpenShift Console:
50+
. Go to the {ocp} web console and change the view from *Administrator* to *Developer* and select *Topology*. From there select the `xraylab-1` project.
13951

140-
* Search for the `image-generator` application in the Topology console
52+
. Right-click on the `image-generator` pod icon and select `Edit Pod count`.
14153

142-
image::../../images/medical-edge/image-generator.png[link="/images/medical-edge/image-generator.png"]
54+
. Up the pod count from `0` to `1` and save.
14355

144-
* Click on the `image-generator` application ( you may have to zoom in on the highlighted application)
145-
* Switch to the `Details` menu in the application menu context
146-
* Click the `^` next to the pod donut
56+
Alternatively, you can have the same outcome on the Administrator console.
14757

148-
image::../../images/medical-edge/image-generator-scale.png[link="/images/medical-edge/image-generator-scale.png"]
58+
. Go to the {ocp} web console under *Workloads*, select *Deployments* for the *Project* `xraylab-1`.
14959

60+
. Click `image-generator` and increase the pod count to 1.
15061

15162
[id="demo-dashboard"]
15263

153-
== Demo Dashboard
64+
== Viewing the Grafana dashboard
15465

155-
Now let’s jump over to the dashboard
66+
Access the Grafana dashboard to view the AI/ML workflow. Carry out the following steps:
15667

157-
* Return to the topology screen
158-
* Select “Grafana” in the drop down for Filter by resource
159-
* Click the grafana icon
160-
* Open url to go open a browser for the grafana dashboard.
68+
. In the {ocp} web console, select the nines menu and right click the *Grafana* icon.
16169

162-
Within the grafana dashboard:
70+
. Within the grafana dashboard click the Dashboards icon.
16371

164-
* click the dashboards icon
165-
* click Manage
166-
* select xraylab-1
167-
* finally select the XRay Lab folder
72+
* Select the `xraylab-1` folder and the XRay Lab menu item.
16873

16974
image::../../images/medical-edge/dashboard.png[link="/images/medical-edge/dashboard.png"]
17075

content/patterns/medical-diagnosis/getting-started.adoc

Lines changed: 0 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -446,44 +446,7 @@ Examine the `medical-diagnosis-hub` ArgoCD instance. You can track all the appli
446446
. Check that all applications are synchronized. There are thirteen different ArgoCD `applications` that are deployed as part of this pattern.
447447

448448

449-
//Module to be included
450-
//:_content-type: PROCEDURE
451-
//:imagesdir: ../../../images
452-
[id="viewing-the-grafana-based-dashboard-getting-started"]
453-
== Viewing the Grafana based dashboard
454-
455-
. test. Accept the SSL certificates on the browser for the dashboard. In the {ocp} web console, go to the Routes for *All Projects*. Click the URL for the `s3-rgw`.
456-
+
457-
image::../../images/medical-edge/storage-route.png[s3-rgw route]
458-
+
459-
Ensure that you see some XML and not the access denied error message.
460-
+
461-
image::../../images/medical-edge/storage-rgw-route.png[link="/images/medical-edge/storage-rgw-route.png"]
462-
463-
. While still looking at Routes, change the project to `xraylab-1`. Click the URL for the `image-server`. Ensure that you do not see an access denied error message. You must to see a `Hello World` message.
464-
+
465-
image::../../images/medical-edge/grafana-routes.png[link="/images/medical-edge/grafana-routes.png"]
466449

467-
. Turn on the image file flow. There are couple of ways to go about this.
468-
+
469-
You can go to the {ocp} web console and change the view from *Administrator* to *Developer* and select *Topology*. From there select the `xraylab-1` project.
470-
+
471-
image::../../images/medical-edge/dev-topology.png[link="/images/medical-edge/dev-topology.png"]
472-
+
473-
Right-click on the `image-generator` pod icon and select `Edit Pod count`.
474-
+
475-
image::../../images/medical-edge/dev-topology-menu.png[link="/images/medical-edge/dev-topology-menu.png"]
476-
+
477-
Up the pod count from `0` to `1` and save.
478-
+
479-
image::../../images/medical-edge/dev-topology-pod-count.png[link="/images/medical-edge/dev-topology-pod-count.png"]
480-
+
481-
Alternatively, you can have the same outcome on the Administrator console.
482-
+
483-
Go to the OpenShift UI under Workloads, select *Deployments* for the *Project* `xraylab-1`.
484-
Click `image-generator` and increase the pod count to 1.
485-
+
486-
image::../../images/medical-edge/start-image-flow.png[link="/images/medical-edge/start-image-flow.png"]
487450

488451

489452
//Module to be included
-12.4 KB
Loading
-3.86 KB
Loading

0 commit comments

Comments
 (0)