X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=blobdiff_plain;f=docs%2Frelease%2Fconfigguide%2Fpostinstall.rst;h=8f23eec35a858a00a9b962662df6d3eff5f55345;hb=f04c2f96e7dc57ec0461e6278772f7cf711b9c25;hp=45a79ffbe49c90ac2883a6195d65e3159748c381;hpb=de45b68f7dac0f584893cbad1c2c147b3f1f0b68;p=barometer.git diff --git a/docs/release/configguide/postinstall.rst b/docs/release/configguide/postinstall.rst index 45a79ffb..8f23eec3 100644 --- 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 + +3. Watch the measure list for updates to verify that metrics are being added: + + .. code:: bash + + $ watch –n2 –d openstack metric measures show + +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://: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:``