openstack-ansible/doc/source/install-guide/configure-swift-devices.rst

Home OpenStack Ansible Installation Guide

Storage devices

This section offers a set of prerequisite instructions for setting up Object Storage storage devices. The storage devices must be set up before installing Object Storage.

Procedure 5.1. Configuring and mounting storage devices

Object Storage recommends a minimum of three Object Storage hosts with five storage disks. The example commands in this procedure assume the storage devices for Object Storage are devices sdc through sdg.

1. Determine the storage devices on the node to be used for Object Storage.

2. 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 can cause mount points to shift and data to become inaccessible.

   For example, create the file systems on the devices using the mkfs command

   $ 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

3. 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.

   $ LABEL=sdc /srv/node/sdc xfs noatime,nodiratime, \
   nobarrier,logbufs=8,noauto 0 0
   $ LABEL=sdd /srv/node/sdd xfs noatime,nodiratime, \
   nobarrier,logbufs=8,noauto 0 0
   $ LABEL=sde /srv/node/sde xfs noatime,nodiratime, \
   nobarrier,logbufs=8,noauto 0 0
   $ LABEL=sdf /srv/node/sdf xfs noatime,nodiratime, \
   nobarrier,logbufs=8,noauto 0 0
   $ LABEL=sdg /srv/node/sdg xfs noatime,nodiratime, \
   nobarrier,logbufs=8,noauto 0 0

4. Create the mount points for the devices using the mkdir command.

   $ 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_pointparameter in the swift.yml file (/etc/rpc_deploy/conf.d/swift.yml).

   $ 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 Appendix A, *OSA configuration files*.

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 would be:

#    drives:
#        - name: sdc
#        - name: sdd
#        - name: sde
#        - name: sdf
#        - name: sdg
#    mount_point: /mnt

---