From 61fb2e04abdd92994502f9a88db5ceb7c023af6d Mon Sep 17 00:00:00 2001 From: gord chung Date: Fri, 26 May 2017 16:30:40 +0000 Subject: [PATCH] add ceilometer storage disclaimer people are looking at newton docs and then not realising the ocata and later docs say ceilometer storage is dead. make it more obvious that ceilometer storage is dead and was dead even older than newton. Change-Id: Iaf6c60fc75b109f5e8bf1556214c242b3b399e58 --- install-guide/source/install-base-obs.rst | 13 +++++++++++++ install-guide/source/install-base-rdo.rst | 13 +++++++++++++ install-guide/source/install-base-ubuntu.rst | 13 +++++++++++++ 3 files changed, 39 insertions(+) diff --git a/install-guide/source/install-base-obs.rst b/install-guide/source/install-base-obs.rst index 5cb05e5a60..e705121fae 100644 --- a/install-guide/source/install-base-obs.rst +++ b/install-guide/source/install-base-obs.rst @@ -9,6 +9,15 @@ Telemetry service, code-named ceilometer, on the controller node. Prerequisites ------------- +.. warning:: + + Ceilometer's native storage has extremely large resource requirements. For + more efficient time-series storage, a time-series database such as Gnocchi_ + is recommended. The following instructions are unsupported in future + releases. + +.. _Gnocchi: http://gnocchi.xyz/ + Before you install and configure the Telemetry service, you must create a database, service credentials, and API endpoints. However, unlike other services, the Telemetry service uses a NoSQL database. @@ -73,6 +82,10 @@ Install and configure components Configure the Apache HTTP server -------------------------------- +.. note:: + + The following is only required if Ceilometer's native storage is enabled. + * Create the ``/etc/apache2/conf.d/wsgi-ceilometer.conf`` file with the following content: diff --git a/install-guide/source/install-base-rdo.rst b/install-guide/source/install-base-rdo.rst index f9a9504727..b2b13d3801 100644 --- a/install-guide/source/install-base-rdo.rst +++ b/install-guide/source/install-base-rdo.rst @@ -9,6 +9,15 @@ Telemetry service, code-named ceilometer, on the controller node. Prerequisites ------------- +.. warning:: + + Ceilometer's native storage has extremely large resource requirements. For + more efficient time-series storage, a time-series database such as Gnocchi_ + is recommended. The following instructions are unsupported in future + releases. + +.. _Gnocchi: http://gnocchi.xyz/ + Before you install and configure the Telemetry service, you must create a database, service credentials, and API endpoints. However, unlike other services, the Telemetry service uses a NoSQL database. @@ -49,6 +58,10 @@ Install and configure components Configure the Apache HTTP server -------------------------------- +.. note:: + + The following is only required if Ceilometer's native storage is enabled. + * Create the ``/etc/httpd/conf.d/wsgi-ceilometer.conf`` file with the following content: diff --git a/install-guide/source/install-base-ubuntu.rst b/install-guide/source/install-base-ubuntu.rst index 36979c6845..18eb419c86 100644 --- a/install-guide/source/install-base-ubuntu.rst +++ b/install-guide/source/install-base-ubuntu.rst @@ -9,6 +9,15 @@ Telemetry service, code-named ceilometer, on the controller node. Prerequisites ------------- +.. warning:: + + Ceilometer's native storage has extremely large resource requirements. For + more efficient time-series storage, a time-series database such as Gnocchi_ + is recommended. The following instructions are unsupported in future + releases. + +.. _Gnocchi: http://gnocchi.xyz/ + Before you install and configure the Telemetry service, you must create a database, service credentials, and API endpoints. However, unlike other services, the Telemetry service uses a NoSQL database. @@ -64,6 +73,10 @@ Install and configure components Configure the Apache HTTP server -------------------------------- +.. note:: + + The following is only required if Ceilometer's native storage is enabled. + #. Create the ``/etc/apache2/sites-available/ceilometer.conf`` file with the following content: