diff --git a/source/hardware_inventory_management.rst b/source/hardware_inventory_management.rst index ff51840..6e5e5df 100644 --- a/source/hardware_inventory_management.rst +++ b/source/hardware_inventory_management.rst @@ -76,7 +76,7 @@ We can then provision and configure them: :substitutions: kayobe# kayobe overcloud provision --limit |hypervisor_hostname| - kayobe# kayobe overcloud host configure --limit |hypervisor_hostname| --kolla-limit |hypervisor_hostname| + kayobe# kayobe overcloud host configure --limit |hypervisor_hostname| kayobe# kayobe overcloud service deploy --limit |hypervisor_hostname| --kolla-limit |hypervisor_hostname| Replacing a Failing Hypervisor diff --git a/source/include/ceph_ansible.rst b/source/include/ceph_ansible.rst index 26a3b49..46e9baf 100644 --- a/source/include/ceph_ansible.rst +++ b/source/include/ceph_ansible.rst @@ -67,7 +67,7 @@ Apply LVM configuration using Kayobe for the replaced device (here on ``storage- .. code-block:: console - kayobe$ kayobe overcloud host configure -t lvm -kt none -l storage-0 -kl storage-0 + kayobe$ kayobe overcloud host configure -t lvm -l storage-0 Before running Ceph-Ansible, also remove vestigial state directory from ``/var/lib/ceph/osd`` for the purged OSD diff --git a/source/operations_and_monitoring.rst b/source/operations_and_monitoring.rst index f265d36..209cf3c 100644 --- a/source/operations_and_monitoring.rst +++ b/source/operations_and_monitoring.rst @@ -4,22 +4,22 @@ Operations and Monitoring ========================= -Access to Kibana -================ +Access to OpenSearch Dashboards +=============================== OpenStack control plane logs are aggregated from all servers by Fluentd and -stored in ElasticSearch. The control plane logs can be accessed from -ElasticSearch using Kibana, which is available at the following URL: -|kibana_url| +stored in OpenSearch. The control plane logs can be accessed from +OpenSearch using OpenSearch Dashboards, which is available at the following URL: +|opensearch_dashboards_url| -To log in, use the ``kibana`` user. The password is auto-generated by +To log in, use the ``opensearch`` user. The password is auto-generated by Kolla-Ansible and can be extracted from the encrypted passwords file (|kolla_passwords|): .. code-block:: console :substitutions: - kayobe# ansible-vault view ${KAYOBE_CONFIG_PATH}/kolla/passwords.yml --vault-password-file |vault_password_file_path| | grep ^kibana + kayobe# ansible-vault view ${KAYOBE_CONFIG_PATH}/kolla/passwords.yml --vault-password-file |vault_password_file_path| | grep ^opensearch_dashboards Access to Grafana ================= @@ -293,7 +293,7 @@ Monitoring ---------- * `Back up InfluxDB `__ -* `Back up ElasticSearch `__ +* `Back up OpenSearch `__ * `Back up Prometheus `__ Seed @@ -309,8 +309,8 @@ Ansible control host Control Plane Monitoring ======================== -The control plane has been configured to collect logs centrally using the EFK -stack (Elasticsearch, Fluentd and Kibana). +The control plane has been configured to collect logs centrally using the FOOD +stack (Fluentd, OpenSearch and OpenSearch Dashboards). Telemetry monitoring of the control plane is performed by Prometheus. Metrics are collected by Prometheus exporters, which are either running on all hosts @@ -508,7 +508,8 @@ Overview * Remove the node from maintenance mode in bifrost * Bifrost should automatically power on the node via IPMI * Check that all docker containers are running -* Check Kibana for any messages with log level ERROR or equivalent +* Check OpenSearch Dashboards for any messages with log level ERROR or + equivalent Controllers ----------- @@ -647,28 +648,25 @@ perform the following cleanup procedure regularly: fi done -Elasticsearch indexes retention +OpenSearch indexes retention =============================== -To enable and alter default rotation values for Elasticsearch Curator, edit +To alter default rotation values for OpenSearch, edit ``${KAYOBE_CONFIG_PATH}/kolla/globals.yml``: .. code-block:: console - # Allow Elasticsearch Curator to apply a retention policy to logs - enable_elasticsearch_curator: true - - # Duration after which index is closed - elasticsearch_curator_soft_retention_period_days: 90 + # Duration after which index is closed (default 30) + opensearch_soft_retention_period_days: 90 - # Duration after which index is deleted - elasticsearch_curator_hard_retention_period_days: 180 + # Duration after which index is deleted (default 60) + opensearch_hard_retention_period_days: 180 -Reconfigure Elasticsearch with new values: +Reconfigure Opensearch with new values: .. code-block:: console - kayobe overcloud service reconfigure --kolla-tags elasticsearch + kayobe overcloud service reconfigure --kolla-tags opensearch For more information see the `upstream documentation -`__. +`__. diff --git a/source/vars.rst b/source/vars.rst index de649d3..96bec49 100644 --- a/source/vars.rst +++ b/source/vars.rst @@ -25,7 +25,7 @@ .. |kayobe_source_url| replace:: https://github.com/acme-openstack/kayobe.git .. |kayobe_source_version| replace:: ``acme/yoga`` .. |keystone_public_url| replace:: https://openstack.acme.example:5000 -.. |kibana_url| replace:: https://openstack.acme.example:5601 +.. |opensearch_dashboards_url| replace:: https://openstack.acme.example:5601 .. |kolla_passwords| replace:: https://github.com/acme-openstack/kayobe-config/blob/acme/yoga/etc/kayobe/kolla/passwords.yml .. |monitoring_host| replace:: ``mon0`` .. |network_name| replace:: admin-vxlan