From 875a142980b77f2b6eacb3a4d7b8bcb8bb29eacd Mon Sep 17 00:00:00 2001 From: Michele Valsecchi Date: Thu, 2 Apr 2020 19:44:14 +0900 Subject: [PATCH] docs: Encourage usage of UUID inside /etc/fstab in examples Update doc examples to use explicit UUID of devices, instead of using unstable device names. Change-Id: I3a2eb7bbe4b4091d2567897904d939df1df6b251 Closes-Bug: #1817966 --- doc/source/development_saio.rst | 6 +++++- doc/source/install/storage-install-obs.rst | 10 ++++++++-- doc/source/install/storage-install-rdo.rst | 10 ++++++++-- doc/source/install/storage-install-ubuntu-debian.rst | 10 ++++++++-- 4 files changed, 29 insertions(+), 7 deletions(-) diff --git a/doc/source/development_saio.rst b/doc/source/development_saio.rst index ddfeb6bb44..efb6e01231 100644 --- a/doc/source/development_saio.rst +++ b/doc/source/development_saio.rst @@ -135,9 +135,13 @@ another device when creating the VM, and follow these instructions: sudo mkfs.xfs /dev/sdb1 +#. Find the UUID of the new partition:: + + sudo blkid + #. Edit ``/etc/fstab`` and add:: - /dev/sdb1 /mnt/sdb1 xfs noatime,nodiratime,logbufs=8 0 0 + UUID="" /mnt/sdb1 xfs noatime,nodiratime,logbufs=8 0 0 #. Create the Swift data mount point and test that mounting works:: diff --git a/doc/source/install/storage-install-obs.rst b/doc/source/install/storage-install-obs.rst index 3de391ef74..b2a43c72be 100644 --- a/doc/source/install/storage-install-obs.rst +++ b/doc/source/install/storage-install-obs.rst @@ -49,12 +49,18 @@ storage nodes, you must prepare the storage devices. # mkdir -p /srv/node/sdb # mkdir -p /srv/node/sdc +#. Find the UUID of the new partitions: + + .. code-block:: console + + # blkid + #. Edit the ``/etc/fstab`` file and add the following to it: .. code-block:: none - /dev/sdb /srv/node/sdb xfs noatime,nodiratime,logbufs=8 0 2 - /dev/sdc /srv/node/sdc xfs noatime,nodiratime,logbufs=8 0 2 + UUID="" /srv/node/sdb xfs noatime,nodiratime,logbufs=8 0 2 + UUID="" /srv/node/sdc xfs noatime,nodiratime,logbufs=8 0 2 #. Mount the devices: diff --git a/doc/source/install/storage-install-rdo.rst b/doc/source/install/storage-install-rdo.rst index 403b7d01ea..c2bd0543be 100644 --- a/doc/source/install/storage-install-rdo.rst +++ b/doc/source/install/storage-install-rdo.rst @@ -48,12 +48,18 @@ storage nodes, you must prepare the storage devices. # mkdir -p /srv/node/sdb # mkdir -p /srv/node/sdc +#. Find the UUID of the new partitions: + + .. code-block:: console + + # blkid + #. Edit the ``/etc/fstab`` file and add the following to it: .. code-block:: none - /dev/sdb /srv/node/sdb xfs noatime,nodiratime,logbufs=8 0 2 - /dev/sdc /srv/node/sdc xfs noatime,nodiratime,logbufs=8 0 2 + UUID="" /srv/node/sdb xfs noatime,nodiratime,logbufs=8 0 2 + UUID="" /srv/node/sdc xfs noatime,nodiratime,logbufs=8 0 2 #. Mount the devices: diff --git a/doc/source/install/storage-install-ubuntu-debian.rst b/doc/source/install/storage-install-ubuntu-debian.rst index 81af9ac00e..7082cfd657 100644 --- a/doc/source/install/storage-install-ubuntu-debian.rst +++ b/doc/source/install/storage-install-ubuntu-debian.rst @@ -48,12 +48,18 @@ storage nodes, you must prepare the storage devices. # mkdir -p /srv/node/sdb # mkdir -p /srv/node/sdc +#. Find the UUID of the new partitions: + + .. code-block:: console + + # blkid + #. Edit the ``/etc/fstab`` file and add the following to it: .. code-block:: none - /dev/sdb /srv/node/sdb xfs noatime,nodiratime,logbufs=8 0 2 - /dev/sdc /srv/node/sdc xfs noatime,nodiratime,logbufs=8 0 2 + UUID="" /srv/node/sdb xfs noatime,nodiratime,logbufs=8 0 2 + UUID="" /srv/node/sdc xfs noatime,nodiratime,logbufs=8 0 2 #. Mount the devices: