Merge pull request #14218 from mburke5678/BZ-1691707

Update the EventRouter definition per BZ-1691707

Author: mburke5678

modules/efk-logging-about-eventrouter.adoc

@@ -5,7 +5,9 @@
 [id="efk-logging-about-eventrouter-{context}"]
 = About Event Router in {product-title}
 
-The Event Router forwards {product-title} events for Cluster Logging.
+The Event Router is a pod that forwards {product-title} events to cluster logging.
+You must manually deploy Event Router.
 
-In {product-title} all events are logged to `STDOUT`. The Event Router collects events and converts them into JSON format, where Fluentd and indexes the events to the `.operations` index when 
-the Event Router is deployed into an operations namespace, such as `openshift-*`. You must manually deploy Event Router.
+The Event Router collects events and converts them into JSON format, which takes 
+those events and pushes them to `STDOUT`. Fluentd indexes the events to the 
+`.operations` index. 

modules/efk-logging-eventrouter-deploy.adoc

@@ -11,7 +11,9 @@ The following Template object creates the Service Account, ClusterRole, and Clus
 
 .Prerequisite
 
-You need proper permissions to make updates within the `openshift-*` namespace.
+* Cluster logging and Elasticsearch must be installed.
+
+* You need proper permissions to make updates within the `openshift-*` namespace.
 
 .Procedure
 
@@ -31,7 +33,7 @@ objects:
     apiVersion: v1
     metadata:
       name: cluster-logging-eventrouter
-      namespace: cluster-logging
+      namespace: ${NAMESPACE}
   - kind: ClusterRole <2>
     apiVersion: v1
     metadata:
@@ -76,7 +78,7 @@ objects:
           component: eventrouter
           logging-infra: eventrouter
           provider: openshift
-      replicas: "1"
+      replicas: 1
       template:
         metadata:
           labels:
@@ -130,11 +132,30 @@ parameters:
 +
 ----
 $ oc process -f <templatefile> | oc apply -f -
+----
++
+For example:
++
+----
+$ oc process -f eventrouter.yaml | oc apply -f -
 
 serviceaccount/cluster-logging-eventrouter created
 clusterrole.authorization.openshift.io/event-reader created
 clusterrolebinding.authorization.openshift.io/event-reader-binding created
 configmap/cluster-logging-eventrouter created
 deployment.apps/cluster-logging-eventrouter created
+----
+
+. Validate that the Event Router installed:
++
+----
+$ oc get pods --selector  component=eventrouter -o name`
+
+pod/cluster-logging-eventrouter-d649f97c8-qvv8r
+----
++
+----
+$ oc logs cluster-logging-eventrouter-d649f97c8-qvv8r
 
+{"verb":"ADDED","event":{"metadata":{"name":"elasticsearch-operator.v0.0.1.158f402e25397146","namespace":"openshift-operators","selfLink":"/api/v1/namespaces/openshift-operators/events/elasticsearch-operator.v0.0.1.158f402e25397146","uid":"37b7ff11-4f1a-11e9-a7ad-0271b2ca69f0","resourceVersion":"523264","creationTimestamp":"2019-03-25T16:22:43Z"},"involvedObject":{"kind":"ClusterServiceVersion","namespace":"openshift-operators","name":"elasticsearch-operator.v0.0.1","uid":"27b2ca6d-4f1a-11e9-8fba-0ea949ad61f6","apiVersion":"operators.coreos.com/v1alpha1","resourceVersion":"523096"},"reason":"InstallSucceeded","message":"waiting for install components to report healthy","source":{"component":"operator-lifecycle-manager"},"firstTimestamp":"2019-03-25T16:22:43Z","lastTimestamp":"2019-03-25T16:22:43Z","count":1,"type":"Normal"}}
 ----