openstack/ceilometer
Code Issues Proposed changes
1dd80664a8
ceilometer/install-guide/source/install-base-ubuntu.rst

40 lines
1007 B
ReStructuredText
Raw Normal View History

Add install-guide for ceilometer This adds ceilometer-specific contents of the OpenStack Installation Guide in the ceilometer repo per [1]. A separate change will remove the ceilometer contents from the OpenStack Installation Guide for Newton per [2]. The ceilometer install-guide structure is based on Install Guide Cookiecutter [3]. Also adds tox.ini environment for install-guide and adds openstackdocs-theme to test-requirements.txt. [1] http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html [2] http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html [3] https://review.openstack.org/#/c/314229/ Partially-Implements: blueprint projectspecificinstallguide Change-Id: Iffc5d7243e9eeb74c9dd7b559ef3de7123269293
2016-06-15 18:10:08 +02:00
.. _install_ubuntu:
Install and configure for Ubuntu
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This section describes how to install and configure the
Telemetry service, code-named ceilometer, on the controller node.
Prerequisites
-------------
Before you install and configure the Telemetry service, you must
drop api and storage references from install-guide stop telling people how to use deprecated/unmaintained stuff - remove all db docs detailing mongo install/config - cleanup get_started.rst - remove note about future agents because i don't know what magic it's hinting at. - add note that collector is optional - drop all notes about api service and notes about storage - drop all stuff about configuring api with apache - replace ceilometer+mongo config notes with ceilometer+gnocchi. - remove keystone_authtoken config since no more api - point all distro docs to gnocchi - add a note to say api+storage is dead. Change-Id: I494b4e7013ca146ffa640a356cacc4a1a5ee85e8
2017-01-27 16:29:51 +00:00
configure a target to send metering data to. The recommended endpoint
is Gnocchi_. To enable Gnocchi, please see its install guide.
fix gnocchi url links Change-Id: I19696684855c1a52d54e781460f48cfba9c926cf Closes-Bug: #1664215
2017-02-13 12:56:46 -05:00
.. _Gnocchi: http://gnocchi.xyz
chill out on the number of items in toc we have an absurd amount of entries in our table of contents[1]. this patch does better groupings so we nest a bit more. [1] https://docs.openstack.org/project-install-guide/telemetry/draft/ Change-Id: Ib56af520483b39e2c80ce03e0cf48a18bbfa5267
2017-02-21 22:33:50 +00:00
.. include:: install-base-prereq-common.inc
Add install-guide for ceilometer This adds ceilometer-specific contents of the OpenStack Installation Guide in the ceilometer repo per [1]. A separate change will remove the ceilometer contents from the OpenStack Installation Guide for Newton per [2]. The ceilometer install-guide structure is based on Install Guide Cookiecutter [3]. Also adds tox.ini environment for install-guide and adds openstackdocs-theme to test-requirements.txt. [1] http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html [2] http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html [3] https://review.openstack.org/#/c/314229/ Partially-Implements: blueprint projectspecificinstallguide Change-Id: Iffc5d7243e9eeb74c9dd7b559ef3de7123269293
2016-06-15 18:10:08 +02:00
Install and configure components
--------------------------------
#. Install the packages:
.. code-block:: console
remove collector instructions collector is not necessary so no point telling people how to use it. Change-Id: I513393e3aee20f110bd28cab0344bc5b118a4dce
2017-02-21 22:54:24 +00:00
# apt-get install ceilometer-agent-notification \
ceilometer-agent-central python-ceilometerclient
Add install-guide for ceilometer This adds ceilometer-specific contents of the OpenStack Installation Guide in the ceilometer repo per [1]. A separate change will remove the ceilometer contents from the OpenStack Installation Guide for Newton per [2]. The ceilometer install-guide structure is based on Install Guide Cookiecutter [3]. Also adds tox.ini environment for install-guide and adds openstackdocs-theme to test-requirements.txt. [1] http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html [2] http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html [3] https://review.openstack.org/#/c/314229/ Partially-Implements: blueprint projectspecificinstallguide Change-Id: Iffc5d7243e9eeb74c9dd7b559ef3de7123269293
2016-06-15 18:10:08 +02:00
chill out on the number of items in toc we have an absurd amount of entries in our table of contents[1]. this patch does better groupings so we nest a bit more. [1] https://docs.openstack.org/project-install-guide/telemetry/draft/ Change-Id: Ib56af520483b39e2c80ce03e0cf48a18bbfa5267
2017-02-21 22:33:50 +00:00
.. include:: install-base-config-common.inc
Add install-guide for ceilometer This adds ceilometer-specific contents of the OpenStack Installation Guide in the ceilometer repo per [1]. A separate change will remove the ceilometer contents from the OpenStack Installation Guide for Newton per [2]. The ceilometer install-guide structure is based on Install Guide Cookiecutter [3]. Also adds tox.ini environment for install-guide and adds openstackdocs-theme to test-requirements.txt. [1] http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html [2] http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html [3] https://review.openstack.org/#/c/314229/ Partially-Implements: blueprint projectspecificinstallguide Change-Id: Iffc5d7243e9eeb74c9dd7b559ef3de7123269293
2016-06-15 18:10:08 +02:00
Finalize installation
---------------------
#. Restart the Telemetry services:
.. code-block:: console
# service ceilometer-agent-central restart
# service ceilometer-agent-notification restart
Copy Permalink