doc: Updating the Installing OSM on Kubernetes section of the Manual Demo document
@@ -48,20 +48,40 @@ unzip osm.zip
The `osm` CLI can be compiled from source using [this guide](../../install/_index.md).
-## Install OSM Control Plane
-For the purpose of this demo, install OSM with [permissive traffic policy mode](#permissive-traffic-policy-mode) enabled via the `--enable-permissive-traffic-policy` flag. By default, OSM will install with permissive traffic policy mode disabled and [SMI Traffic Policy Mode](#smi-traffic-policy-mode) enabled. Also by default, `osm` CLI does not enable Prometheus, Grafana, and Jaeger as a part of control plane installation.
+## Installing OSM on Kubernetes
-Install OSM in permissive traffic policy mode with these features enabled:
+With the `osm` binary downloaded and unzipped, we are ready to install Open Service Mesh on a Kubernetes cluster:
+
+The command below shows how to install OSM on your Kubernetes cluster.
+This command enables
+[Prometheus](https://github.com/prometheus/prometheus),
+[Grafana](https://github.com/grafana/grafana), and
+[Jaeger](https://github.com/jaegertracing/jaeger) integrations.
+The `--enable-permissive-traffic-policy` options instructs OSM to ignore any policies and
+let traffic flow freely between the pods. With Permissive Traffic Policy mode enabled, new pods
+will be injected with Envoy, but traffic will flow through the proxy and will not be blocked.
+
+> Note: Permissive Traffic Policy mode is an important feature for brownfield deployments, where it may take some time to craft SMI policies. While operators design the SMI policies, existing services will to continue to operate as they have been before OSM was installed.
```bash
-osm install --enable-permissive-traffic-policy --deploy-prometheus --deploy-grafana --deploy-jaeger
+osm install \
+ --enable-permissive-traffic-policy \
+ --deploy-prometheus \
+ --deploy-grafana \
+ --deploy-jaeger
```
-See the [observability documentation](../../patterns/observability/_index.md) for more details about using Prometheus, Grafana, and Jaeger with OSM.
+> Note: This document assumes you have already installed credentials for a Kubernetes cluster in ~/.kube/config and `kubectl cluster-info` executes successfully.
+
+This installed OSM Controller in the `osm-system` namespace.
+
+
+Read more on OSM's integrations with Prometheus, Grafana, and Jaeger in the [observability documentation](../../patterns/observability/_index.md).
### OpenShift
-For details on how to install OSM on OpenShift, refer to the [installation guide](../#openshift)
+For details on how to install OSM on OpenShift, refer to the [installation guide](../_index.md#openshift)
+
## Deploy the Bookstore Demo Applications
