Install and configure the storage nodes for Ubuntu and Debian¶

Prerequisites¶

Before you install and configure the Object Storage service on the storage nodes, you must prepare the storage devices.

1. Install the supporting utility packages:

   # apt-get install xfsprogs rsync
   

2. Format the /dev/sdb and /dev/sdc devices as XFS:

   # mkfs.xfs /dev/sdb
   # mkfs.xfs /dev/sdc
   

3. Create the mount point directory structure:

   # mkdir -p /srv/node/sdb
   # mkdir -p /srv/node/sdc
   

4. Edit the /etc/fstab file and add the following to it:

   /dev/sdb /srv/node/sdb xfs noatime,nodiratime,nobarrier,logbufs=8 0 2
   /dev/sdc /srv/node/sdc xfs noatime,nodiratime,nobarrier,logbufs=8 0 2
   

5. Mount the devices:

   # mount /srv/node/sdb
   # mount /srv/node/sdc
   

6. Create or edit the /etc/rsyncd.conf file to contain the following:

   uid = swift
   gid = swift
   log file = /var/log/rsyncd.log
   pid file = /var/run/rsyncd.pid
   address = MANAGEMENT_INTERFACE_IP_ADDRESS
   
   [account]
   max connections = 2
   path = /srv/node/
   read only = False
   lock file = /var/lock/account.lock
   
   [container]
   max connections = 2
   path = /srv/node/
   read only = False
   lock file = /var/lock/container.lock
   
   [object]
   max connections = 2
   path = /srv/node/
   read only = False
   lock file = /var/lock/object.lock
   

   Replace MANAGEMENT_INTERFACE_IP_ADDRESS with the IP address of the management network on the storage node.

   Note

   The rsync service requires no authentication, so consider running it on a private network in production environments.

7. Edit the /etc/default/rsync file and enable the rsync service:

   RSYNC_ENABLE=true
   

8. Start the rsync service:

   # service rsync start
   

Install and configure components¶

1. Install the packages:

   # apt-get install swift swift-account swift-container swift-object
   

2. Obtain the accounting, container, and object service configuration files from the Object Storage source repository:

   # curl -o /etc/swift/account-server.conf https://git.openstack.org/cgit/openstack/swift/plain/etc/account-server.conf-sample?h=stable/newton
   # curl -o /etc/swift/container-server.conf https://git.openstack.org/cgit/openstack/swift/plain/etc/container-server.conf-sample?h=stable/newton
   # curl -o /etc/swift/object-server.conf https://git.openstack.org/cgit/openstack/swift/plain/etc/object-server.conf-sample?h=stable/newton
   

3. Edit the /etc/swift/account-server.conf file and complete the following actions:

   • In the [DEFAULT] section, configure the bind IP address, bind port, user, configuration directory, and mount point directory:

     [DEFAULT]
     ...
     bind_ip = MANAGEMENT_INTERFACE_IP_ADDRESS
     bind_port = 6202
     user = swift
     swift_dir = /etc/swift
     devices = /srv/node
     mount_check = True
     

     Replace MANAGEMENT_INTERFACE_IP_ADDRESS with the IP address of the management network on the storage node.

   • In the [pipeline:main] section, enable the appropriate modules:

     [pipeline:main]
     pipeline = healthcheck recon account-server
     

     Note

     For more information on other modules that enable additional features, see the Deployment Guide.

   • In the [filter:recon] section, configure the recon (meters) cache directory:

     [filter:recon]
     use = egg:swift#recon
     ...
     recon_cache_path = /var/cache/swift
     

4. Edit the /etc/swift/container-server.conf file and complete the following actions:

   • In the [DEFAULT] section, configure the bind IP address, bind port, user, configuration directory, and mount point directory:

     [DEFAULT]
     ...
     bind_ip = MANAGEMENT_INTERFACE_IP_ADDRESS
     bind_port = 6201
     user = swift
     swift_dir = /etc/swift
     devices = /srv/node
     mount_check = True
     

     Replace MANAGEMENT_INTERFACE_IP_ADDRESS with the IP address of the management network on the storage node.

   • In the [pipeline:main] section, enable the appropriate modules:

     [pipeline:main]
     pipeline = healthcheck recon container-server
     

     Note

     For more information on other modules that enable additional features, see the Deployment Guide.

   • In the [filter:recon] section, configure the recon (meters) cache directory:

     [filter:recon]
     use = egg:swift#recon
     ...
     recon_cache_path = /var/cache/swift
     

5. Edit the /etc/swift/object-server.conf file and complete the following actions:

   • In the [DEFAULT] section, configure the bind IP address, bind port, user, configuration directory, and mount point directory:

     [DEFAULT]
     ...
     bind_ip = MANAGEMENT_INTERFACE_IP_ADDRESS
     bind_port = 6200
     user = swift
     swift_dir = /etc/swift
     devices = /srv/node
     mount_check = True
     

     Replace MANAGEMENT_INTERFACE_IP_ADDRESS with the IP address of the management network on the storage node.

   • In the [pipeline:main] section, enable the appropriate modules:

     [pipeline:main]
     pipeline = healthcheck recon object-server
     

     Note

     For more information on other modules that enable additional features, see the Deployment Guide.

   • In the [filter:recon] section, configure the recon (meters) cache and lock directories:

     [filter:recon]
     use = egg:swift#recon
     ...
     recon_cache_path = /var/cache/swift
     recon_lock_path = /var/lock
     

6. Ensure proper ownership of the mount point directory structure:

   # chown -R swift:swift /srv/node
   

7. Create the recon directory and ensure proper ownership of it:

   # mkdir -p /var/cache/swift
   # chown -R root:swift /var/cache/swift
   # chmod -R 775 /var/cache/swift