e708842d7b
* replace 1., 2., .. with #. where possible * replace a., b., .. with * * flatten some lists Change-Id: Icdae64a44fee7911022331081c07d717d797506e Implements: blueprint installguide-liberty
129 lines
3.5 KiB
ReStructuredText
129 lines
3.5 KiB
ReStructuredText
====================================
|
|
Configure the Object Storage service
|
|
====================================
|
|
|
|
To retrieve storage-oriented events and samples, configure the
|
|
Object Storage service to send notifications to the message bus.
|
|
|
|
To configure prerequisites
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The Telemetry service requires access to the Object Storage
|
|
service using the ``ResellerAdmin`` role. Perform
|
|
these steps on the controller node.
|
|
|
|
#. Source the ``admin`` credentials to gain access to admin-only
|
|
CLI commands.
|
|
|
|
.. code-block:: console
|
|
|
|
$ source admin-openrc.sh
|
|
|
|
#. Create the ``ResellerAdmin`` role:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack role create ResellerAdmin
|
|
+-------+----------------------------------+
|
|
| Field | Value |
|
|
+-------+----------------------------------+
|
|
| id | 462fa46c13fd4798a95a3bfbe27b5e54 |
|
|
| name | ResellerAdmin |
|
|
+-------+----------------------------------+
|
|
|
|
#. Add the ``ResellerAdmin`` role to the ``service`` tenant and
|
|
``ceilometer`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack role add --project service --user ceilometer ResellerAdmin
|
|
+-------+----------------------------------+
|
|
| Field | Value |
|
|
+-------+----------------------------------+
|
|
| id | 462fa46c13fd4798a95a3bfbe27b5e54 |
|
|
| name | ResellerAdmin |
|
|
+-------+----------------------------------+
|
|
|
|
To configure notifications
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Perform these steps on the controller and any other nodes that
|
|
run the Object Storage proxy service.
|
|
|
|
#. Edit the ``/etc/swift/proxy-server.conf`` file
|
|
and complete the following actions:
|
|
|
|
* In the ``[filter:keystoneauth]`` section, add the
|
|
``ResellerAdmin`` role:
|
|
|
|
.. code-block:: ini
|
|
|
|
[filter:keystoneauth]
|
|
...
|
|
operator_roles = admin,user,ResellerAdmin
|
|
|
|
* In the ``[pipeline:main]`` section, add ``ceilometer``:
|
|
|
|
.. code-block:: ini
|
|
|
|
[pipeline:main]
|
|
...
|
|
pipeline = authtoken cache healthcheck keystoneauth proxy-logging ceilometer proxy-server
|
|
|
|
* In the ``[filter:ceilometer]`` section, configure notifications:
|
|
|
|
.. code-block:: ini
|
|
|
|
[filter:ceilometer]
|
|
...
|
|
paste.filter_factory = ceilometermiddleware.swift:filter_factory
|
|
control_exchange = swift
|
|
url = rabbit://openstack:RABBIT_PASS@controller:5672/
|
|
driver = messagingv2
|
|
topic = notifications
|
|
log_level = WARN
|
|
|
|
Replace ``RABBIT_PASS`` with the password you chose for the
|
|
``openstack`` account in ``RabbitMQ``.
|
|
|
|
#. Add the ``swift`` system user to the ``ceilometer`` system group
|
|
to permit access to the Telemetry configuration files by the
|
|
Object Storage service:
|
|
|
|
.. code-block:: console
|
|
|
|
# usermod -a -G ceilometer swift
|
|
|
|
.. only:: obs
|
|
|
|
|
|
3. Restart the Object Storage proxy service:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl restart openstack-swift-proxy.service
|
|
|
|
.. only:: rdo
|
|
|
|
3. Install the ``ceilometermiddleware`` package:
|
|
|
|
.. Workaround for https://bugzilla.redhat.com/show_bug.cgi?id=1214928
|
|
|
|
.. code-block:: console
|
|
|
|
# pip install ceilometermiddleware
|
|
|
|
4. Restart the Object Storage proxy service:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl restart openstack-swift-proxy.service
|
|
|
|
.. only:: ubuntu
|
|
|
|
3. Restart the Object Storage proxy service:
|
|
|
|
.. code-block:: console
|
|
|
|
# service swift-proxy restart
|