[docs] update formatting on one click install

[barometer.git] / docs / release / configguide / postinstall.rst

diff --git a/docs/release/configguide/postinstall.rst b/docs/release/configguide/postinstall.rst
index 45a79ff..8f23eec 100644 (file)
--- a/docs/release/configguide/postinstall.rst
+++ b/docs/release/configguide/postinstall.rst
@@ -21,10 +21,34 @@ is controlled as described in the User Guide through their individual ``.conf``
 the ``/etc/collectd/collectd.conf.d/`` folder on the compute node(s).  In order for any changes to
 take effect, the collectd service must be stopped and then started again.
 
-Platform components validation
-------------------------------
+Platform components validation - Apex
+-------------------------------------
 The following steps describe how to perform a simple "manual" testing of the Barometer components:
 
+On the controller:
+
+1. Get a list of the available metrics:
+
+   .. code::
+
+      $ openstack metric list
+
+2. Take note of the ID of the metric of interest, and show the measures of this metric:
+
+   .. code::
+
+      $ openstack metric measures show <metric_id>
+
+3. Watch the measure list for updates to verify that metrics are being added:
+
+   .. code:: bash
+
+      $ watch –n2 –d openstack metric measures show <metric_id>
+
+More on testing and displaying metrics is shown below.
+
+On the compute:
+
 1. Connect to any compute node and ensure that the collectd service is running.  The log file
    ``collectd.log`` should contain no errors and should indicate that each plugin was successfully
    loaded.  For example, from the Jump Host:
@@ -98,3 +122,50 @@ The following steps describe how to perform a simple "manual" testing of the Bar
       | fbd06539-45dd-42c5-a991-5c5dbf679730 | event | gauge.memory_erros(overcloud-novacompute-0.jf.intel.com-mcelog)  | ok    | moderate | True    |
       | d73251a5-1c4e-4f16-bd3d-377dd1e8cdbe | event | gauge.mcelog_status(overcloud-novacompute-0.jf.intel.com-mcelog) | ok    | moderate | True    |
         [...]
+
+
+Barometer post installation verification for Compass4nfv
+--------------------------------------------------------
+
+For Fraser release, Compass4nfv integrated the ``barometer-collectd`` container of Barometer.
+As a result, on the compute node, collectd runs in a Docker container. On the controller node,
+Grafana and InfluxDB are installed and configured.
+
+The following steps describe how to perform simple "manual" testing of the Barometer components
+after successfully deploying a Barometer scenario using Compass4nfv:
+
+On the compute:
+
+1. Connect to any compute node and ensure that the collectd container is running.
+
+   .. code:: bash
+
+       root@host2:~# docker ps | grep collectd
+
+   You should see the container ``opnfv/barometer-collectd`` running.
+
+2. Testing using mce-inject is similar to testing done in Apex.
+
+On the controller:
+
+3. Connect to the controller and query the monitoring services. Make sure to log in to the lxc-utility
+container before using the OpenStack CLI. Please refer to this wiki for details:
+https://wiki.opnfv.org/display/compass4nfv/Containerized+Compass#ContainerizedCompass-HowtouseOpenStackCLI
+
+   .. code:: bash
+
+      root@host1-utility-container-d15da033:~# source ~/openrc
+      root@host1-utility-container-d15da033:~# gnocchi metric list
+      root@host1-utility-container-d15da033:~# aodh alarm list
+
+   The output for the gnocchi and aodh queries should be similar to the excerpts shown in the section above for Apex.
+
+4. Use a web browser to connect to Grafana at ``http://<serverip>:3000/``, using the hostname or
+IP of your Ubuntu server and port 3000. Log in with admin/admin. You will see ``collectd``
+InfluxDB database in the ``Data Sources``. Also, you will notice metrics coming in the several
+dashboards such as ``CPU Usage`` and ``Host Overview``.
+
+For more details on the Barometer containers, Grafana and InfluxDB, please refer to
+the following documentation links:
+https://wiki.opnfv.org/display/fastpath/Barometer+Containers#BarometerContainers-barometer-collectdcontainer
+:ref:`<barometer-docker-userguide>`