commit 456a816f40c76f435cd0b9e28d26ae2f84961ede Author: Dmitriy Rabotyagov Date: Wed Sep 30 19:41:47 2020 +0300 [doc] Adjust deployment docs Change-Id: Ia31a1c04c4e70d7180eb894f907368d7034ca41d Closes-Bug: #1897343 diff --git a/deploy-guide/source/deploymenthost.rst b/deploy-guide/source/deploymenthost.rst index 0473320..2019db5 100644 --- a/deploy-guide/source/deploymenthost.rst +++ b/deploy-guide/source/deploymenthost.rst @@ -60,7 +60,7 @@ Before you begin, we recommend upgrading your system packages and kernel. .. code-block:: shell-session - # apt install build-essential git ntp ntpdate openssh-server python3-dev sudo + # apt install build-essential git chrony openssh-server python3-dev sudo #. Configure NTP to synchronize with a suitable time source. diff --git a/deploy-guide/source/targethosts-prepare.rst b/deploy-guide/source/targethosts-prepare.rst index bc8ba42..e276ac2 100644 --- a/deploy-guide/source/targethosts-prepare.rst +++ b/deploy-guide/source/targethosts-prepare.rst @@ -27,7 +27,8 @@ installation on target hosts that do not have local (console) access. We also recommend setting your locale to `en_US.UTF-8`. Other locales might work, but they are not tested or supported. -Configure Ubuntu + +Configure Debian ~~~~~~~~~~~~~~~~ #. Update package source lists @@ -42,44 +43,47 @@ Configure Ubuntu # apt dist-upgrade -#. Reboot the host. - -#. Ensure that the kernel version is ``3.13.0-34-generic`` or later: +#. Install additional software packages: .. code-block:: shell-session - # uname -r + # apt install bridge-utils debootstrap ifenslave ifenslave-2.6 \ + lsof lvm2 openssh-server sudo tcpdump vlan python3 + +#. Reboot the host to activate the changes and use the new kernel. -#. Install additional software packages: + +Configure Ubuntu +~~~~~~~~~~~~~~~~ + +#. Update package source lists .. code-block:: shell-session - # apt install bridge-utils debootstrap ifenslave ifenslave-2.6 \ - lsof lvm2 chrony openssh-server sudo tcpdump vlan python3 + # apt update -#. Install the kernel extra package if you have one for your kernel version \ +#. Upgrade the system packages and kernel: .. code-block:: shell-session - # apt install linux-image-extra-$(uname -r) + # apt dist-upgrade -#. Add the appropriate kernel modules to the ``/etc/modules`` file to - enable VLAN and bond interfaces: +#. Install additional software packages: .. code-block:: shell-session - # echo 'bonding' >> /etc/modules - # echo '8021q' >> /etc/modules + # apt install bridge-utils debootstrap openssh-server \ + tcpdump vlan python3 -#. Configure Network Time Protocol (NTP) in ``/etc/chrony/chrony.conf`` to - synchronize with a suitable time source and restart the service: +#. Install the kernel extra package if you have one for your kernel version \ .. code-block:: shell-session - # service chrony restart + # apt install linux-modules-extra-$(uname -r) #. Reboot the host to activate the changes and use the new kernel. + Configure CentOS ~~~~~~~~~~~~~~~~ @@ -97,36 +101,14 @@ Configure CentOS SELinux enabled is not currently supported in OpenStack-Ansible for CentOS/RHEL due to a lack of maintainers for the feature. -#. Reboot the host. - -#. Ensure that the kernel version is ``3.10`` or later: - - .. code-block:: shell-session - - # uname -r #. Install additional software packages: .. code-block:: shell-session - # dnf install iputils lsof lvm2 chrony \ - openssh-server sudo tcpdump python3 - -#. Add the appropriate kernel modules to the ``/etc/modules-load.d`` file to - enable VLAN and bond interfaces: - - .. code-block:: shell-session - - # echo 'bonding' >> /etc/modules-load.d/openstack-ansible.conf - # echo '8021q' >> /etc/modules-load.d/openstack-ansible.conf - -#. Configure Network Time Protocol (NTP) in ``/etc/chrony.conf`` to - synchronize with a suitable time source and start the service: - - .. code-block:: shell-session + # dnf install iputils lsof openssh-server\ + sudo tcpdump python3 - # systemctl enable chronyd.service - # systemctl start chronyd.service #. (Optional) Reduce the kernel log level by changing the printk value in your sysctls: