diff --git a/doc/source/deploy/configuration.rst b/doc/source/deploy/configuration.rst index 2adcc643f..7c42273bb 100644 --- a/doc/source/deploy/configuration.rst +++ b/doc/source/deploy/configuration.rst @@ -403,6 +403,35 @@ own storage driver using whatever technology you want. For more information : https://wiki.openstack.org/wiki/Gnocchi +Configure Nova Notifications +============================ + +Watcher can consume notifications generated by the Nova services, in order to +build or update, in real time, its cluster data model related to computing +resources. + +Nova publishes, by default, notifications on ``notifications`` AMQP queue +(configurable) and ``versioned_notifications`` AMQP queue (not +configurable). ``notifications`` queue is mainly used by ceilometer, so we can +not use it. And some events, related to nova-compute service state, are only +sent into the ``versioned_notifications`` queue. + +By default, Watcher listens to AMQP queues named ``watcher_notifications`` +and ``versioned_notifications``. So you have to update the Nova +configuration file on controller and compute nodes, in order +to Watcher receives Nova notifications in ``watcher_notifications`` as well. + + * In the file ``/etc/nova/nova.conf``, update the section + ``[oslo_messaging_notifications]``, by redefining the list of topics + into which Nova services will publish events :: + + [oslo_messaging_notifications] + driver = messaging + topics = notifications,watcher_notifications + + * Restart the Nova services. + + Workers =======