docs: moving to new doc structure
[barometer.git] / docs / release / configguide / postinstall.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3
4 Barometer post installation procedures
5 ======================================
6 Add a brief introduction to the methods of validating the installation
7 according to this specific installer or feature.
8
9 Automated post installation activities
10 --------------------------------------
11 Describe specific post installation activities performed by the OPNFV
12 deployment pipeline including testing activities and reports. Refer to
13 the relevant testing guides, results, and release notes.
14
15 note: this section should be singular and derived from the test projects
16 once we have one test suite to run for all deploy tools.  This is not the
17 case yet so each deploy tool will need to provide (hopefully very simillar)
18 documentation of this.
19
20 Barometer post configuration procedures
21 --------------------------------------
22 The fuel plugin installs collectd and its plugins on compute nodes.
23 separate config files for each of the collectd plugins. These
24 configuration files can be found on the compute node @
25 `/etc/collectd/collectd.conf.d/` directory. Each collectd plugin will
26 have its own configuration file with a default configuration for each
27 plugin. You can override any of the plugin configurations, by modifying
28 the configuration file and restarting the collectd service on the compute node.
29
30 Platform components validation
31 ---------------------------------
32 1. SSH to a compute node and ensure that the collectd service is running.
33
34 2. On the compute node, you need to inject a corrected memory error:
35
36 .. code:: bash
37
38     $ git clone https://git.kernel.org/pub/scm/utils/cpu/mce/mce-inject.git
39     $ cd mce-inject
40     $ make
41     $ modprobe mce-inject
42
43 Modify the test/corrected script to include the following:
44
45 .. code:: bash
46
47     CPU 0 BANK 0
48     STATUS 0xcc00008000010090
49     ADDR 0x0010FFFFFFF
50
51 Inject the error:
52
53 .. code:: bash
54
55     $ ./mce-inject < test/corrected
56
57 3. SSH to openstack controller node and query the ceilometer DB:
58
59 .. code:: bash
60
61     $ source openrc
62     $ ceilometer sample-list -m interface.if_packets
63     $ ceilometer sample-list -m hugepages.vmpage_number
64     $ ceilometer sample-list -m ovs_events.gauge
65     $ ceilometer sample-list -m mcelog.errors
66
67 As you run each command above, you should see output similar to the examples below:
68
69 .. code:: bash
70  | node-6.domain.tld-br-prv-link_status       | ovs_events.gauge | gauge | 1.0    | None | 2017-01-20T18:18:40 |
71  | node-6.domain.tld-int-br-prv-link_status   | ovs_events.gauge | gauge | 1.0    | None | 2017-01-20T18:18:39 |
72  | node-6.domain.tld-br-int-link_status       | ovs_events.gauge | gauge | 0.0    | None | 2017-01-20T18:18:39 |
73
74  | node-6.domain.tld-mm-2048Kb-free    | hugepages.vmpage_number | gauge | 0.0    | None | 2017-01-20T18:17:12 |
75  | node-6.domain.tld-mm-2048Kb-used    | hugepages.vmpage_number | gauge | 0.0    | None | 2017-01-20T18:17:12 |
76  +-------------------------------------+-------------------------+-------+--------+------+---------------------+
77
78  | bf05daca-df41-11e6-b097-5254006ed58e | node-6.domain.tld-SOCKET_0_CHANNEL_0_DIMM_any-uncorrected_memory_errors_in_24h   | mcelog.errors    | gauge | 0.0          | None    | 2017-01-20T18:53:34 |
79  | bf05dacb-df41-11e6-b097-5254006ed58e | node-6.domain.tld-SOCKET_0_CHANNEL_any_DIMM_any-uncorrected_memory_errors_in_24h | mcelog.errors    | gauge | 0.0          | None    | 2017-01-20T18:53:34 |
80  | bdcb930d-df41-11e6-b097-5254006ed58e | node-6.domain.tld-SOCKET_0_CHANNEL_any_DIMM_any-uncorrected_memory_errors        | mcelog.errors    | gauge | 0.0          | None    | 2017-01-20T18:53:33 |
81