wade-holler 3a0523a0f4 DOC: Change swift mountpoint to /srv/node

Background: Install Guide commands use
/srv/node mount point for /etc/fstab updates,
however example configuration settings for swift.yml
use /mnt. A new deployer, or one that doesn't
follow all of the instructions closely may use /mnt
for the configuration settings and /srv/node for
/etc/fstab updates. This results in an
unuseable swift subsystem.

Change: Update install guide docs, and swift.yml.example
to utilize /srv/node as the mount point example,
consistent with the install guide example /etc/fstab
updates.

Closes-Bug: 1582043

Change-Id: Ic64d36c7481fb4fdb6122d8578a0a6cf45e6b978

2016-05-16 15:26:50 +00:00

3.8 KiB

Raw Blame History

Home OpenStack-Ansible Installation Guide

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:
```
# 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:

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

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_point parameter 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:

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

3.8 KiB Raw Blame History

Storage devices

3.8 KiB

Raw Blame History