diff --git a/doc/install-guide-debconf/source/ceilometer-aodh.rst b/doc/install-guide-debconf/source/ceilometer-aodh.rst deleted file mode 120000 index 04f655dca8..0000000000 --- a/doc/install-guide-debconf/source/ceilometer-aodh.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/ceilometer-aodh.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/ceilometer-cinder.rst b/doc/install-guide-debconf/source/ceilometer-cinder.rst deleted file mode 120000 index 528aafc786..0000000000 --- a/doc/install-guide-debconf/source/ceilometer-cinder.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/ceilometer-cinder.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/ceilometer-glance.rst b/doc/install-guide-debconf/source/ceilometer-glance.rst deleted file mode 120000 index 26984cd7b8..0000000000 --- a/doc/install-guide-debconf/source/ceilometer-glance.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/ceilometer-glance.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/ceilometer-install.rst b/doc/install-guide-debconf/source/ceilometer-install.rst deleted file mode 100644 index 186d4c9d0c..0000000000 --- a/doc/install-guide-debconf/source/ceilometer-install.rst +++ /dev/null @@ -1,210 +0,0 @@ -Install and configure -~~~~~~~~~~~~~~~~~~~~~ - -This section describes how to install and configure the Telemetry -service, code-named ceilometer, on the controller node. The Telemetry -service collects measurements from most OpenStack services and -optionally triggers alarms. - -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` to install and configure -MongoDB before proceeding further. - -#. 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.4.x - connecting to: controller:27017/test - { - "user" : "ceilometer", - "pwd" : "72f25aeee7ad4be52437d7cd3fc60f6f", - "roles" : [ - "readWrite", - "dbAdmin" - ], - "_id" : ObjectId("5489c22270d7fad1ba631dc3") - } - - Replace ``CEILOMETER_DBPASS`` with a suitable password. - - .. note:: - - If the command fails saying you are not authorized to insert a user, - you may need to temporarily comment out the ``auth`` option in - the ``/etc/mongodb.conf`` file, restart the MongoDB service using - ``systemctl restart mongodb``, and try calling the command again. - -#. Source the ``admin`` credentials to gain access to admin-only - CLI commands: - - .. code-block:: console - - $ . admin-openrc - -#. To create the service credentials, complete these steps: - - * Create the ``ceilometer`` user: - - .. code-block:: console - - $ openstack user create --domain default --password-prompt ceilometer - User Password: - Repeat User Password: - +-----------+----------------------------------+ - | Field | Value | - +-----------+----------------------------------+ - | domain_id | e0353a670a9e496da891347c589539e9 | - | enabled | True | - | id | c859c96f57bd4989a8ea1a0b1d8ff7cd | - | name | ceilometer | - +-----------+----------------------------------+ - - * Add the ``admin`` role to the ``ceilometer`` user. - - .. code-block:: console - - $ openstack role add --project service --user ceilometer admin - - .. note:: - - This command provides no output. - - * Create the ``ceilometer`` service entity: - - .. code-block:: console - - $ openstack service create --name ceilometer \ - --description "Telemetry" metering - +-------------+----------------------------------+ - | Field | Value | - +-------------+----------------------------------+ - | description | Telemetry | - | enabled | True | - | id | 5fb7fd1bb2954fddb378d4031c28c0e4 | - | name | ceilometer | - | type | metering | - +-------------+----------------------------------+ - -#. Create the Telemetry service API endpoints: - - .. code-block:: console - - $ openstack endpoint create --region RegionOne \ - metering public http://controller:8777 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | b808b67b848d443e9eaaa5e5d796970c | - | interface | public | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 5fb7fd1bb2954fddb378d4031c28c0e4 | - | service_name | ceilometer | - | service_type | metering | - | url | http://controller:8777 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - metering internal http://controller:8777 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | c7009b1c2ee54b71b771fa3d0ae4f948 | - | interface | internal | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 5fb7fd1bb2954fddb378d4031c28c0e4 | - | service_name | ceilometer | - | service_type | metering | - | url | http://controller:8777 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - metering admin http://controller:8777 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | b2c00566d0604551b5fe1540c699db3d | - | interface | admin | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 5fb7fd1bb2954fddb378d4031c28c0e4 | - | service_name | ceilometer | - | service_type | metering | - | url | http://controller:8777 | - +--------------+----------------------------------+ - -Install and configure components --------------------------------- - -#. Install the packages: - - .. code-block:: console - - # apt-get install ceilometer-api ceilometer-collector \ - ceilometer-agent-central ceilometer-agent-notification - python-ceilometerclient - - Respond to prompts for - :doc:`Identity service credentials `, - :doc:`service endpoint registration `, - and :doc:`message broker credentials `. - -#. Edit the ``/etc/ceilometer/ceilometer.conf`` file and complete - the following actions: - - * In the ``[database]`` section, configure database access: - - .. code-block:: ini - - [database] - ... - connection = mongodb://ceilometer:CEILOMETER_DBPASS@controller:27017/ceilometer - - Replace ``CEILOMETER_DBPASS`` with the password you chose for the - Telemetry service database. You must escape special characters such - as ':', '/', '+', and '@' in the connection string in accordance - with `RFC2396 `_. - - * In the ``[service_credentials]`` section, configure service credentials: - - .. code-block:: ini - - [service_credentials] - ... - os_auth_url = http://controller:5000/v2.0 - os_username = ceilometer - os_tenant_name = service - os_password = CEILOMETER_PASS - interface = internalURL - region_name = RegionOne - - Replace ``CEILOMETER_PASS`` with the password you chose for - the ``ceilometer`` user in the Identity service. - -Finalize installation ---------------------- - -#. Restart the Telemetry services: - - .. code-block:: console - - # service ceilometer-agent-central restart - # service ceilometer-agent-notification restart - # service ceilometer-api restart - # service ceilometer-collector restart diff --git a/doc/install-guide-debconf/source/ceilometer-next-steps.rst b/doc/install-guide-debconf/source/ceilometer-next-steps.rst deleted file mode 120000 index f99c68234d..0000000000 --- a/doc/install-guide-debconf/source/ceilometer-next-steps.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/ceilometer-next-steps.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/ceilometer-nova.rst b/doc/install-guide-debconf/source/ceilometer-nova.rst deleted file mode 120000 index 3b5940bd77..0000000000 --- a/doc/install-guide-debconf/source/ceilometer-nova.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/ceilometer-nova.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/ceilometer-swift.rst b/doc/install-guide-debconf/source/ceilometer-swift.rst deleted file mode 120000 index 516156699d..0000000000 --- a/doc/install-guide-debconf/source/ceilometer-swift.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/ceilometer-swift.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/ceilometer-verify.rst b/doc/install-guide-debconf/source/ceilometer-verify.rst deleted file mode 120000 index 2d7b809613..0000000000 --- a/doc/install-guide-debconf/source/ceilometer-verify.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/ceilometer-verify.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/ceilometer.rst b/doc/install-guide-debconf/source/ceilometer.rst deleted file mode 120000 index 73211daa52..0000000000 --- a/doc/install-guide-debconf/source/ceilometer.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/ceilometer.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/conf.py b/doc/install-guide-debconf/source/conf.py index cb5e2bfd9d..713c6664e6 100644 --- a/doc/install-guide-debconf/source/conf.py +++ b/doc/install-guide-debconf/source/conf.py @@ -101,6 +101,7 @@ exclude_patterns = ['common/cli*', 'common/nova*', 'common/get_started_database_service.rst', 'common/get_started_data_processing.rst', 'common/get_started_orchestration.rst', + 'common/get_started_telemetry.rst', 'common/dashboard_customizing.rst', 'shared/note_configuration_vary_by_distribution.rst'] diff --git a/doc/install-guide-debconf/source/environment-nosql-database.rst b/doc/install-guide-debconf/source/environment-nosql-database.rst deleted file mode 120000 index 21128a0629..0000000000 --- a/doc/install-guide-debconf/source/environment-nosql-database.rst +++ /dev/null @@ -1 +0,0 @@ -../../install-guide/source/environment-nosql-database.rst \ No newline at end of file diff --git a/doc/install-guide-debconf/source/index.rst b/doc/install-guide-debconf/source/index.rst index a23d7d074e..a85718969b 100644 --- a/doc/install-guide-debconf/source/index.rst +++ b/doc/install-guide-debconf/source/index.rst @@ -46,7 +46,6 @@ Contents cinder.rst manila.rst swift.rst - ceilometer.rst launch-instance.rst Appendix diff --git a/doc/install-guide/source/ceilometer-aodh.rst b/doc/install-guide/source/ceilometer-aodh.rst deleted file mode 100644 index 203c7b865f..0000000000 --- a/doc/install-guide/source/ceilometer-aodh.rst +++ /dev/null @@ -1,324 +0,0 @@ -.. _aodh-install: - -================ -Alarming service -================ - -This section describes how to install and configure the Telemetry Alarming -service, code-named aodh. - -Prerequisites -~~~~~~~~~~~~~ - -Before you install and configure the Alarming service, you must create a -database, service credentials, and API endpoints. - -#. To create the database, complete these steps: - - * Use the database access client to connect to - the database server as the ``root`` user: - - .. code-block:: console - - $ mysql -u root -p - - * Create the ``aodh`` database: - - .. code-block:: console - - CREATE DATABASE aodh; - - * Grant proper access to the ``aodh`` database: - - .. code-block:: console - - GRANT ALL PRIVILEGES ON aodh.* TO 'aodh'@'localhost' \ - IDENTIFIED BY 'AODH_DBPASS'; - GRANT ALL PRIVILEGES ON aodh.* TO 'aodh'@'%' \ - IDENTIFIED BY 'AODH_DBPASS'; - - Replace ``AODH_DBPASS`` with a suitable password. - - * Exit the database access client. - -#. Source the ``admin`` credentials to gain access to admin-only - CLI commands: - - .. code-block:: console - - $ . admin-openrc - -#. To create the service credentials, complete these steps: - - * Create the ``aodh`` user: - - .. code-block:: console - - $ openstack user create --domain default \ - --password-prompt aodh - User Password: - Repeat User Password: - +-----------+----------------------------------+ - | Field | Value | - +-----------+----------------------------------+ - | domain_id | e0353a670a9e496da891347c589539e9 | - | enabled | True | - | id | b7657c9ea07a4556aef5d34cf70713a3 | - | name | aodh | - +-----------+----------------------------------+ - - * Add the ``admin`` role to the ``aodh`` user: - - .. code-block:: console - - $ openstack role add --project service --user aodh admin - - .. note:: - - This command provides no output. - - * Create the ``aodh`` service entity: - - .. code-block:: console - - $ openstack service create --name aodh \ - --description "Telemetry" alarming - +-------------+----------------------------------+ - | Field | Value | - +-------------+----------------------------------+ - | description | Telemetry | - | enabled | True | - | id | 3405453b14da441ebb258edfeba96d83 | - | name | aodh | - | type | alarming | - +-------------+----------------------------------+ - -#. Create the Alarming service API endpoints: - - .. code-block:: console - - $ openstack endpoint create --region RegionOne \ - alarming public http://controller:8042 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 340be3625e9b4239a6415d034e98aace | - | interface | public | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 8c2c7f1b9b5049ea9e63757b5533e6d2 | - | service_name | aodh | - | service_type | alarming | - | url | http://controller:8042 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - alarming internal http://controller:8042 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 340be3625e9b4239a6415d034e98aace | - | interface | internal | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 8c2c7f1b9b5049ea9e63757b5533e6d2 | - | service_name | aodh | - | service_type | alarming | - | url | http://controller:8042 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - alarming admin http://controller:8042 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | 340be3625e9b4239a6415d034e98aace | - | interface | admin | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 8c2c7f1b9b5049ea9e63757b5533e6d2 | - | service_name | aodh | - | service_type | alarming | - | url | http://controller:8042 | - +--------------+----------------------------------+ - -Install and configure components -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. note:: - - Default configuration files vary by distribution. You might need to add - these sections and options rather than modifying existing sections and - options. Also, an ellipsis (...) in the configuration snippets indicates - potential default configuration options that you should retain. - -.. only:: obs - - 1. Install the packages: - - .. code-block:: console - - # zypper install openstack-aodh-api \ - openstack-aodh-evaluator openstack-aodh-notifier \ - openstack-aodh-listener openstack-aodh-expirer \ - python-aodhclient - -.. only:: rdo - - 1. Install the packages: - - .. code-block:: console - - # yum install openstack-aodh-api \ - openstack-aodh-evaluator openstack-aodh-notifier \ - openstack-aodh-listener openstack-aodh-expirer \ - python-ceilometerclient - -.. only:: ubuntu - - 1. Install the packages: - - .. code-block:: console - - # apt-get install aodh-api aodh-evaluator aodh-notifier \ - aodh-listener aodh-expirer python-ceilometerclient - -2. Edit the ``/etc/aodh/aodh.conf`` file and complete the following actions: - - * In the ``[database]`` section, configure database access: - - .. code-block:: ini - - [database] - ... - connection = mysql+pymysql://aodh:AODH_DBPASS@controller/aodh - - Replace ``AODH_DBPASS`` with the password you chose for the - Telemetry Alarming module database. You must escape special characters - such as ':', '/', '+', and '@' in the connection string in accordance - with `RFC2396 `_. - - * In the ``[DEFAULT]`` and ``[oslo_messaging_rabbit]`` sections, - configure ``RabbitMQ`` message queue access: - - .. code-block:: ini - - [DEFAULT] - ... - rpc_backend = rabbit - - [oslo_messaging_rabbit] - ... - rabbit_host = controller - rabbit_userid = openstack - rabbit_password = RABBIT_PASS - - Replace ``RABBIT_PASS`` with the password you chose for the - ``openstack`` account in ``RabbitMQ``. - - * In the ``[DEFAULT]`` and ``[keystone_authtoken]`` sections, - configure Identity service access: - - .. code-block:: ini - - [DEFAULT] - ... - auth_strategy = keystone - - [keystone_authtoken] - ... - auth_uri = http://controller:5000 - auth_url = http://controller:35357 - memcached_servers = controller:11211 - auth_type = password - project_domain_name = default - user_domain_name = default - project_name = service - username = aodh - password = AODH_PASS - - Replace ``AODH_PASS`` with the password you chose for - the ``aodh`` user in the Identity service. - - * In the ``[service_credentials]`` section, configure service credentials: - - .. code-block:: ini - - [service_credentials] - ... - auth_type = password - auth_url = http://controller:5000/v3 - project_domain_name = default - user_domain_name = default - project_name = service - username = aodh - password = AODH_PASS - interface = internalURL - region_name = RegionOne - - Replace ``AODH_PASS`` with the password you chose for - the ``aodh`` user in the Identity service. - -.. todo: - - Workaround for https://bugs.launchpad.net/ubuntu/+source/aodh/+bug/1513599. - -.. only:: ubuntu - - 3. Edit the ``/etc/aodh/api_paste.ini`` file and modify the - ``[filter:authtoken]`` section as follows: - - .. code-block:: ini - - [filter:authtoken] - ... - oslo_config_project = aodh - -Finalize installation -~~~~~~~~~~~~~~~~~~~~~ - -.. only:: obs - - #. Start the Telemetry Alarming services and configure them to start - when the system boots: - - .. code-block:: console - - # systemctl enable openstack-aodh-api.service \ - openstack-aodh-evaluator.service \ - openstack-aodh-notifier.service \ - openstack-aodh-listener.service - # systemctl start openstack-aodh-api.service \ - openstack-aodh-evaluator.service \ - openstack-aodh-notifier.service \ - openstack-aodh-listener.service - -.. only:: rdo - - * Start the Alarming services and configure them to start when the system - boots: - - .. code-block:: console - - # systemctl enable openstack-aodh-api.service \ - openstack-aodh-evaluator.service \ - openstack-aodh-notifier.service \ - openstack-aodh-listener.service - # systemctl start openstack-aodh-api.service \ - openstack-aodh-evaluator.service \ - openstack-aodh-notifier.service \ - openstack-aodh-listener.service - -.. only:: ubuntu - - * Restart the Alarming services: - - .. code-block:: console - - # service aodh-api restart - # service aodh-evaluator restart - # service aodh-notifier restart - # service aodh-listener restart diff --git a/doc/install-guide/source/ceilometer-cinder.rst b/doc/install-guide/source/ceilometer-cinder.rst deleted file mode 100644 index b2096cf64c..0000000000 --- a/doc/install-guide/source/ceilometer-cinder.rst +++ /dev/null @@ -1,61 +0,0 @@ -Enable Block Storage meters -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Telemetry uses notifications to collect Block Storage service meters. -Perform these steps on the controller and Block Storage nodes. - -.. note:: - - Your environment must include the Block Storage service. - -Configure Cinder to use Telemetry ---------------------------------- - -Edit the ``/etc/cinder/cinder.conf`` file and complete the -following actions: - -* In the ``[oslo_messaging_notifications]`` section, configure notifications: - - .. code-block:: ini - - [oslo_messaging_notifications] - ... - driver = messagingv2 - -Finalize installation ---------------------- - -.. only:: obs or rdo - - #. Restart the Block Storage services on the controller node: - - .. code-block:: console - - # systemctl restart openstack-cinder-api.service openstack-cinder-scheduler.service - - #. Restart the Block Storage services on the storage nodes: - - .. code-block:: console - - # systemctl restart openstack-cinder-volume.service - -.. only:: ubuntu or debian - - #. Restart the Block Storage services on the controller node: - - .. code-block:: console - - # service cinder-api restart - # service cinder-scheduler restart - - #. Restart the Block Storage services on the storage nodes: - - .. code-block:: console - - # service cinder-volume restart - -3. Use the ``cinder-volume-usage-audit`` command on Block Storage nodes - to retrieve meters on demand. For more information, see the - `OpenStack Administrator Guide `__. diff --git a/doc/install-guide/source/ceilometer-glance.rst b/doc/install-guide/source/ceilometer-glance.rst deleted file mode 100644 index c09fbeb88c..0000000000 --- a/doc/install-guide/source/ceilometer-glance.rst +++ /dev/null @@ -1,55 +0,0 @@ -Enable Image service meters -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Telemetry uses notifications to collect Image service meters. Perform -these steps on the controller node. - -Configure the Image service to use Telemetry --------------------------------------------- - -* Edit the ``/etc/glance/glance-api.conf`` and - ``/etc/glance/glance-registry.conf`` files and - complete the following actions: - - * In the ``[DEFAULT]``, ``[oslo_messaging_notifications]``, and - ``[oslo_messaging_rabbit]`` sections, configure notifications and RabbitMQ - message broker access: - - .. code-block:: ini - - [DEFAULT] - ... - rpc_backend = rabbit - - [oslo_messaging_notifications] - ... - driver = messagingv2 - - [oslo_messaging_rabbit] - ... - rabbit_host = controller - rabbit_userid = openstack - rabbit_password = RABBIT_PASS - - Replace ``RABBIT_PASS`` with the password you chose for - the ``openstack`` account in ``RabbitMQ``. - -Finalize installation ---------------------- - -.. only:: obs or rdo - - * Restart the Image service: - - .. code-block:: console - - # systemctl restart openstack-glance-api.service openstack-glance-registry.service - -.. only:: ubuntu or debian - - * Restart the Image service: - - .. code-block:: console - - # service glance-registry restart - # service glance-api restart diff --git a/doc/install-guide/source/ceilometer-install.rst b/doc/install-guide/source/ceilometer-install.rst deleted file mode 100644 index 32da24f9a0..0000000000 --- a/doc/install-guide/source/ceilometer-install.rst +++ /dev/null @@ -1,430 +0,0 @@ -Install and configure -~~~~~~~~~~~~~~~~~~~~~ - -This section describes how to install and configure the Telemetry -service, code-named ceilometer, on the controller node. The Telemetry -service collects measurements from most OpenStack services and -optionally triggers alarms. - -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` to install and configure -MongoDB before proceeding further. - -.. only:: obs or ubuntu or debian - - 1. Create the ``ceilometer`` database: - - .. code-block:: console - - # mongo --host controller --eval ' - db = db.getSiblingDB("ceilometer"); - db.addUser({user: "ceilometer", - pwd: "CEILOMETER_DBPASS", - roles: [ "readWrite", "dbAdmin" ]})' - - MongoDB shell version: 2.4.x - connecting to: controller:27017/test - { - "user" : "ceilometer", - "pwd" : "72f25aeee7ad4be52437d7cd3fc60f6f", - "roles" : [ - "readWrite", - "dbAdmin" - ], - "_id" : ObjectId("5489c22270d7fad1ba631dc3") - } - - Replace ``CEILOMETER_DBPASS`` with a suitable password. - - .. note:: - - If the command fails saying you are not authorized to insert a user, - you may need to temporarily comment out the ``auth`` option in - the ``/etc/mongodb.conf`` file, restart the MongoDB service using - ``systemctl restart mongodb``, and try calling the command again. - -.. only:: rdo - - 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. - -2. Source the ``admin`` credentials to gain access to admin-only - CLI commands: - - .. code-block:: console - - $ . admin-openrc - -3. To create the service credentials, complete these steps: - - * Create the ``ceilometer`` user: - - .. code-block:: console - - $ openstack user create --domain default --password-prompt ceilometer - User Password: - Repeat User Password: - +-----------+----------------------------------+ - | Field | Value | - +-----------+----------------------------------+ - | domain_id | e0353a670a9e496da891347c589539e9 | - | enabled | True | - | id | c859c96f57bd4989a8ea1a0b1d8ff7cd | - | name | ceilometer | - +-----------+----------------------------------+ - - * Add the ``admin`` role to the ``ceilometer`` user. - - .. code-block:: console - - $ openstack role add --project service --user ceilometer admin - - .. note:: - - This command provides no output. - - * Create the ``ceilometer`` service entity: - - .. code-block:: console - - $ openstack service create --name ceilometer \ - --description "Telemetry" metering - +-------------+----------------------------------+ - | Field | Value | - +-------------+----------------------------------+ - | description | Telemetry | - | enabled | True | - | id | 5fb7fd1bb2954fddb378d4031c28c0e4 | - | name | ceilometer | - | type | metering | - +-------------+----------------------------------+ - -4. Create the Telemetry service API endpoints: - - .. code-block:: console - - $ openstack endpoint create --region RegionOne \ - metering public http://controller:8777 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | b808b67b848d443e9eaaa5e5d796970c | - | interface | public | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 5fb7fd1bb2954fddb378d4031c28c0e4 | - | service_name | ceilometer | - | service_type | metering | - | url | http://controller:8777 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - metering internal http://controller:8777 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | c7009b1c2ee54b71b771fa3d0ae4f948 | - | interface | internal | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 5fb7fd1bb2954fddb378d4031c28c0e4 | - | service_name | ceilometer | - | service_type | metering | - | url | http://controller:8777 | - +--------------+----------------------------------+ - - $ openstack endpoint create --region RegionOne \ - metering admin http://controller:8777 - +--------------+----------------------------------+ - | Field | Value | - +--------------+----------------------------------+ - | enabled | True | - | id | b2c00566d0604551b5fe1540c699db3d | - | interface | admin | - | region | RegionOne | - | region_id | RegionOne | - | service_id | 5fb7fd1bb2954fddb378d4031c28c0e4 | - | service_name | ceilometer | - | service_type | metering | - | url | http://controller:8777 | - +--------------+----------------------------------+ - -Install and configure components --------------------------------- - -.. only:: obs - - #. Install the packages: - - .. code-block:: console - - # zypper install openstack-ceilometer-api \ - openstack-ceilometer-collector \ - openstack-ceilometer-agent-notification \ - openstack-ceilometer-agent-central python-ceilometerclient - -.. only:: rdo - - #. Install the packages: - - .. code-block:: console - - # yum install openstack-ceilometer-api \ - openstack-ceilometer-collector openstack-ceilometer-notification \ - openstack-ceilometer-central python-ceilometerclient - -.. only:: ubuntu or debian - - #. Install the packages: - - .. code-block:: console - - # apt-get install ceilometer-api ceilometer-collector \ - ceilometer-agent-central ceilometer-agent-notification - python-ceilometerclient - - .. only:: debian - - Respond to prompts for debconf. - .. :doc:`Identity service credentials `, - :doc:`service endpoint registration `, - and :doc:`message broker credentials `. - -2. Edit the ``/etc/ceilometer/ceilometer.conf`` file and complete - the following actions: - - * In the ``[database]`` section, configure database access: - - .. code-block:: ini - - [database] - ... - connection = mongodb://ceilometer:CEILOMETER_DBPASS@controller:27017/ceilometer - - Replace ``CEILOMETER_DBPASS`` with the password you chose for the - Telemetry service database. You must escape special characters such - as ':', '/', '+', and '@' in the connection string in accordance - with `RFC2396 `_. - - .. only:: obs or rdo or ubuntu - - * In the ``[DEFAULT]`` and ``[oslo_messaging_rabbit]`` sections, - configure ``RabbitMQ`` message queue access: - - .. code-block:: ini - - [DEFAULT] - ... - rpc_backend = rabbit - - [oslo_messaging_rabbit] - ... - rabbit_host = controller - rabbit_userid = openstack - rabbit_password = RABBIT_PASS - - Replace ``RABBIT_PASS`` with the password you chose for the - ``openstack`` account in ``RabbitMQ``. - - * In the ``[DEFAULT]`` and ``[keystone_authtoken]`` sections, - configure Identity service access: - - .. code-block:: ini - - [DEFAULT] - ... - auth_strategy = keystone - - [keystone_authtoken] - ... - auth_uri = http://controller:5000 - auth_url = http://controller:35357 - memcached_servers = controller:11211 - auth_type = password - project_domain_name = default - user_domain_name = default - project_name = service - username = ceilometer - password = CEILOMETER_PASS - - Replace ``CEILOMETER_PASS`` with the password you chose for - the ``ceilometer`` user in the Identity service. - - * In the ``[service_credentials]`` section, configure service credentials: - - .. code-block:: ini - - [service_credentials] - ... - auth_type = password - auth_url = http://controller:5000/v3 - project_domain_name = default - user_domain_name = default - project_name = service - username = ceilometer - password = CEILOMETER_PASS - interface = internalURL - region_name = RegionOne - - Replace ``CEILOMETER_PASS`` with the password you chose for - the ``ceilometer`` user in the Identity service. - - .. only:: obs - - * In the ``[collector]`` section, configure the dispatcher: - - .. code-block:: ini - - [collector] - ... - dispatcher = database - -.. only:: obs or rdo or ubuntu - - Configure the Apache HTTP server - -------------------------------- - - .. only:: rdo - - * Create the ``/etc/httpd/conf.d/wsgi-ceilometer.conf`` file with - the following content: - - .. code-block:: apache - - Listen 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 - - - WSGISocketPrefix /var/run/httpd - - .. only:: ubuntu - - #. Create the ``/etc/apache2/sites-available/wsgi-ceilometer.conf`` file - with the following content: - - .. code-block:: apache - - Listen 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/apache2/ceilometer_error.log - CustomLog /var/log/apache2/ceilometer_access.log combined - - - WSGISocketPrefix /var/run/apache2 - - #. Enable the Telemetry service virtual hosts: - - .. code-block:: console - - # a2ensite ceilometer - - .. only:: obs - - * Create the ``/etc/apache2/conf.d/wsgi-ceilometer.conf`` file - with the following content: - - .. code-block:: apache - - Listen 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/apache2/ceilometer_error.log - CustomLog /var/log/apache2/ceilometer_access.log combined - - - WSGISocketPrefix /var/run/apache2 - -Finalize installation ---------------------- - -.. only:: obs - - #. Reload the Apache HTTP server: - - .. code-block:: console - - # systemctl reload apache2.service - - #. Start the Telemetry services and configure them to start when the - system boots: - - .. code-block:: console - - # systemctl enable openstack-ceilometer-agent-notification.service \ - openstack-ceilometer-agent-central.service \ - openstack-ceilometer-collector.service - # systemctl start openstack-ceilometer-agent-notification.service \ - openstack-ceilometer-agent-central.service \ - openstack-ceilometer-collector.service - -.. only:: rdo - - #. 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 - -.. only:: ubuntu - - #. Reload the Apache HTTP server: - - .. code-block:: console - - # service apache2 reload - - #. Restart the Telemetry services: - - .. code-block:: console - - # service ceilometer-agent-central restart - # service ceilometer-agent-notification restart - # service ceilometer-collector restart diff --git a/doc/install-guide/source/ceilometer-next-steps.rst b/doc/install-guide/source/ceilometer-next-steps.rst deleted file mode 100644 index c56e4c10c3..0000000000 --- a/doc/install-guide/source/ceilometer-next-steps.rst +++ /dev/null @@ -1,6 +0,0 @@ -========== -Next steps -========== - -Your OpenStack environment now includes Telemetry. You can -:ref:`launch-instance` or add more services to your environment. diff --git a/doc/install-guide/source/ceilometer-nova.rst b/doc/install-guide/source/ceilometer-nova.rst deleted file mode 100644 index 607365baaf..0000000000 --- a/doc/install-guide/source/ceilometer-nova.rst +++ /dev/null @@ -1,152 +0,0 @@ -Enable Compute service meters -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Telemetry uses a combination of notifications and an agent to collect -Compute meters. Perform these steps on each compute node. - -Install and configure components --------------------------------- - -.. only:: obs - - #. Install the packages: - - .. code-block:: console - - # zypper install openstack-ceilometer-agent-compute - -.. only:: rdo - - #. Install the packages: - - .. code-block:: console - - # yum install openstack-ceilometer-compute python-ceilometerclient python-pecan - -.. only:: ubuntu or debian - - #. Install the packages: - - .. code-block:: console - - # apt-get install ceilometer-agent-compute - -2. Edit the ``/etc/ceilometer/ceilometer.conf`` file and - complete the following actions: - - * In the ``[DEFAULT]`` and ``[oslo_messaging_rabbit]`` sections, - configure ``RabbitMQ`` message queue access: - - .. code-block:: ini - - [DEFAULT] - ... - rpc_backend = rabbit - - [oslo_messaging_rabbit] - ... - rabbit_host = controller - rabbit_userid = openstack - rabbit_password = RABBIT_PASS - - Replace ``RABBIT_PASS`` with the password you chose for the - ``openstack`` account in ``RabbitMQ``. - - * In the ``[DEFAULT]`` and ``[keystone_authtoken]`` sections, - configure Identity service access: - - .. code-block:: ini - - [DEFAULT] - ... - auth_strategy = keystone - - [keystone_authtoken] - ... - auth_uri = http://controller:5000 - auth_url = http://controller:35357 - memcached_servers = controller:11211 - auth_type = password - project_domain_name = default - user_domain_name = default - project_name = service - username = ceilometer - password = CEILOMETER_PASS - - Replace ``CEILOMETER_PASS`` with the password you chose for the - Telemetry service database. - - * In the ``[service_credentials]`` section, configure service - credentials: - - .. code-block:: ini - - [service_credentials] - ... - auth_url = http://controller:5000/v2.0 - username = ceilometer - project_name = service - password = CEILOMETER_PASS - interface = internalURL - region_name = RegionOne - - Replace ``CEILOMETER_PASS`` with the password you chose for - the ``ceilometer`` user in the Identity service. - -Configure Compute to use Telemetry ----------------------------------- - -* Edit the ``/etc/nova/nova.conf`` file and configure - notifications in the ``[DEFAULT]`` section: - - .. code-block:: ini - - [DEFAULT] - ... - instance_usage_audit = True - instance_usage_audit_period = hour - notify_on_state_change = vm_and_task_state - notification_driver = messagingv2 - -Finalize installation ---------------------- - -.. only:: obs - - #. Start the agent and configure it to start when the system boots: - - .. code-block:: console - - # systemctl enable openstack-ceilometer-agent-compute.service - # systemctl start openstack-ceilometer-agent-compute.service - -.. only:: rdo - - #. Start the agent and configure it to start when the system boots: - - .. code-block:: console - - # systemctl enable openstack-ceilometer-compute.service - # systemctl start openstack-ceilometer-compute.service - -.. only:: obs or rdo - - 2. Restart the Compute service: - - .. code-block:: console - - # systemctl restart openstack-nova-compute.service - -.. only:: ubuntu or debian - - #. Restart the agent: - - .. code-block:: console - - # service ceilometer-agent-compute restart - - #. Restart the Compute service: - - .. code-block:: console - - # service nova-compute restart diff --git a/doc/install-guide/source/ceilometer-swift.rst b/doc/install-guide/source/ceilometer-swift.rst deleted file mode 100644 index 5ae4c47e28..0000000000 --- a/doc/install-guide/source/ceilometer-swift.rst +++ /dev/null @@ -1,129 +0,0 @@ -Enable Object Storage meters -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Telemetry uses a combination of polling and notifications to collect -Object Storage meters. - -.. note:: - - Your environment must include the Object Storage service. - -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 - - $ . admin-openrc - -#. Create the ``ResellerAdmin`` role: - - .. code-block:: console - - $ openstack role create ResellerAdmin - +-----------+----------------------------------+ - | Field | Value | - +-----------+----------------------------------+ - | domain_id | None | - | id | 462fa46c13fd4798a95a3bfbe27b5e54 | - | name | ResellerAdmin | - +-----------+----------------------------------+ - -#. Add the ``ResellerAdmin`` role to the ``ceilometer`` user: - - .. code-block:: console - - $ openstack role add --project service --user ceilometer ResellerAdmin - - .. note:: - - This command provides no output. - -Install components ------------------- - -* Install the packages: - - .. only:: ubuntu or debian - - .. code-block:: console - - # apt-get install python-ceilometermiddleware - - .. only:: rdo - - .. code-block:: console - - # yum install python-ceilometermiddleware - - .. only:: obs - - .. code-block:: console - - # zypper install python-ceilometermiddleware - -Configure Object Storage to use Telemetry ------------------------------------------ - -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 = ceilometer catch_errors gatekeeper healthcheck proxy-logging cache container_sync bulk ratelimit authtoken keystoneauth container-quotas account-quotas slo dlo versioned_writes proxy-logging 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``. - -Finalize installation ---------------------- - -.. only:: rdo or obs - - * Restart the Object Storage proxy service: - - .. code-block:: console - - # systemctl restart openstack-swift-proxy.service - -.. only:: ubuntu or debian - - * Restart the Object Storage proxy service: - - .. code-block:: console - - # service swift-proxy restart diff --git a/doc/install-guide/source/ceilometer-verify.rst b/doc/install-guide/source/ceilometer-verify.rst deleted file mode 100644 index 0b8b0053c5..0000000000 --- a/doc/install-guide/source/ceilometer-verify.rst +++ /dev/null @@ -1,68 +0,0 @@ -Verify operation -~~~~~~~~~~~~~~~~ - -Verify operation of the Telemetry service. These steps only include the -Image service meters to reduce clutter. Environments with ceilometer -integration for additional services contain more meters. - -.. note:: - - Perform these steps on the controller node. - -#. Source the ``admin`` credentials to gain access to - admin-only CLI commands: - - .. code-block:: console - - $ . admin-openrc - -#. List available meters: - - .. code-block:: console - - $ ceilometer meter-list - +--------------+-------+-------+--------------------------------------+---------+------------+ - | Name | Type | Unit | Resource ID | User ID | Project ID | - +--------------+-------+-------+--------------------------------------+---------+------------+ - | image | gauge | image | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... | - | image.size | gauge | B | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... | - +--------------+-------+-------+--------------------------------------+---------+------------+ - -#. Download the CirrOS image from the Image service: - - .. code-block:: console - - $ IMAGE_ID=$(glance image-list | grep 'cirros' | awk '{ print $2 }') - $ glance image-download $IMAGE_ID > /tmp/cirros.img - -#. List available meters again to validate detection of the image - download: - - .. code-block:: console - - $ ceilometer meter-list - +----------------+-------+-------+--------------------------------------+---------+------------+ - | Name | Type | Unit | Resource ID | User ID | Project ID | - +----------------+-------+-------+--------------------------------------+---------+------------+ - | image | gauge | image | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... | - | image.download | delta | B | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... | - | image.serve | delta | B | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... | - | image.size | gauge | B | acafc7c0-40aa-4026-9673-b879898e1fc2 | None | cf12a15... | - +----------------+-------+-------+--------------------------------------+---------+------------+ - -#. Retrieve usage statistics from the ``image.download`` meter: - - .. code-block:: console - - $ ceilometer statistics -m image.download -p 60 - +--------+---------------------+---------------------+------------+------------+------------+------------+-------+----------+----------------------------+----------------------------+ - | Period | Period Start | Period End | Max | Min | Avg | Sum | Count | Duration | Duration Start | Duration End | - +--------+---------------------+---------------------+------------+------------+------------+------------+-------+----------+----------------------------+----------------------------+ - | 60 | 2015-04-21T12:21:45 | 2015-04-21T12:22:45 | 13200896.0 | 13200896.0 | 13200896.0 | 13200896.0 | 1 | 0.0 | 2015-04-21T12:22:12.983000 | 2015-04-21T12:22:12.983000 | - +--------+---------------------+---------------------+------------+------------+------------+------------+-------+----------+----------------------------+----------------------------+ - -#. Remove the previously downloaded image file ``/tmp/cirros.img``: - - .. code-block:: console - - $ rm /tmp/cirros.img diff --git a/doc/install-guide/source/ceilometer.rst b/doc/install-guide/source/ceilometer.rst deleted file mode 100644 index 3b46818df8..0000000000 --- a/doc/install-guide/source/ceilometer.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. _install_ceilometer: - -================= -Telemetry service -================= - -.. toctree:: - - common/get_started_telemetry.rst - ceilometer-install.rst - ceilometer-glance.rst - ceilometer-nova.rst - ceilometer-cinder.rst - ceilometer-swift.rst - ceilometer-aodh.rst - ceilometer-verify.rst - ceilometer-next-steps.rst diff --git a/doc/install-guide/source/conf.py b/doc/install-guide/source/conf.py index 93b98682a9..30920a2046 100644 --- a/doc/install-guide/source/conf.py +++ b/doc/install-guide/source/conf.py @@ -101,6 +101,7 @@ exclude_patterns = ['common/cli*', 'common/nova*', 'common/get_started_database_service.rst', 'common/get_started_data_processing.rst', 'common/get_started_orchestration.rst', + 'common/get_started_telemetry.rst', 'common/dashboard_customizing.rst', 'shared/note_configuration_vary_by_distribution.rst'] diff --git a/doc/install-guide/source/environment-nosql-database.rst b/doc/install-guide/source/environment-nosql-database.rst deleted file mode 100644 index dd085d00c0..0000000000 --- a/doc/install-guide/source/environment-nosql-database.rst +++ /dev/null @@ -1,176 +0,0 @@ -.. _environment-nosql-database: - -NoSQL database -~~~~~~~~~~~~~~ - -The Telemetry service uses a NoSQL database to store information. The database -typically runs on the controller node. The procedures in this guide use -MongoDB. - -.. note:: - - The installation of the NoSQL database server is only necessary when - installing the Telemetry service as documented in :ref:`install_ceilometer`. - -Install and configure components --------------------------------- - -.. only:: obs - - 1. Enable the Open Build Service repositories for MongoDB based on - your openSUSE or SLES version: - - On openSUSE: - - .. code-block:: console - - # zypper addrepo -f obs://server:database/openSUSE_Leap_42.1 Database - - On SLES: - - .. code-block:: console - - # zypper addrepo -f obs://server:database/SLE_12_SP1 Database - - .. note:: - - The packages are signed by GPG key ``05905EA8``. You should - verify the fingerprint of the imported GPG key before using it. - - .. code-block:: console - - Key Name: server:database OBS Project - Key Fingerprint: 116EB863 31583E47 E63CDF4D 562111AC 05905EA8 - Key Created: Mon 08 Dec 2014 09:54:12 AM UTC - Key Expires: Wed 15 Feb 2017 09:54:12 AM UTC - - Install the MongoDB package: - - .. code-block:: console - - # zypper install mongodb - -.. only:: rdo - - 1. Install the MongoDB packages: - - .. code-block:: console - - # yum install mongodb-server mongodb - -.. only:: ubuntu - - 1. Install the MongoDB packages: - - .. code-block:: console - - # apt-get install mongodb-server mongodb-clients python-pymongo - -.. only:: obs - - 2. Edit the ``/etc/mongodb.conf`` file and complete the following - actions: - - * Configure the ``bind_ip`` key to use the management interface - IP address of the controller node. - - .. code-block:: ini - - bind_ip = 10.0.0.11 - - * By default, MongoDB creates several 1 GB journal files - in the ``/var/lib/mongodb/journal`` directory. - If you want to reduce the size of each journal file to - 128 MB and limit total journal space consumption to 512 MB, - assert the ``smallfiles`` key: - - .. code-block:: ini - - smallfiles = true - - You can also disable journaling. For more information, see the - `MongoDB manual `__. - -.. only:: rdo - - 2. Edit the ``/etc/mongod.conf`` file and complete the following - actions: - - * Configure the ``bind_ip`` key to use the management interface - IP address of the controller node. - - .. code-block:: ini - - bind_ip = 10.0.0.11 - - * By default, MongoDB creates several 1 GB journal files - in the ``/var/lib/mongodb/journal`` directory. - If you want to reduce the size of each journal file to - 128 MB and limit total journal space consumption to 512 MB, - assert the ``smallfiles`` key: - - .. code-block:: ini - - smallfiles = true - - You can also disable journaling. For more information, see the - `MongoDB manual `__. - -.. only:: ubuntu - - 2. Edit the ``/etc/mongodb.conf`` file and complete the following - actions: - - * Configure the ``bind_ip`` key to use the management interface - IP address of the controller node. - - .. code-block:: ini - - bind_ip = 10.0.0.11 - - * By default, MongoDB creates several 1 GB journal files - in the ``/var/lib/mongodb/journal`` directory. - If you want to reduce the size of each journal file to - 128 MB and limit total journal space consumption to 512 MB, - assert the ``smallfiles`` key: - - .. code-block:: ini - - smallfiles = true - - You can also disable journaling. For more information, see the - `MongoDB manual `__. - -Finalize installation ---------------------- - -.. only:: ubuntu - - * If you change the journaling configuration, stop the MongoDB - service, remove the initial journal files, and start the service: - - .. code-block:: console - - # service mongodb stop - # rm /var/lib/mongodb/journal/prealloc.* - # service mongodb start - -.. only:: rdo - - * Start the MongoDB service and configure it to start when - the system boots: - - .. code-block:: console - - # systemctl enable mongod.service - # systemctl start mongod.service - -.. only:: obs - - * Start the MongoDB service and configure it to start when - the system boots: - - .. code-block:: console - - # systemctl enable mongodb.service - # systemctl start mongodb.service diff --git a/doc/install-guide/source/environment.rst b/doc/install-guide/source/environment.rst index 9947151b5c..5f80776c72 100644 --- a/doc/install-guide/source/environment.rst +++ b/doc/install-guide/source/environment.rst @@ -78,6 +78,5 @@ Operations Guide `_. environment-ntp.rst environment-packages.rst environment-sql-database.rst - environment-nosql-database.rst environment-messaging.rst environment-memcached.rst diff --git a/doc/install-guide/source/index.rst b/doc/install-guide/source/index.rst index 891df2d411..c8cb770fe3 100644 --- a/doc/install-guide/source/index.rst +++ b/doc/install-guide/source/index.rst @@ -89,7 +89,6 @@ Contents cinder.rst manila.rst swift.rst - ceilometer.rst launch-instance.rst .. Pseudo only directive for each distribution used by the build tool.