summaryrefslogtreecommitdiffstats
path: root/docs/requirements/07-annex.rst
blob: c3a7899deec2b98f4643189a1e33a8f8666b3b41 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0

.. _nfvi_faults:

Annex: NFVI Faults
=================================================

Faults in the listed elements need to be immediately notified to the Consumer in
order to perform an immediate action like live migration or switch to a hot
standby entity. In addition, the Administrator of the host should trigger a
maintenance action to, e.g., reboot the server or replace a defective hardware
element.

Faults can be of different severity, i.e., critical, warning, or
info. Critical faults require immediate action as a severe degradation of the
system has happened or is expected. Warnings indicate that the system
performance is going down: related actions include closer (e.g. more frequent)
monitoring of that part of the system or preparation for a cold migration to a
backup VM. Info messages do not require any action. We also consider a type
"maintenance", which is no real fault, but may trigger maintenance actions
like a re-boot of the server or replacement of a faulty, but redundant HW.

Faults can be gathered by, e.g., enabling SNMP and installing some open source
tools to catch and poll SNMP. When using for example Zabbix one can also put an
agent running on the hosts to catch any other fault. In any case of failure, the
Administrator should be notified. The following tables provide a list of high
level faults that are considered within the scope of the Doctor project
requiring immediate action by the Consumer.

**Compute/Storage**

+-------------------+----------+------------+-----------------+------------------+
| Fault             | Severity | How to     | Comment         | Immediate action |
|                   |          | detect?    |                 | to recover       |
+===================+==========+============+=================+==================+
| Processor/CPU     | Critical | Zabbix     |                 | Switch to hot    |
| failure, CPU      |          |            |                 | standby          |
| condition not ok  |          |            |                 |                  |
+-------------------+----------+------------+-----------------+------------------+
| Memory failure/   | Critical | Zabbix     |                 | Switch to hot    |
| Memory condition  |          | (IPMI)     |                 | standby          |
| not ok            |          |            |                 |                  |
+-------------------+----------+------------+-----------------+------------------+
| Network card      | Critical | Zabbix/    |                 | Switch to hot    |
| failure, e.g.     |          | Ceilometer |                 | standby          |
| network adapter   |          |            |                 |                  |
| connectivity lost |          |            |                 |                  |
+-------------------+----------+------------+-----------------+------------------+
| Disk crash        | Info     | RAID       | Network storage | Inform OAM       |
|                   |          | monitoring | is very         |                  |
|                   |          |            | redundant (e.g. |                  |
|                   |          |            | RAID system)    |                  |
|                   |          |            | and can         |                  |
|                   |          |            | guarantee high  |                  |
|                   |          |            | availability    |                  |
+-------------------+----------+------------+-----------------+------------------+
| Storage           | Critical | Zabbix     |                 | Live migration   |
| controller        |          | (IPMI)     |                 | if storage       |
|                   |          |            |                 | is still         |
|                   |          |            |                 | accessible;      |
|                   |          |            |                 | otherwise hot    |
|                   |          |            |                 | standby          |
+-------------------+----------+------------+-----------------+------------------+
| PDU/power         | Critical | Zabbix/    |                 | Switch to hot    |
| failure, power    |          | Ceilometer |                 | standby          |
| off, server reset |          |            |                 |                  |
+-------------------+----------+------------+-----------------+------------------+
| Power             | Warning  | SNMP       |                 | Live migration   |
| degration, power  |          |            |                 |                  |
| redundancy lost,  |          |            |                 |                  |
| power threshold   |          |            |                 |                  |
| exceeded          |          |            |                 |                  |
+-------------------+----------+------------+-----------------+------------------+
| Chassis problem   | Warning  | SNMP       |                 | Live migration   |
| (e.g. fan         |          |            |                 |                  |
| degraded/failed,  |          |            |                 |                  |
| chassis power     |          |            |                 |                  |
| degraded), CPU    |          |            |                 |                  |
| fan problem,      |          |            |                 |                  |
| temperature/      |          |            |                 |                  |
| thermal condition |          |            |                 |                  |
| not ok            |          |            |                 |                  |
+-------------------+----------+------------+-----------------+------------------+
| Mainboard failure | Critical | Zabbix     | e.g. PCIe, SAS  | Switch to hot    |
|                   |          | (IPMI)     | link failure    | standby          |
+-------------------+----------+------------+-----------------+------------------+
| OS crash (e.g.    | Critical | Zabbix     |                 | Switch to hot    |
| kernel panic)     |          |            |                 | standby          |
+-------------------+----------+------------+-----------------+------------------+

**Hypervisor**

+----------------+----------+------------+-------------+-------------------+
| Fault          | Severity | How to     | Comment     | Immediate action  |
|                |          | detect?    |             | to recover        |
+================+==========+============+=============+===================+
| System has     | Critical | Zabbix     |             | Switch to hot     |
| restarted      |          |            |             | standby           |
+----------------+----------+------------+-------------+-------------------+
| Hypervisor     | Warning/ | Zabbix/    |             | Evacuation/switch |
| failure        | Critical | Ceilometer |             | to hot standby    |
+----------------+----------+------------+-------------+-------------------+
| Hypervisor     | Warning  | Alarming   | Zabbix/     | Rebuild VM        |
| status not     |          | service    | Ceilometer  |                   |
| retrievable    |          |            | unreachable |                   |
| after certain  |          |            |             |                   |
| period         |          |            |             |                   |
+----------------+----------+------------+-------------+-------------------+

**Network**

+------------------+----------+---------+----------------+---------------------+
| Fault            | Severity | How to  | Comment        | Immediate action to |
|                  |          | detect? |                | recover             |
+==================+==========+=========+================+=====================+
| SDN/OpenFlow     | Critical | Ceilo-  |                | Switch to           |
| switch,          |          | meter   |                | hot standby         |
| controller       |          |         |                | or reconfigure      |
| degraded/failed  |          |         |                | virtual network     |
|                  |          |         |                | topology            |
+------------------+----------+---------+----------------+---------------------+
| Hardware failure | Warning  | SNMP    | Redundancy of  | Live migration if   |
| of physical      |          |         | physical       | possible otherwise  |
| switch/router    |          |         | infrastructure | evacuation          |
|                  |          |         | is reduced or  |                     |
|                  |          |         | no longer      |                     |
|                  |          |         | available      |                     |
+------------------+----------+---------+----------------+---------------------+