update install docs
- remove ceilometerclient. we don't need this.
- add docs on how to install gnocchi using openstack packages
Closes-Bug: #1687839
Change-Id: I2f932fbe0b48bb11aa68d47e77aa2dc07af21731
(cherry picked from commit 2696ef6112)
This commit is contained in:
gord chung
gordon chung
parent
124d03bf9d
commit
8f10d547a4
|
|
@ -42,36 +42,7 @@
|
|||
Replace ``CEILOMETER_PASS`` with the password you chose for
|
||||
the ``ceilometer`` user in the Identity service.
|
||||
|
||||
3. Edit the ``/etc/gnocchi/gnocchi.conf`` file and add Keystone options:
|
||||
|
||||
* In the ``[api]`` section, configure gnocchi to use keystone:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[api]
|
||||
auth_mode = keystone
|
||||
|
||||
* In the ``[keystone_authtoken]`` section, configure keystone
|
||||
authentication:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[keystone_authtoken]
|
||||
...
|
||||
auth_type = password
|
||||
auth_url = http://controller:5000/v3
|
||||
project_domain_name = Default
|
||||
user_domain_name = Default
|
||||
project_name = service
|
||||
username = gnocchi
|
||||
password = GNOCCHI_PASS
|
||||
interface = internalURL
|
||||
region_name = RegionOne
|
||||
|
||||
Replace ``GNOCCHI_PASS`` with the password you chose for
|
||||
the ``gnocchi`` user in the Identity service.
|
||||
|
||||
4. Create Ceilometer resources in Gnocchi. Gnocchi should be running by this
|
||||
3. Create Ceilometer resources in Gnocchi. Gnocchi should be running by this
|
||||
stage:
|
||||
|
||||
.. code-block:: console
|
||||
|
|
|
|||
|
|
@ -11,20 +11,51 @@ Prerequisites
|
|||
|
||||
Before you install and configure the Telemetry service, you must
|
||||
configure a target to send metering data to. The recommended endpoint
|
||||
is Gnocchi_. To enable Gnocchi, please see its install guide.
|
||||
is Gnocchi_.
|
||||
|
||||
.. _Gnocchi: http://gnocchi.xyz
|
||||
.. include:: install-base-prereq-common.inc
|
||||
|
||||
Install Gnocchi
|
||||
---------------
|
||||
|
||||
#. Install the Gnocchi packages. Alternatively, Gnocchi can be install using
|
||||
pip:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# zypper install openstack-gnocchi-api openstack-gnocchi-metricd \
|
||||
python-gnocchiclient
|
||||
|
||||
.. note::
|
||||
|
||||
Depending on your environment size, consider installing Gnocchi
|
||||
separately as it makes extensive use of the cpu.
|
||||
|
||||
.. include:: install-gnocchi.inc
|
||||
|
||||
Finalize Gnocchi installation
|
||||
-----------------------------
|
||||
|
||||
#. Start the Gnocchi services and configure them to start when the
|
||||
system boots:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# systemctl enable openstack-gnocchi-api.service \
|
||||
openstack-gnocchi-metricd.service
|
||||
# systemctl start openstack-gnocchi-api.service \
|
||||
openstack-gnocchi-metricd.service
|
||||
|
||||
Install and configure components
|
||||
--------------------------------
|
||||
|
||||
1. Install the packages:
|
||||
#. Install the packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# zypper install openstack-ceilometer-agent-notification \
|
||||
openstack-ceilometer-agent-central python-ceilometerclient
|
||||
openstack-ceilometer-agent-central
|
||||
|
||||
.. include:: install-base-config-common.inc
|
||||
|
||||
|
|
|
|||
|
|
@ -11,20 +11,51 @@ Prerequisites
|
|||
|
||||
Before you install and configure the Telemetry service, you must
|
||||
configure a target to send metering data to. The recommended endpoint
|
||||
is Gnocchi_. To enable Gnocchi, please see its install guide.
|
||||
is Gnocchi_.
|
||||
|
||||
.. _Gnocchi: http://gnocchi.xyz
|
||||
.. include:: install-base-prereq-common.inc
|
||||
|
||||
Install Gnocchi
|
||||
---------------
|
||||
|
||||
#. Install the Gnocchi packages. Alternatively, Gnocchi can be install using
|
||||
pip:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# yum install openstack-gnocchi-api openstack-gnocchi-metricd \
|
||||
python-gnocchiclient
|
||||
|
||||
.. note::
|
||||
|
||||
Depending on your environment size, consider installing Gnocchi
|
||||
separately as it makes extensive use of the cpu.
|
||||
|
||||
.. include:: install-gnocchi.inc
|
||||
|
||||
Finalize Gnocchi installation
|
||||
-----------------------------
|
||||
|
||||
#. Start the Gnocchi services and configure them to start when the
|
||||
system boots:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# systemctl enable openstack-gnocchi-api.service \
|
||||
openstack-gnocchi-metricd.service
|
||||
# systemctl start openstack-gnocchi-api.service \
|
||||
openstack-gnocchi-metricd.service
|
||||
|
||||
Install and configure components
|
||||
--------------------------------
|
||||
|
||||
1. Install the packages:
|
||||
#. Install the Ceilometer packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# yum install openstack-ceilometer-notification \
|
||||
openstack-ceilometer-central python-ceilometerclient
|
||||
openstack-ceilometer-central
|
||||
|
||||
.. include:: install-base-config-common.inc
|
||||
|
||||
|
|
|
|||
|
|
@ -11,20 +11,47 @@ Prerequisites
|
|||
|
||||
Before you install and configure the Telemetry service, you must
|
||||
configure a target to send metering data to. The recommended endpoint
|
||||
is Gnocchi_. To enable Gnocchi, please see its install guide.
|
||||
is Gnocchi_.
|
||||
|
||||
.. _Gnocchi: http://gnocchi.xyz
|
||||
.. include:: install-base-prereq-common.inc
|
||||
|
||||
Install Gnocchi
|
||||
---------------
|
||||
|
||||
#. Install the Gnocchi packages. Alternatively, Gnocchi can be install using
|
||||
pip:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# apt-get install gnocchi-api gnocchi-metricd python-gnocchiclient
|
||||
|
||||
.. note::
|
||||
|
||||
Depending on your environment size, consider installing Gnocchi
|
||||
separately as it makes extensive use of the cpu.
|
||||
|
||||
.. include:: install-gnocchi.inc
|
||||
|
||||
Finalize Gnocchi installation
|
||||
-----------------------------
|
||||
|
||||
#. Restart the Gnocchi services:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# service gnocchi-api restart
|
||||
# service gnocchi-metricd restart
|
||||
|
||||
Install and configure components
|
||||
--------------------------------
|
||||
|
||||
#. Install the packages:
|
||||
#. Install the ceilometer packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# apt-get install ceilometer-agent-notification \
|
||||
ceilometer-agent-central python-ceilometerclient
|
||||
ceilometer-agent-central
|
||||
|
||||
.. include:: install-base-config-common.inc
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,83 @@
|
|||
2. Create the database for Gnocchi's indexer:
|
||||
|
||||
* Use the database access client to connect to the database
|
||||
server as the ``root`` user:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ mysql -u root -p
|
||||
|
||||
* Create the ``gnocchi`` database:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
CREATE DATABASE gnocchi;
|
||||
|
||||
* Grant proper access to the ``gnocchi`` database:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
GRANT ALL PRIVILEGES ON gnocchi.* TO 'gnocchi'@'localhost' \
|
||||
IDENTIFIED BY 'GNOCCHI_DBPASS';
|
||||
GRANT ALL PRIVILEGES ON gnocchi.* TO 'gnocchi'@'%' \
|
||||
IDENTIFIED BY 'GNOCCHI_DBPASS';
|
||||
|
||||
Replace ``GNOCCHI_DBPASS`` with a suitable password.
|
||||
|
||||
* Exit the database access client.
|
||||
|
||||
3. Edit the ``/etc/gnocchi/gnocchi.conf`` file and add Keystone options:
|
||||
|
||||
* In the ``[api]`` section, configure gnocchi to use keystone:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[api]
|
||||
auth_mode = keystone
|
||||
|
||||
* In the ``[keystone_authtoken]`` section, configure keystone
|
||||
authentication:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[keystone_authtoken]
|
||||
...
|
||||
auth_type = password
|
||||
auth_url = http://controller:5000/v3
|
||||
project_domain_name = Default
|
||||
user_domain_name = Default
|
||||
project_name = service
|
||||
username = gnocchi
|
||||
password = GNOCCHI_PASS
|
||||
interface = internalURL
|
||||
region_name = RegionOne
|
||||
|
||||
Replace ``GNOCCHI_PASS`` with the password you chose for
|
||||
the ``gnocchi`` user in the Identity service.
|
||||
|
||||
* In the ``[indexer]`` section, configure database access:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[indexer]
|
||||
url = mysql+pymysql://gnocchi:GNOCCHI_DBPASS@controller/gnocchi
|
||||
|
||||
Replace ``GNOCCHI_DBPASS`` with the password you chose for Gnocchi's
|
||||
indexer database.
|
||||
|
||||
* In the ``[storage]`` section, configure location to store metric data.
|
||||
In this case, we will store it to the local file system. See Gnocchi
|
||||
documenation for a list of more durable and performant drivers:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[storage]
|
||||
coordination_url = redis://controller:6379
|
||||
file_basepath = /var/lib/gnocchi
|
||||
driver = file
|
||||
|
||||
4. Initialize Gnocchi:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
gnocchi-upgrade
|
||||
Loading…
Reference in New Issue