openstack-manuals/doc/install-guide/source/swift-controller-node.rst

Install and configure the controller node

This section describes how to install and configure the proxy service that handles requests for the account, container, and object services operating on the storage nodes. For simplicity, this guide installs and configures the proxy service on the controller node. However, you can run the proxy service on any node with network connectivity to the storage nodes. Additionally, you can install and configure the proxy service on multiple nodes to increase performance and redundancy. For more information, see the Deployment Guide.

To configure prerequisites

The proxy service relies on an authentication and authorization mechanism such as the Identity service. However, unlike other services, it also offers an internal mechanism that allows it to operate without any other OpenStack services. However, for simplicity, this guide references the Identity service in keystone. Before you configure the Object Storage service, you must create service credentials and an API endpoint.

Note

The Object Storage service does not use an SQL database on the controller node. Instead, it uses distributed SQLite databases on each storage node.

1. Source the admin credentials to gain access to admin-only CLI commands:

   $ source admin-openrc.sh

2. To create the Identity service credentials, complete these steps:

   • Create the swift user:

     $ openstack user create --password-prompt swift
     User Password:
     Repeat User Password:
     +----------+----------------------------------+
     | Field    | Value                            |
     +----------+----------------------------------+
     | email    | None                             |
     | enabled  | True                             |
     | id       | d535e5cbd2b74ac7bfb97db9cced3ed6 |
     | name     | swift                            |
     | username | swift                            |
     +----------+----------------------------------+

   • Add the admin role to the swift user:

     $ openstack role add --project service --user swift admin
     +-------+----------------------------------+
     | Field | Value                            |
     +-------+----------------------------------+
     | id    | cd2cb9a39e874ea69e5d4b896eb16128 |
     | name  | admin                            |
     +-------+----------------------------------+

   • Create the swift service entity:

     $ openstack service create --name swift \
       --description "OpenStack Object Storage" object-store
     +-------------+----------------------------------+
     | Field       | Value                            |
     +-------------+----------------------------------+
     | description | OpenStack Object Storage         |
     | enabled     | True                             |
     | id          | 75ef509da2c340499d454ae96a2c5c34 |
     | name        | swift                            |
     | type        | object-store                     |
     +-------------+----------------------------------+

3. Create the Object Storage service API endpoint:

   $ openstack endpoint create \
     --publicurl 'http://controller:8080/v1/AUTH_%(tenant_id)s' \
     --internalurl 'http://controller:8080/v1/AUTH_%(tenant_id)s' \
     --adminurl http://controller:8080 \
     --region RegionOne \
     object-store
   +--------------+----------------------------------------------+
   | Field        | Value                                        |
   +--------------+----------------------------------------------+
   | adminurl     | http://controller:8080/                      |
   | id           | af534fb8b7ff40a6acf725437c586ebe             |
   | internalurl  | http://controller:8080/v1/AUTH_%(tenant_id)s |
   | publicurl    | http://controller:8080/v1/AUTH_%(tenant_id)s |
   | region       | RegionOne                                    |
   | service_id   | 75ef509da2c340499d454ae96a2c5c34             |
   | service_name | swift                                        |
   | service_type | object-store                                 |
   +--------------+----------------------------------------------+

To install and configure the controller node components

Note

Default configuration files vary by distribution. You might need to add these sections and options rather than modifying existing sections and options. Also, an ellipsis (...) in the configuration snippets indicates potential default configuration options that you should retain.

1. Install the packages:

   Note

   Complete OpenStack environments already include some of these packages.

   ubuntu or debian

   # apt-get install swift swift-proxy python-swiftclient python-keystoneclient \
     python-keystonemiddleware memcached

   rdo

   # yum install openstack-swift-proxy python-swiftclient python-keystone-auth-token \
     python-keystonemiddleware memcached

   obs

   # zypper install openstack-swift-proxy python-swiftclient python-keystoneclient \
     python-keystonemiddleware python-xml memcached

ubuntu or debian

2. Create the /etc/swift directory.

3. Obtain the proxy service configuration file from the Object Storage source repository:

   # curl -o /etc/swift/proxy-server.conf \
     https://git.openstack.org/cgit/openstack/swift/plain/etc/ \
     proxy-server.conf-sample?h=stable/kilo

rdo

2. Obtain the proxy service configuration file from the Object Storage source repository:

   # curl -o /etc/swift/proxy-server.conf \
     https://git.openstack.org/cgit/openstack/swift/plain/etc/ \
     proxy-server.conf-sample?h=stable/kilo

obs

rdo

ubuntu