From 53fdd3f74eba3337f4c6501d0719a59b1bc19716 Mon Sep 17 00:00:00 2001 From: Ron Stone Date: Fri, 24 Sep 2021 11:07:14 -0400 Subject: [PATCH] Sync NTP before Ansible bootstrap Added note about importance of syncing NTP time before running running Ansibe bootstrap playbook. Patchset 1 updates. Patchset 2 updates. Signed-off-by: Ron Stone Change-Id: Icb68d609d728a9a72f94085d902ec6d63bdd273f Signed-off-by: Ron Stone --- .../aio_duplex_install_kubernetes.rst | 2 ++ .../aio_simplex_install_kubernetes.rst | 2 ++ .../controller_storage_install_kubernetes.rst | 2 ++ .../aio_duplex_install_kubernetes.rst | 2 ++ .../aio_simplex_install_kubernetes.rst | 2 ++ .../controller_storage_install_kubernetes.rst | 2 ++ .../shared/_includes/ntp-update-note.rest | 18 ++++++++++++++++++ 7 files changed, 30 insertions(+) create mode 100644 doc/source/shared/_includes/ntp-update-note.rest diff --git a/doc/source/deploy_install_guides/r5_release/bare_metal/aio_duplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r5_release/bare_metal/aio_duplex_install_kubernetes.rst index 1b183fb96..ae7c4ed1a 100644 --- a/doc/source/deploy_install_guides/r5_release/bare_metal/aio_duplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r5_release/bare_metal/aio_duplex_install_kubernetes.rst @@ -183,6 +183,8 @@ Bootstrap system on controller-0 #. Run the Ansible bootstrap playbook: + .. include:: /shared/_includes/ntp-update-note.rest + :: ansible-playbook /usr/share/ansible/stx-ansible/playbooks/bootstrap.yml diff --git a/doc/source/deploy_install_guides/r5_release/bare_metal/aio_simplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r5_release/bare_metal/aio_simplex_install_kubernetes.rst index 76ff91d21..22813d647 100644 --- a/doc/source/deploy_install_guides/r5_release/bare_metal/aio_simplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r5_release/bare_metal/aio_simplex_install_kubernetes.rst @@ -184,6 +184,8 @@ Bootstrap system on controller-0 #. Run the Ansible bootstrap playbook: + .. include:: /shared/_includes/ntp-update-note.rest + :: ansible-playbook /usr/share/ansible/stx-ansible/playbooks/bootstrap.yml diff --git a/doc/source/deploy_install_guides/r5_release/bare_metal/controller_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r5_release/bare_metal/controller_storage_install_kubernetes.rst index ea871e594..238555f1e 100644 --- a/doc/source/deploy_install_guides/r5_release/bare_metal/controller_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r5_release/bare_metal/controller_storage_install_kubernetes.rst @@ -181,6 +181,8 @@ Bootstrap system on controller-0 #. Run the Ansible bootstrap playbook: + .. include:: /shared/_includes/ntp-update-note.rest + :: ansible-playbook /usr/share/ansible/stx-ansible/playbooks/bootstrap.yml diff --git a/doc/source/deploy_install_guides/r6_release/bare_metal/aio_duplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r6_release/bare_metal/aio_duplex_install_kubernetes.rst index 39bb9bbd7..a1ef853aa 100644 --- a/doc/source/deploy_install_guides/r6_release/bare_metal/aio_duplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r6_release/bare_metal/aio_duplex_install_kubernetes.rst @@ -183,6 +183,8 @@ Bootstrap system on controller-0 #. Run the Ansible bootstrap playbook: + .. include:: /shared/_includes/ntp-update-note.rest + :: ansible-playbook /usr/share/ansible/stx-ansible/playbooks/bootstrap.yml diff --git a/doc/source/deploy_install_guides/r6_release/bare_metal/aio_simplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r6_release/bare_metal/aio_simplex_install_kubernetes.rst index e14ae1c7b..ec8987d34 100644 --- a/doc/source/deploy_install_guides/r6_release/bare_metal/aio_simplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r6_release/bare_metal/aio_simplex_install_kubernetes.rst @@ -184,6 +184,8 @@ Bootstrap system on controller-0 #. Run the Ansible bootstrap playbook: + .. include:: /shared/_includes/ntp-update-note.rest + :: ansible-playbook /usr/share/ansible/stx-ansible/playbooks/bootstrap.yml diff --git a/doc/source/deploy_install_guides/r6_release/bare_metal/controller_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r6_release/bare_metal/controller_storage_install_kubernetes.rst index a1938ea39..3b1369c7f 100644 --- a/doc/source/deploy_install_guides/r6_release/bare_metal/controller_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r6_release/bare_metal/controller_storage_install_kubernetes.rst @@ -181,6 +181,8 @@ Bootstrap system on controller-0 #. Run the Ansible bootstrap playbook: + .. include:: /shared/_includes/ntp-update-note.rest + :: ansible-playbook /usr/share/ansible/stx-ansible/playbooks/bootstrap.yml diff --git a/doc/source/shared/_includes/ntp-update-note.rest b/doc/source/shared/_includes/ntp-update-note.rest new file mode 100644 index 000000000..98121375a --- /dev/null +++ b/doc/source/shared/_includes/ntp-update-note.rest @@ -0,0 +1,18 @@ +.. note:: + Before running the Ansible bootstrap playbook, it is important that you + ensure that controller-0 server time is synchronized correctly. Run the following + command: + + .. code-block:: bash + + # check the current server time + $ date + + # if the current server time is not correct, update with NTP + + # first add nameserver for DNS resolution + $ echo "nameserver 8.8.8.8" >> /etc/resolvconf + $ echo "nameserver 8.8.4.4" >> /etc/resolvconf + + # run ntpdate + $ sudo ntpdate 0.pool.ntp.org 1.pool.ntp.org