openstack/bifrost
Code Issues Proposed changes

Update docs references for CentOS 8

Browse Source 
Also update the EPEL section to point to the official installation
and configuration guide.

Change-Id: I3149cab5eacb14f4e1b21101b8f0d33797464749
This commit is contained in:
Riccardo Pittau 2020-05-19 16:10:34 +02:00
parent 5d126e3e9e
commit c1c360c023
3 changed files with 21 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
doc/source/install/index.rst
View File

@ -21,8 +21,8 @@ Installation and use of bifrost is split into roughly three steps:
Supported operating systems:
* Ubuntu 16.04, 18.04
* Red Hat Enterprise Linux (RHEL) 7
* CentOS 7
* Red Hat Enterprise Linux (RHEL) 8
* CentOS 8
* Fedora 22
* openSUSE Leap 42.1, 42.2
@ -51,48 +51,37 @@ RHEL
Enable additional repositories (RHEL only)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The ``extras`` and ``optional`` yum repositories must be enabled to satisfy
The ``extras`` and ``optional`` dnf repositories must be enabled to satisfy
bifrost's dependencies. To check::
sudo yum repolist | grep 'optional\|extras'
sudo dnf repolist | grep 'optional\|extras'
To view the status of repositories::
sudo yum repolist all | grep 'optional\|extras'
sudo dnf repolist all | grep 'optional\|extras'
The output will look like this::
!rhui-REGION-rhel-server-debug-extras/7Server/x86_64 Red H disabled
rhui-REGION-rhel-server-debug-optional/7Server/x86_64 Red H disabled
rhui-REGION-rhel-server-extras/7Server/x86_64 Red H disabled
rhui-REGION-rhel-server-optional/7Server/x86_64 Red H disabled
rhui-REGION-rhel-server-source-extras/7Server/x86_64 Red H disabled
rhui-REGION-rhel-server-source-optional/7Server/x86_64 Red H disabled
!rhui-REGION-rhel-server-debug-extras/8Server/x86_64 Red H disabled
rhui-REGION-rhel-server-debug-optional/8Server/x86_64 Red H disabled
rhui-REGION-rhel-server-extras/8Server/x86_64 Red H disabled
rhui-REGION-rhel-server-optional/8Server/x86_64 Red H disabled
rhui-REGION-rhel-server-source-extras/8Server/x86_64 Red H disabled
rhui-REGION-rhel-server-source-optional/8Server/x86_64 Red H disabled
Use the names of the repositories (minus the version and architecture)
to enable them::
sudo yum-config-manager --enable rhui-REGION-rhel-server-optional
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras
sudo dnf config-manager --enable rhui-REGION-rhel-server-optional
sudo dnf config-manager --enable rhui-REGION-rhel-server-extras
Enable the EPEL repository
^^^^^^^^^^^^^^^^^^^^^^^^^^
The Extra Packages for Enterprise Linux (EPEL) repository contains
some of bifrost's dependencies. To enable it, install the
``epel-release`` package as follows::
sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
CentOS
------
Enable the EPEL repository (CentOS)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To enable EPEL on CentOS, run::
sudo yum install epel-release
The Extra Packages for Enterprise Linux (EPEL) are required to install some
dependencies. Please refer to the
`official wiki page <https://fedoraproject.org/wiki/EPEL>`_ to install and
configure them.
Performing the installation
===========================

4
doc/source/install/offline-install.rst
View File

@ -43,8 +43,8 @@ this.
.. code-block:: yaml
ipa_kernel_upstream_url: file:///vagrant/ipa-centos7-master.kernel
ipa_ramdisk_upstream_url: file:///vagrant/ipa-centos7-master.initramfs
ipa_kernel_upstream_url: file:///vagrant/ipa-centos8-master.kernel
ipa_ramdisk_upstream_url: file:///vagrant/ipa-centos8-master.initramfs
cirros_deploy_image_upstream_url: file:///vagrant/cirros-0.4.0-x86_64-disk.img
dib_git_url: file:///vagrant/git/diskimage-builder
ironicclient_git_url: file:///vagrant/git/python-ironicclient

4
doc/source/user/troubleshooting.rst
View File

@ -170,9 +170,9 @@ DIB-based or any other IPA image, you will need to take the following steps:
file and update the ``ipa_kernel_upstream_url`` and
``ipa_kernel_upstream_url`` settings to a new URL.
For DIB-based images, these urls would be,
``https://tarballs.openstack.org/ironic-python-agent/dib/files/ipa-centos7-master.kernel``
``https://tarballs.openstack.org/ironic-python-agent/dib/files/ipa-centos8-master.kernel``
and
``https://tarballs.openstack.org/ironic-python-agent/dib/files/ipa-centos7-master.initramfs``
``https://tarballs.openstack.org/ironic-python-agent/dib/files/ipa-centos8-master.initramfs``
respectively.
#. Execute the installation playbook, and the set files will be automatically
downloaded again. If the files are not removed prior to (re)installation,