Doc from openstack admin guide #1083
Open
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
seunghun1ee
commented
May 30, 2024
seunghun1ee
commented
May 30, 2024
Alex-Welsh
reviewed
May 30, 2024
This doc will need client specific infromation to be helpful
seunghun1ee
changed the title
seunghun1ee
force-pushed
the
doc-from-openstack-admin-guide
branch
from
d9d7187
to
90a9b23
Compare
seunghun1ee
force-pushed
the
doc-from-openstack-admin-guide
branch
from
90a9b23
to
ac2cafb
Compare
Alex-Welsh
requested changes
Jun 17, 2024
| The short version | ||
| ================= | ||
|
|
||
| #. Create an infrastructure VM for the Wazuh manager, and add it to the wazuh-manager group | ||
| #. Configure the infrastructure VM with kayobe: ``kayobe infra vm host configure`` | ||
| #. Edit your config under | ||
| ``etc/kayobe/inventory/group_vars/wazuh-manager/wazuh-manager``, in | ||
| ``$KAYOBE_CONFIG_PATHinventory/group_vars/wazuh-manager/wazuh-manager``, in |
There was a problem hiding this comment.
Suggested change
| ``$KAYOBE_CONFIG_PATHinventory/group_vars/wazuh-manager/wazuh-manager``, in | |
| ``$KAYOBE_CONFIG_PATH/inventory/group_vars/wazuh-manager/wazuh-manager``, in |
|
|
||
| Those groups are usually defined in ``etc/kayobe/inventory/groups``. | ||
|
|
||
| Running cephadm playbooks |
There was a problem hiding this comment.
nit:
Suggested change
| Running cephadm playbooks | |
| Running Cephadm playbooks |
or
Suggested change
| Running cephadm playbooks | |
| Running ``cephadm`` playbooks |
There was a problem hiding this comment.
Same for other uses of "cephadm"
Comment on lines
+33
to
+42
| - ``cephadm.yml`` - runs the end to end process starting with deployment and | ||
| defining EC profiles/crush rules/pools and users | ||
| - ``cephadm-crush-rules.yml`` - defines Ceph crush rules according | ||
| - ``cephadm-deploy.yml`` - runs the bootstrap/deploy playbook without the | ||
| additional playbooks | ||
| - ``cephadm-ec-profiles.yml`` - defines Ceph EC profiles | ||
| - ``cephadm-gather-keys.yml`` - gather Ceph configuration and keys and populate | ||
| kayobe-config | ||
| - ``cephadm-keys.yml`` - defines Ceph users/keys | ||
| - ``cephadm-pools.yml`` - defines Ceph pools\ |
There was a problem hiding this comment.
The order here has changed a bit since this was written, and there are some new playbooks that run custom commands. The list is here: https://github.com/stackhpc/stackhpc-kayobe-config/blob/stackhpc/2023.1/etc/kayobe/ansible/cephadm.yml
| - ``cephadm-keys.yml`` - defines Ceph users/keys | ||
| - ``cephadm-pools.yml`` - defines Ceph pools\ | ||
|
|
||
| Running Ceph commands |
There was a problem hiding this comment.
I think we should get someone with more Ceph experience to review the rest of this file to check it for accuracy.
| ---------- | ||
|
|
||
| * `Back up InfluxDB <https://docs.influxdata.com/influxdb/v1.8/administration/backup_and_restore/>`__ | ||
| * `Back up ElasticSearch <https://www.elastic.co/guide/en/elasticsearch/reference/current/backup-cluster-data.html>`__ |
There was a problem hiding this comment.
Suggested change
| * `Back up ElasticSearch <https://www.elastic.co/guide/en/elasticsearch/reference/current/backup-cluster-data.html>`__ | |
| * `Back up OpenSearch <https://opensearch.org/docs/latest/tuning-your-cluster/availability-and-recovery/snapshots/snapshot-restore/>`__ |
|
|
||
| .. code-block:: console | ||
|
|
||
| monitoring0# for i in `docker ps -q`; do docker stop $i; done |
There was a problem hiding this comment.
Should use systemctl rather than docker
Comment on lines
+345
to
+358
| Upgrading OpenStack Services | ||
| ---------------------------- | ||
|
|
||
| * Update tags for the images in ``etc/kayobe/kolla-image-tags.yml`` | ||
| * Pull container images to overcloud hosts with ``kayobe overcloud container image pull`` | ||
| * Run ``kayobe overcloud service upgrade`` | ||
|
|
||
| You can update the subset of containers or hosts by | ||
|
|
||
| .. code-block:: console | ||
|
|
||
| kayobe# kayobe overcloud service upgrade --kolla-tags <service> --limit <hostname> --kolla-limit <hostname> | ||
|
|
||
| For more information, see: https://docs.openstack.org/kayobe/latest/upgrading.html |
There was a problem hiding this comment.
I'd probably just delete this section. Full version upgrades require a lot more than this. For container tag bumps, we just use service deploy. Either way, I don't think this section is really that useful
|
|
||
| .. code-block:: console | ||
|
|
||
| openstack server create --flavor <flavour name>--network <network name> --key-name <key> --image <Image name> --os-compute-api-version 2.74 --host <hypervisor hostname> <vm name> |
There was a problem hiding this comment.
Suggested change
| openstack server create --flavor <flavour name>--network <network name> --key-name <key> --image <Image name> --os-compute-api-version 2.74 --host <hypervisor hostname> <vm name> | |
| openstack server create --flavor <flavour name> --network <network name> --key-name <key> --image <Image name> --os-compute-api-version 2.74 --host <hypervisor hostname> <vm name> |
|
|
||
| openstack server create --flavor <flavour name>--network <network name> --key-name <key> --image <Image name> --os-compute-api-version 2.74 --host <hypervisor hostname> <vm name> | ||
|
|
||
| Cleanup Procedures |
There was a problem hiding this comment.
Patch merged and backported long ago. This can be removed
Comment on lines
+116
to
+117
| It can be resolved by dropping cached content with ``docker restart | ||
| memcached``. Note this will log out users from Horizon, as Django sessions are |
There was a problem hiding this comment.
Suggested change
| It can be resolved by dropping cached content with ``docker restart | |
| memcached``. Note this will log out users from Horizon, as Django sessions are | |
| It can be resolved by dropping cached content with ``systemctl restart | |
| kolla-memcached-container.service``. Note this will log out users from Horizon, as Django sessions are |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Moved general operation documentations from Openstack admin guide.
Removed customer specific templatings and tried to generalise.
Updated old contents
Please let me know if there are more contents that need to be updated.
Related PR on Openstack Admin Guide stackhpc/openstack-admin-guide#53