diff --git a/doc/source/install/index.rst b/doc/source/install/index.rst index 59cfdec89..1e8c6cd95 100644 --- a/doc/source/install/index.rst +++ b/doc/source/install/index.rst @@ -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 `_ to install and +configure them. Performing the installation =========================== diff --git a/doc/source/install/offline-install.rst b/doc/source/install/offline-install.rst index ae0dbc380..f5dc44ae0 100644 --- a/doc/source/install/offline-install.rst +++ b/doc/source/install/offline-install.rst @@ -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 diff --git a/doc/source/user/troubleshooting.rst b/doc/source/user/troubleshooting.rst index 4815ff8b8..7f1eaf0b8 100644 --- a/doc/source/user/troubleshooting.rst +++ b/doc/source/user/troubleshooting.rst @@ -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,