From 23e257e0ebb3094306e84f4699c5adeab16b73e8 Mon Sep 17 00:00:00 2001
From: Robb Romans <robb.romans@rackspace.com>
Date: Fri, 30 Jan 2015 10:19:06 -0600
Subject: [PATCH] Configure glance notification driver

Glance does not use the message queue without the optional Telemetry
service.  Set default glance notification_driver values to noop.  This
prevents creation of a queue with no consumer and eliminates issues with
the additional configuration necessary for notifications.  The Telemetry
chapter reconfigures glance to properly use notifications.

Change-Id: If4e3d7cbfb18b7a9f8ae4c1d7309664b30a03a73
Closes-bug: 1404956
backport: juno
---
 doc/install-guide/samples/glance-api.conf     |  2 +-
 .../samples/glance-registry.conf              |  6 +++++
 doc/install-guide/section_glance-install.xml  | 22 +++++++++++++++++++
 3 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/doc/install-guide/samples/glance-api.conf b/doc/install-guide/samples/glance-api.conf
index 7dd4f34a3a..d016219074 100644
--- a/doc/install-guide/samples/glance-api.conf
+++ b/doc/install-guide/samples/glance-api.conf
@@ -203,7 +203,7 @@ registry_client_protocol = http
 
 # Driver or drivers to handle sending notifications. Set to
 # 'messaging' to send notifications to a message queue.
-# notification_driver = noop
+notification_driver = noop
 
 # Default publisher_id for outgoing notifications.
 # default_publisher_id = image.localhost
diff --git a/doc/install-guide/samples/glance-registry.conf b/doc/install-guide/samples/glance-registry.conf
index 3886b0ecb4..1cd781887c 100644
--- a/doc/install-guide/samples/glance-registry.conf
+++ b/doc/install-guide/samples/glance-registry.conf
@@ -84,3 +84,9 @@ config_file = /etc/glance/glance-registry-paste.ini
 # [pipeline:glance-api-keystone], you would configure the flavor below
 # as 'keystone'.
 flavor=keystone
+
+# ============ Notification System Options =====================
+
+# Driver or drivers to handle sending notifications. Set to
+# 'messaging' to send notifications to a message queue.
+notification_driver = noop
diff --git a/doc/install-guide/section_glance-install.xml b/doc/install-guide/section_glance-install.xml
index 81de85772b..b21d7e667c 100644
--- a/doc/install-guide/section_glance-install.xml
+++ b/doc/install-guide/section_glance-install.xml
@@ -166,6 +166,17 @@ flavor = keystone</programlisting>
 default_store = file
 filesystem_store_datadir = /var/lib/glance/images/</programlisting>
         </step>
+        <step>
+          <para>In the <literal>[DEFAULT]</literal> section, configure
+          the <literal>noop</literal> notification driver to disable
+          notifications because they only pertain to the optional
+          Telemetry service:</para>
+          <programlisting language="ini">[DEFAULT]
+...
+notification_driver = noop</programlisting>
+          <para>The Telemetry chapter provides a glance configuration
+          that enables notifications.</para>
+        </step>
         <step>
           <para>(Optional) To assist with troubleshooting,
             enable verbose logging in the <literal>[DEFAULT]</literal>
@@ -215,6 +226,17 @@ flavor = keystone</programlisting>
           </note>
         </step>
         <step>
+          <para>In the <literal>[DEFAULT]</literal> section, configure
+          the <literal>noop</literal> notification driver to disable
+          notifications because they only pertain to the optional
+          Telemetry service:</para>
+          <programlisting language="ini">[DEFAULT]
+...
+notification_driver = noop</programlisting>
+          <para>The Telemetry chapter provides a glance configuration
+          that enables notifications.</para>
+        </step>
+          <step>
           <para>(Optional) To assist with troubleshooting,
             enable verbose logging in the <literal>[DEFAULT]</literal>
             section:</para>