Several editorial corrections and improvements 31/26731/5
authorGerald Kunzmann <kunzmann@docomolab-euro.com>
Thu, 5 Jan 2017 13:51:55 +0000 (13:51 +0000)
committerGerald Kunzmann <kunzmann@docomolab-euro.com>
Mon, 9 Jan 2017 11:23:06 +0000 (11:23 +0000)
JIRA: DOCTOR-81

Change-Id: I3a9c0d020bcbdbb261df8209556dbdf488f3c3db
Signed-off-by: Gerald Kunzmann <kunzmann@docomolab-euro.com>
docs/requirements/03-architecture.rst
docs/requirements/04-gaps.rst
docs/requirements/05-implementation.rst
docs/requirements/07-annex.rst

index 9f620e6..d9ccd22 100644 (file)
@@ -261,7 +261,8 @@ physical resource from 'enabled' to 'going-to-maintenance' and a timeout [#timeo
 After receiving the MaintenanceRequest,the VIM decides on the actions to be taken
 based on maintenance policies predefined by the affected Consumer(s).
 
 After receiving the MaintenanceRequest,the VIM decides on the actions to be taken
 based on maintenance policies predefined by the affected Consumer(s).
 
-.. [#timeout] Timeout is set by the Administrator and corresponds to the maximum time to empty the physical resources.
+.. [#timeout] Timeout is set by the Administrator and corresponds to the maximum time
+   to empty the physical resources.
 
 .. figure:: images/figure5a.png
    :name: figure5a
 
 .. figure:: images/figure5a.png
    :name: figure5a
@@ -322,11 +323,12 @@ shown in :numref:`figure5c`.
 It consists of the following steps:
 
 5. The Consumer C3 switches to standby configuration (STBY).
 It consists of the following steps:
 
 5. The Consumer C3 switches to standby configuration (STBY).
-6. Instructions from Consumers C2/C3 are shared to VIM requesting certain actions to be performed (steps 6a, 6b).
-   The VIM executes the requested actions and sends back a NACK to consumer C2 (step 6d) as the
-   migration of the virtual resource(s) is not completed by the given timeout.
+6. Instructions from Consumers C2/C3 are shared to VIM requesting certain actions to be performed
+   (steps 6a, 6b). The VIM executes the requested actions and sends back a NACK to consumer C2
+   (step 6d) as the migration of the virtual resource(s) is not completed by the given timeout.
 7. The VIM switches the physical resources to "enabled" state.
 7. The VIM switches the physical resources to "enabled" state.
-8. MaintenanceResponse is sent from VIM to inform the Administrator that the maintenance action cannot start.
+8. MaintenanceNotification is sent from VIM to inform the Administrator that the maintenance action
+   cannot start.
 
 
 ..
 
 
 ..
index 154f8e4..b8ff7f2 100644 (file)
@@ -61,6 +61,13 @@ Immediate Notification
 
     - Fault notifications cannot be received immediately by Ceilometer.
 
 
     - Fault notifications cannot be received immediately by Ceilometer.
 
+* Solved by
+
+  + Event Alarm Evaluator:
+    https://specs.openstack.org/openstack/ceilometer-specs/specs/liberty/event-alarm-evaluator.html
+  + New OpenStack alarms and notifications project AODH:
+    http://docs.openstack.org/developer/aodh/
+
 Maintenance Notification
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 Maintenance Notification
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -98,7 +105,7 @@ Maintenance Notification
 
     - VIM user cannot receive maintenance notifications.
 
 
     - VIM user cannot receive maintenance notifications.
 
-* Related blueprints
+* Solved by
 
   + https://blueprints.launchpad.net/nova/+spec/service-status-notification
 
 
   + https://blueprints.launchpad.net/nova/+spec/service-status-notification
 
@@ -126,6 +133,10 @@ Normalization of data collection models
 
     - Normalized data format does not exist.
 
 
     - Normalized data format does not exist.
 
+* Solved by
+
+  + Specification in Section :ref:`southbound`.
+
 OpenStack
 ---------
 
 OpenStack
 ---------
 
@@ -157,7 +168,7 @@ ________________________________
     - Ceilometer seems to be unsuitable for monitoring medium and large scale
       NFVI deployments.
 
     - Ceilometer seems to be unsuitable for monitoring medium and large scale
       NFVI deployments.
 
-* Related blueprints
+* Solved by
 
   + Usage of Zabbix for fault aggregation [ZABB]_. Zabbix can support a much
     higher number of fault events (up to 15 thousand events per second, but
 
   + Usage of Zabbix for fault aggregation [ZABB]_. Zabbix can support a much
     higher number of fault events (up to 15 thousand events per second, but
@@ -189,13 +200,14 @@ ___________________________________
     - OpenStack Ceilometer does not monitor hardware and software to capture
       faults.
 
     - OpenStack Ceilometer does not monitor hardware and software to capture
       faults.
 
-   + Gap
+  + Gap
 
 
-     - Ceilometer is not able to detect and handle all faults listed in the Annex.
+    - Ceilometer is not able to detect and handle all faults listed in the Annex.
 
 
-* Related blueprints / workarounds
+* Solved by
 
 
-  - Use other dedicated monitoring tools like Zabbix or Monasca
+  + Use of dedicated monitoring tools like Zabbix or Monasca.
+    See :ref:`nfvi_faults`.
 
 Nova
 ^^^^
 
 Nova
 ^^^^
@@ -218,15 +230,14 @@ ________________________________________
 
   + To-be
 
 
   + To-be
 
-    - There needs to be API to change VM power_State in case host has failed.
-    - There needs to be API to change nova-compute state.
+    - The API shall support to change VM power state in case host has failed.
+    - The API shall support to change nova-compute state.
     - There could be single API to change different VM states for all VMs
     - There could be single API to change different VM states for all VMs
-      belonging to specific host.
-    - As external system monitoring the infra calls these APIs change can be
-      fast and reliable.
-    - Correlation actions can be faster and automated as states are reliable.
-    - User will be able to read states from OpenStack and trust they are
-      correct.
+      belonging to a specific host.
+    - Support external systems that are monitoring the infrastructure and resources
+      that are able to call the API fast and reliable.
+    - Resource states are reliable such that correlation actions can be fast and automated.
+    - User shall be able to read states from OpenStack and trust they are correct.
 
   + As-is
 
 
   + As-is
 
@@ -240,12 +251,11 @@ ________________________________________
   + Gap
 
     - OpenStack does not change its states fast and reliably enough.
   + Gap
 
     - OpenStack does not change its states fast and reliably enough.
-    - There is API missing to have external system to change states and to
-      trust the states are then reliable (external system has fenced failed
-      host).
+    - The API does not support to have an external system to change states and to
+      trust the states are reliable (external system has fenced failed host).
     - User cannot read all the states from OpenStack nor trust they are right.
 
     - User cannot read all the states from OpenStack nor trust they are right.
 
-* Related blueprints
+* Solved by
 
   + https://blueprints.launchpad.net/nova/+spec/mark-host-down
   + https://blueprints.launchpad.net/python-novaclient/+spec/support-force-down-service
 
   + https://blueprints.launchpad.net/nova/+spec/mark-host-down
   + https://blueprints.launchpad.net/python-novaclient/+spec/support-force-down-service
@@ -309,7 +319,7 @@ _________________
       underlying root cause of failure. Knowing the root cause can help filter
       out unnecessary and overwhelming alarms.
 
       underlying root cause of failure. Knowing the root cause can help filter
       out unnecessary and overwhelming alarms.
 
-* Related blueprints / workarounds
+* Status
 
   + Monasca as of now lacks this feature, although the community is aware and
     working toward supporting it.
 
   + Monasca as of now lacks this feature, although the community is aware and
     working toward supporting it.
@@ -334,7 +344,7 @@ _________________
     - Sensor monitoring is very important. It provides operators status
       on the state of the physical infrastructure (e.g. temperature, fans).
 
     - Sensor monitoring is very important. It provides operators status
       on the state of the physical infrastructure (e.g. temperature, fans).
 
-* Related blueprints / workarounds
+* Addressed by
 
   + Monasca can be configured to use third-party monitoring solutions (e.g.
     Nagios, Cacti) for retrieving additional data.
 
   + Monasca can be configured to use third-party monitoring solutions (e.g.
     Nagios, Cacti) for retrieving additional data.
@@ -370,7 +380,10 @@ _____________________________
 
   + Gap
 
 
   + Gap
 
-    - Cause of the delay needs to be identified and fixed
+    - Cause of the delay is a periodic evaluation and notification. Periodicity is configured
+      as 30s default value and can be reduced to 5s but not below.
+      https://github.com/zabbix/zabbix/blob/trunk/conf/zabbix_server.conf#L329
+
 
 ..
  vim: set tabstop=4 expandtab textwidth=80:
 
 ..
  vim: set tabstop=4 expandtab textwidth=80:
index 4c89fdf..848d5a0 100644 (file)
@@ -728,6 +728,7 @@ Other areas that need alignment is the so called alarm state in NFV. Here we mus
 however consider what can be attributes of the notification vs. what should be a
 property of the alarm instance. This will be analyzed later.
 
 however consider what can be attributes of the notification vs. what should be a
 property of the alarm instance. This will be analyzed later.
 
+.. _southbound:
 
 Detailed southbound interface specification
 -------------------------------------------
 
 Detailed southbound interface specification
 -------------------------------------------
index 8cb1961..2ebba0d 100644 (file)
@@ -1,6 +1,8 @@
 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
 .. http://creativecommons.org/licenses/by/4.0
 
 .. 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
 =================================================
 
 Annex: NFVI Faults
 =================================================