Files

Alexandra e78c9e3ac2 DOCS: Configuration section - cleanup

As per discussion in the OSA docs summit session, clean up
of installation guide. This fixes typos, minor RST mark up
changes, and passive voice.

This patch also merges a some of the sections into the larger
chapter. This is in an effort to remove multiple smaller
files.

This patch is the first of many to avoid major conflicts.

Change-Id: I5b6d540bfa691b36dbe9cf909de8e61affb0cd92

2016-05-11 17:37:23 +01: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: /mnt

3.8 KiB Raw Blame History

Storage devices

3.8 KiB

Raw Blame History