From e93798a04d73585db0107ed47a15780f88a5e91f Mon Sep 17 00:00:00 2001
From: stci <Stefan.Chiripuci@enea.com>
Date: Fri, 19 Feb 2021 13:15:05 +0200
Subject: Script for deploying containerized Grafana stack on the management
 side. Updated documentation.

Change-Id: I5a5fd25597fbd1cebd30136a34917a1d8bf59a56
---
 .../doc/grafana.xml                                |  47 ++++++++++++++++++++-
 .../doc/images/telemetry_settings.png              | Bin 28459 -> 28977 bytes
 .../doc/images/telemetry_start.png                 | Bin 13522 -> 14763 bytes
 3 files changed, 46 insertions(+), 1 deletion(-)

diff --git a/doc/book-enea-nfv-access-getting-started/doc/grafana.xml b/doc/book-enea-nfv-access-getting-started/doc/grafana.xml
index 5f5aaf2..33468f6 100644
--- a/doc/book-enea-nfv-access-getting-started/doc/grafana.xml
+++ b/doc/book-enea-nfv-access-getting-started/doc/grafana.xml
@@ -6,6 +6,51 @@
     server, while Grafana is a visualization tool for time series data. 
     Grafana is a very lightweight server-side application, and most of the 
     monitoring runs in a browser.</para>
+
+  <section id="grafana_deployment">
+    <title>Deploying Grafana and InfluxDB</title>
+    
+    <para>Grafana and InfluxDB can be deployed using images for Docker on linux. 
+      These images are provided by Enea along with a deploy script and 
+      predefined dashboards.</para>
+    
+    <para>Prerequisites for deploying an image:</para>
+    
+    <itemizedlist>
+      <listitem>
+        <para>CentOS 7 Linux.</para>
+      </listitem>
+      
+      <listitem>
+        <para>Docker for CentOS 7 installed on the machine and set to 
+          <literal>autostart</literal> as a service.</para>
+      </listitem>
+      
+      <listitem>
+        <para>Superuser rights on the CentOS 7 machine.</para>
+      </listitem>
+    </itemizedlist>
+    
+    <para>To deploy Grafana and InfluxDB run the provided 
+      <filename>grafana_deploy.sh</filename> script as a superuser and follow 
+      the instructions on screen.</para>
+    
+    <para>The Grafana and InfluxDB images can also be deployed on separate machines. 
+      The script will prompt the user to select which image to setup on the local 
+      machine.</para>
+    
+    <para>The deploy script loads the InfluxDB and Grafana images to Docker, 
+      sets up the collected username and password, and runs the associated 
+      containers. If there are already instances of the InfluxDB and Grafana images 
+      running on the server, the deploy script will prompt the user to replace them. 
+      The containers are setup to auto-start when the Docker service starts.</para>
+    
+    <note>
+       <para>Changing the collected username and password requires redeploying 
+         the InfluxDB image.</para>
+    </note>
+    
+  </section>
   
   <section id="grafana_settings">
     <title>Setting Grafana and InfluxDB parameters</title>
@@ -85,7 +130,7 @@
             <entry>The username used for encrypting communication between
             InfluxDB and the Telemetry server.</entry>
 
-            <entry>admin</entry>
+            <entry>admin0</entry>
           </row>
 
           <row>
diff --git a/doc/book-enea-nfv-access-getting-started/doc/images/telemetry_settings.png b/doc/book-enea-nfv-access-getting-started/doc/images/telemetry_settings.png
index 92c0b1f..276b716 100644
Binary files a/doc/book-enea-nfv-access-getting-started/doc/images/telemetry_settings.png and b/doc/book-enea-nfv-access-getting-started/doc/images/telemetry_settings.png differ
diff --git a/doc/book-enea-nfv-access-getting-started/doc/images/telemetry_start.png b/doc/book-enea-nfv-access-getting-started/doc/images/telemetry_start.png
index 36d3ff6..81510b5 100644
Binary files a/doc/book-enea-nfv-access-getting-started/doc/images/telemetry_start.png and b/doc/book-enea-nfv-access-getting-started/doc/images/telemetry_start.png differ
-- 
cgit v1.2.3-54-g00ecf