From 48eaf4cc33a4b8b75d6e9349d7554f6b65e1bf7b Mon Sep 17 00:00:00 2001 From: Brendan Shephard Date: Wed, 2 Nov 2022 15:13:36 +1000 Subject: [PATCH] Update docs for CentOS9 We still suggest installing on CentOS 8 Stream. This wouldn't be expected to work as we have moved to CentOS Stream 9 (aka. CentOS 9) for master now. This patch updates our install guide for CentOS 9. Note that there are still remaining reference to CentOS 8 Stream, but this change aims to fix what we can fix easily now. Change-Id: Icb8c584e1a62278ca2d8239a83f603c2e90ec03a --- deploy-guide/source/deployment/3rd_party.rst | 6 +-- .../source/deployment/architecture.rst | 8 ++-- .../source/deployment/install_overcloud.rst | 47 ++++++++++--------- .../source/deployment/tips_tricks.rst | 14 ------ .../source/environments/baremetal.rst | 6 +-- .../features/deploy_cellv2_manage_cell.rst | 6 +-- deploy-guide/source/repositories.rst | 10 ++-- 7 files changed, 41 insertions(+), 56 deletions(-) diff --git a/deploy-guide/source/deployment/3rd_party.rst b/deploy-guide/source/deployment/3rd_party.rst index e7925ba9..eb6194df 100644 --- a/deploy-guide/source/deployment/3rd_party.rst +++ b/deploy-guide/source/deployment/3rd_party.rst @@ -293,7 +293,7 @@ Configure Kolla to build images for TripleO, in `/etc/kolla/kolla-build.conf`:: registry=192.168.24.1:8787 tag=latest template_override=/usr/share/tripleo-common/container-images/tripleo_kolla_template_overrides.j2 - rpm_setup_config=http://trunk.rdoproject.org/centos7/current-tripleo/delorean.repo,http://trunk.rdoproject.org/centos7/delorean-deps.repo + rpm_setup_config=http://trunk.rdoproject.org/centos9/current-tripleo/delorean.repo,http://trunk.rdoproject.org/centos9/delorean-deps.repo push=True Use the following command to build all of the container images used in TripleO:: @@ -302,10 +302,6 @@ Use the following command to build all of the container images used in TripleO:: --config-file /usr/share/tripleo-common/container-images/overcloud_containers.yaml \ --kolla-config-file /etc/kolla/kolla-build.conf -.. note:: Add --use-buildah argument to use Buildah instead of Docker. - It'll be the default once CentOS8 becomes the testing platform during the Train cycle - and onward. - Or use `kolla-build` to build the images yourself, which provides more flexibility and allows you to rebuild selectively just the images matching a given name, for example to build only the heat images with the TripleO diff --git a/deploy-guide/source/deployment/architecture.rst b/deploy-guide/source/deployment/architecture.rst index 7d2d9e62..528531c0 100644 --- a/deploy-guide/source/deployment/architecture.rst +++ b/deploy-guide/source/deployment/architecture.rst @@ -32,11 +32,9 @@ containerized stateful services, like the messaging system or database. .. _Containerd: https://github.com/containerd/containerd .. _Bundle: https://wiki.clusterlabs.org/wiki/Bundle_Walk-Through -Currently we provide a ``ContainerCli`` parameter which can be used to switch -between podman and docker container runtimes. The default for the undercloud -is podman, while the default for the overcloud is docker due to pacemaker -limitations when running under CentOS 7. We expect to switch to podman by -default for the overcloud once CentOS 8 becomes the default. +Currently we provide a ``ContainerCli`` parameter which can be used to change +the container runtimes, but only podman is supported for both undercloud and +overcloud. We have provided various ``Container*`` configuration parameters in TripleO Heat Templates for operators to tune some of the container based settings. diff --git a/deploy-guide/source/deployment/install_overcloud.rst b/deploy-guide/source/deployment/install_overcloud.rst index a474d145..d3a805ee 100644 --- a/deploy-guide/source/deployment/install_overcloud.rst +++ b/deploy-guide/source/deployment/install_overcloud.rst @@ -56,7 +56,7 @@ Get Images delete the older images and restart the process from this step. Alternatively, images are available via RDO at - https://images.rdoproject.org/centos8/master/rdo_trunk/ which offers images from both the + https://images.rdoproject.org/centos9/master/rdo_trunk/ which offers images from both the CentOS Build System (cbs) and RDO Trunk (called rdo_trunk or delorean). However this mirror is slow so if you experience slow download speeds you should skip to building the images instead. @@ -85,35 +85,35 @@ created on the undercloud, one should use a non-root user. .. admonition:: CentOS :class: centos - The image build with no arguments will build CentOS 7. It will include the + The image build with no arguments will build CentOS 8. It will include the common YAML of - ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images.yaml`` + ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml`` and the CentOS YAML at - ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos7.yaml``. + ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos8.yaml``. - .. admonition:: CentOS 8 - :class: centos8 + .. admonition:: CentOS 9 + :class: centos9 - The default YAML for Centos 8 is - ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos8.yaml`` + The default YAML for Centos 9 is + ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos9.yaml`` :: - export OS_YAML="/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos8.yaml" + export OS_YAML="/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos9.yaml" .. admonition:: RHEL :class: rhel The common YAML is - ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images.yaml``. + ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml``. It must be specified along with the following. The default YAML for RHEL is - ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel7.yaml`` + ``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel8.yaml`` :: - export OS_YAML="/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel7.yaml" + export OS_YAML="/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel8.yaml" #. Install the ``current-tripleo`` delorean repository and deps repository: @@ -134,8 +134,8 @@ created on the undercloud, one should use a non-root user. export DIB_YUM_REPO_CONF="$DIB_YUM_REPO_CONF /etc/yum.repos.d/tripleo-centos-ceph*.repo" - .. admonition:: CentOS 8 - :class: centos8 + .. admonition:: CentOS 9 + :class: centos9 :: @@ -235,20 +235,25 @@ created on the undercloud, one should use a non-root user. .. - .. admonition:: RHEL - :class: rhel + .. admonition:: RHEL 9 + :class: rhel9 :: - openstack overcloud image build --config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images.yaml --config-file $OS_YAML + openstack overcloud image build \ + --config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml \ + --config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel9.yaml \ + --config-file $OS_YAML - .. admonition:: CentOS 8 - :class: centos8 + .. admonition:: CentOS 9 + :class: centos9 :: - openstack overcloud image build --config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml --config-file $OS_YAML - + openstack overcloud image build \ + --config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml \ + --config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos9.yaml \ + --config-file $OS_YAML See the help for ``openstack overcloud image build`` for further options. diff --git a/deploy-guide/source/deployment/tips_tricks.rst b/deploy-guide/source/deployment/tips_tricks.rst index 7cd1ce79..d89ab2c2 100644 --- a/deploy-guide/source/deployment/tips_tricks.rst +++ b/deploy-guide/source/deployment/tips_tricks.rst @@ -15,20 +15,6 @@ Prior to Stein, containerized OpenStack deployments used Docker. Starting with the Stein release, Docker is no longer part of OpenStack, and Podman has taken its place. The notes here are regarding Stein and later. -sudo ----- - -On CentOS 7, podman cannot function with administrative privileges due to -user namespaces not being enabled in an older kernel. The workaround is -simply to run podman commands with sudo as a prefix. - -If you see the following, simply remember to add sudo to your command:: - - $ podman ps - cannot clone: Invalid argument - user namespaces are not enabled in /proc/sys/user/max_user_namespaces - ERRO[0000] cannot re-exec process - Monitoring containers --------------------- diff --git a/deploy-guide/source/environments/baremetal.rst b/deploy-guide/source/environments/baremetal.rst index a1d0b762..b058ecb1 100644 --- a/deploy-guide/source/environments/baremetal.rst +++ b/deploy-guide/source/environments/baremetal.rst @@ -39,8 +39,8 @@ in its glance, one time in /var/lib subdirectories for PXE/TFTP). TripleO is supporting only the following operating systems: -* RHEL 8 (x86_64) -* CentOS8 Stream (x86_64) +* RHEL 9 (x86_64) +* CentOS Stream 9 (x86_64) Please also ensure your node clock is set to UTC in order to prevent any issue when the OS hwclock syncs to the BIOS clock before applying timezone offset, @@ -87,7 +87,7 @@ Setting Up The Undercloud Machine #. Select a machine within the baremetal environment on which to install the undercloud. -#. Install RHEL 8 x86_64 or CentOS 8 Stream x86_64 on this machine. +#. Install RHEL 9 x86_64 or CentOS Stream 9 x86_64 on this machine. #. If needed, create a non-root user with sudo access to use for installing the Undercloud:: diff --git a/deploy-guide/source/features/deploy_cellv2_manage_cell.rst b/deploy-guide/source/features/deploy_cellv2_manage_cell.rst index 3dcd9b85..703e8430 100644 --- a/deploy-guide/source/features/deploy_cellv2_manage_cell.rst +++ b/deploy-guide/source/features/deploy_cellv2_manage_cell.rst @@ -73,7 +73,8 @@ Delete a compute from a cell .. code-block:: bash - sudo yum install python2-osc-placement + sudo dnf install python3-osc-placement + source overcloudrc openstack resource provider list +--------------------------------------+---------------------------------------+------------+ | uuid | name | generation | @@ -152,11 +153,10 @@ Delete a cell This step is required as otherwise adding a compute node with the same hostname will make it to fail to register as a resource with the placement service. - In case of Centos/RHEL 8 the required packages is `python3-osc-placement`: .. code-block:: bash - sudo yum install python2-osc-placement + sudo dnf install python3-osc-placement source overcloudrc openstack resource provider list +--------------------------------------+---------------------------------------+------------+ diff --git a/deploy-guide/source/repositories.rst b/deploy-guide/source/repositories.rst index 5bd8e015..f7d656ef 100644 --- a/deploy-guide/source/repositories.rst +++ b/deploy-guide/source/repositories.rst @@ -2,19 +2,19 @@ .. note:: Python3 is required for current releases of OpenStack which is - supported on CentOS Stream 8. + supported on CentOS Stream 9. #. Download and install the python-tripleo-repos RPM from the appropriate RDO repository - .. admonition:: CentOS Stream 8 - :class: centos8 + .. admonition:: CentOS Stream 9 + :class: centos9 - Current `Centos 8 RDO repository `_. + Current `Centos 9 RDO repository `_. .. code-block:: bash - sudo dnf install -y https://trunk.rdoproject.org/centos8/component/tripleo/current/python3-tripleo-repos-.el8.noarch.rpm + sudo dnf install -y https://trunk.rdoproject.org/centos9/component/tripleo/current/python3-tripleo-repos-.el9.noarch.rpm .. note::