15c6967a41
This is needed in order for the devices to be mounted automatically. Change-Id: I4bd87330a06679d88c09daa5e7ab660aabba829a
102 lines
3.8 KiB
ReStructuredText
102 lines
3.8 KiB
ReStructuredText
`Home <index.html>`_ OpenStack-Ansible Swift
|
||
|
||
Storage devices
|
||
===============
|
||
|
||
This section offers a set of prerequisite instructions for setting up
|
||
Object Storage (swift) storage devices. The storage devices must be set up
|
||
before installing swift.
|
||
|
||
**Procedure 5.1. Configuring and mounting storage devices**
|
||
|
||
Object Storage recommends a minimum of three swift hosts
|
||
with five storage disks. The example commands in this procedure
|
||
use the storage devices ``sdc`` through to ``sdg``.
|
||
|
||
#. Determine the storage devices on the node to be used for swift.
|
||
|
||
#. Format each device on the node used for storage with XFS. While
|
||
formatting the devices, add a unique label for each device.
|
||
|
||
Without labels, a failed drive causes mount points to shift and
|
||
data to become inaccessible.
|
||
|
||
For example, create the file systems on the devices using the
|
||
``mkfs`` command:
|
||
|
||
.. code-block:: shell-session
|
||
|
||
# apt-get install xfsprogs
|
||
# mkfs.xfs -f -i size=1024 -L sdc /dev/sdc
|
||
# mkfs.xfs -f -i size=1024 -L sdd /dev/sdd
|
||
# mkfs.xfs -f -i size=1024 -L sde /dev/sde
|
||
# mkfs.xfs -f -i size=1024 -L sdf /dev/sdf
|
||
# mkfs.xfs -f -i size=1024 -L sdg /dev/sdg
|
||
|
||
#. Add the mount locations to the ``fstab`` file so that the storage
|
||
devices are remounted on boot. The following example mount options
|
||
are recommended when using XFS:
|
||
|
||
.. code-block:: shell-session
|
||
|
||
LABEL=sdc /srv/node/sdc xfs noatime,nodiratime,nobarrier,logbufs=8,auto 0 0
|
||
LABEL=sdd /srv/node/sdd xfs noatime,nodiratime,nobarrier,logbufs=8,auto 0 0
|
||
LABEL=sde /srv/node/sde xfs noatime,nodiratime,nobarrier,logbufs=8,auto 0 0
|
||
LABEL=sdf /srv/node/sdf xfs noatime,nodiratime,nobarrier,logbufs=8,auto 0 0
|
||
LABEL=sdg /srv/node/sdg xfs noatime,nodiratime,nobarrier,logbufs=8,auto 0 0
|
||
|
||
#. Create the mount points for the devices using the ``mkdir`` command:
|
||
|
||
.. code-block:: shell-session
|
||
|
||
# mkdir -p /srv/node/sdc
|
||
# mkdir -p /srv/node/sdd
|
||
# mkdir -p /srv/node/sde
|
||
# mkdir -p /srv/node/sdf
|
||
# mkdir -p /srv/node/sdg
|
||
|
||
The mount point is referenced as the ``mount_point`` parameter in
|
||
the ``swift.yml`` file (``/etc/rpc_deploy/conf.d/swift.yml``):
|
||
|
||
.. code-block:: shell-session
|
||
|
||
# mount /srv/node/sdc
|
||
# mount /srv/node/sdd
|
||
# mount /srv/node/sde
|
||
# mount /srv/node/sdf
|
||
# mount /srv/node/sdg
|
||
|
||
To view an annotated example of the ``swift.yml`` file, see
|
||
`this link <https://raw.githubusercontent.com/openstack/openstack-ansible/master/etc/openstack_deploy/conf.d/swift.yml.example>`_.
|
||
|
||
For the following mounted devices:
|
||
|
||
+--------------------------------------+--------------------------------------+
|
||
| Device | Mount location |
|
||
+======================================+======================================+
|
||
| /dev/sdc | /srv/node/sdc |
|
||
+--------------------------------------+--------------------------------------+
|
||
| /dev/sdd | /srv/node/sdd |
|
||
+--------------------------------------+--------------------------------------+
|
||
| /dev/sde | /srv/node/sde |
|
||
+--------------------------------------+--------------------------------------+
|
||
| /dev/sdf | /srv/node/sdf |
|
||
+--------------------------------------+--------------------------------------+
|
||
| /dev/sdg | /srv/node/sdg |
|
||
+--------------------------------------+--------------------------------------+
|
||
|
||
Table: Table 5.1. Mounted devices
|
||
|
||
The entry in the ``swift.yml``:
|
||
|
||
.. code-block:: yaml
|
||
|
||
# drives:
|
||
# - name: sdc
|
||
# - name: sdd
|
||
# - name: sde
|
||
# - name: sdf
|
||
# - name: sdg
|
||
# mount_point: /srv/node
|
||
|