b33f32b714
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
94 lines
2.9 KiB
ReStructuredText
94 lines
2.9 KiB
ReStructuredText
.. _install_rdo:
|
|
|
|
Install and configure for Red Hat Enterprise Linux and CentOS
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This section describes how to install and configure the
|
|
Telemetry service, code-named ceilometer, on the controller node.
|
|
|
|
This section assumes that you already have a working OpenStack
|
|
environment with at least the following components installed:
|
|
Compute, Image Service, Identity.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
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.
|
|
See :ref:`environment-nosql-database-rdo` to install and configure
|
|
MongoDB before proceeding further.
|
|
|
|
1. Create the ``ceilometer`` database:
|
|
|
|
.. code-block:: console
|
|
|
|
# mongo --host controller --eval '
|
|
db = db.getSiblingDB("ceilometer");
|
|
db.createUser({user: "ceilometer",
|
|
pwd: "CEILOMETER_DBPASS",
|
|
roles: [ "readWrite", "dbAdmin" ]})'
|
|
|
|
MongoDB shell version: 2.6.x
|
|
connecting to: controller:27017/test
|
|
Successfully added user: { "user" : "ceilometer", "roles" : [ "readWrite", "dbAdmin" ] }
|
|
|
|
Replace ``CEILOMETER_DBPASS`` with a suitable password.
|
|
|
|
.. include:: install-base-prereq-common.rst
|
|
|
|
Install and configure components
|
|
--------------------------------
|
|
|
|
1. Install the packages:
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install openstack-ceilometer-api \
|
|
openstack-ceilometer-collector openstack-ceilometer-notification \
|
|
openstack-ceilometer-central python-ceilometerclient
|
|
|
|
.. include:: install-base-config-common.rst
|
|
|
|
Configure the Apache HTTP server
|
|
--------------------------------
|
|
|
|
* Create the ``/etc/httpd/conf.d/wsgi-ceilometer.conf`` file with
|
|
the following content:
|
|
|
|
.. code-block:: apache
|
|
|
|
Listen 8777
|
|
|
|
<VirtualHost *:8777>
|
|
WSGIDaemonProcess ceilometer-api processes=2 threads=10 user=ceilometer group=ceilometer display-name=%{GROUP}
|
|
WSGIProcessGroup ceilometer-api
|
|
WSGIScriptAlias / "/var/www/cgi-bin/ceilometer/app"
|
|
WSGIApplicationGroup %{GLOBAL}
|
|
ErrorLog /var/log/httpd/ceilometer_error.log
|
|
CustomLog /var/log/httpd/ceilometer_access.log combined
|
|
</VirtualHost>
|
|
|
|
WSGISocketPrefix /var/run/httpd
|
|
|
|
Finalize installation
|
|
---------------------
|
|
|
|
#. Reload the Apache HTTP server:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl reload httpd.service
|
|
|
|
#. Start the Telemetry services and configure them to start when the
|
|
system boots:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable openstack-ceilometer-notification.service \
|
|
openstack-ceilometer-central.service \
|
|
openstack-ceilometer-collector.service
|
|
# systemctl start openstack-ceilometer-notification.service \
|
|
openstack-ceilometer-central.service \
|
|
openstack-ceilometer-collector.service
|