b7c8b5e746
The "Default configuration files vary by distribution." note is duplicated in a lot of files. This patch moves this note into a separate file and includes this file in all files using this note. Change-Id: Ie61e378a217539259180f2e56282b137dd8aa30a
186 lines
6.9 KiB
ReStructuredText
186 lines
6.9 KiB
ReStructuredText
=====================
|
|
Finalize installation
|
|
=====================
|
|
|
|
**Configure hashes and default storage policy**
|
|
|
|
.. include:: shared/note_configuration_vary_by_distribution.rst
|
|
|
|
.. only:: ubuntu or rdo or debian
|
|
|
|
#. Obtain the :file:`/etc/swift/swift.conf` file from the Object
|
|
Storage source repository:
|
|
|
|
.. code-block:: console
|
|
|
|
# curl -o /etc/swift/swift.conf \
|
|
https://git.openstack.org/cgit/openstack/swift/plain/etc/swift.conf-sample?h=stable/kilo
|
|
|
|
#. Edit the :file:`/etc/swift/swift.conf` file and complete the following
|
|
actions:
|
|
|
|
a. In the ``[swift-hash]`` section, configure the hash path prefix and
|
|
suffix for your environment.
|
|
|
|
.. code-block:: ini
|
|
:linenos:
|
|
|
|
[swift-hash]
|
|
...
|
|
swift_hash_path_suffix = HASH_PATH_PREFIX
|
|
swift_hash_path_prefix = HASH_PATH_SUFFIX
|
|
|
|
Replace HASH_PATH_PREFIX and HASH_PATH_SUFFIX with unique values.
|
|
|
|
.. warning::
|
|
|
|
Keep these values secret and do not change or lose them.
|
|
|
|
b. In the ``[storage-policy:0]`` section, configure the default
|
|
storage policy:
|
|
|
|
.. code-block:: ini
|
|
:linenos:
|
|
|
|
[storage-policy:0]
|
|
...
|
|
name = Policy-0
|
|
default = yes
|
|
|
|
#. Copy the :file:`swift.conf` file to the :file:`/etc/swift` directory on
|
|
each storage node and any additional nodes running the proxy service.
|
|
|
|
.. only:: obs
|
|
|
|
#. Edit the :file:`/etc/swift/swift.conf` file and complete the following
|
|
actions:
|
|
|
|
a. In the ``[swift-hash]`` section, configure the hash path prefix and
|
|
suffix for your environment.
|
|
|
|
.. code-block:: ini
|
|
:linenos:
|
|
|
|
[swift-hash]
|
|
...
|
|
swift_hash_path_suffix = HASH_PATH_PREFIX
|
|
swift_hash_path_prefix = HASH_PATH_SUFFIX
|
|
|
|
Replace HASH_PATH_PREFIX and HASH_PATH_SUFFIX with unique values.
|
|
|
|
.. warning::
|
|
|
|
Keep these values secret and do not change or lose them.
|
|
|
|
b. In the ``[storage-policy:0]`` section, configure the default
|
|
storage policy:
|
|
|
|
.. code-block:: ini
|
|
:linenos:
|
|
|
|
[storage-policy:0]
|
|
...
|
|
name = Policy-0
|
|
default = yes
|
|
|
|
#. Copy the :file:`swift.conf` file to the :file:`/etc/swift` directory on
|
|
each storage node and any additional nodes running the proxy service.
|
|
|
|
.. only:: ubuntu or debian
|
|
|
|
4. On all nodes, ensure proper ownership of the configuration directory:
|
|
|
|
.. code-block:: console
|
|
|
|
# chown -R swift:swift /etc/swift
|
|
|
|
5. On the controller node and any other nodes running the proxy service,
|
|
restart the Object Storage proxy service including its dependencies:
|
|
|
|
.. code-block:: console
|
|
|
|
# service memcached restart
|
|
# service swift-proxy restart
|
|
|
|
6. On the storage nodes, start the Object Storage services:
|
|
|
|
.. code-block:: console
|
|
|
|
# swift-init all start
|
|
|
|
.. note::
|
|
|
|
The storage node runs many Object Storage services and the
|
|
:command:`swift-init` command makes them easier to manage.
|
|
You can ignore errors from services not running on the storage node.
|
|
|
|
.. only:: rdo
|
|
|
|
4. On all nodes, ensure proper ownership of the configuration directory:
|
|
|
|
.. code-block:: console
|
|
|
|
# chown -R swift:swift /etc/swift
|
|
|
|
5. On the controller node and any other nodes running the proxy service,
|
|
start the Object Storage proxy service including its dependencies and
|
|
configure them to start when the system boots:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable openstack-swift-proxy.service memcached.service
|
|
# systemctl start openstack-swift-proxy.service memcached.service
|
|
|
|
6. On the storage nodes, start the Object Storage services and configure
|
|
them to start when the system boots:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable openstack-swift-account.service openstack-swift-account-auditor.service \
|
|
openstack-swift-account-reaper.service openstack-swift-account-replicator.service
|
|
# systemctl start openstack-swift-account.service openstack-swift-account-auditor.service \
|
|
openstack-swift-account-reaper.service openstack-swift-account-replicator.service
|
|
# systemctl enable openstack-swift-container.service openstack-swift-container-auditor.service \
|
|
openstack-swift-container-replicator.service openstack-swift-container-updater.service
|
|
# systemctl start openstack-swift-container.service openstack-swift-container-auditor.service \
|
|
openstack-swift-container-replicator.service openstack-swift-container-updater.service
|
|
# systemctl enable openstack-swift-object.service openstack-swift-object-auditor.service \
|
|
openstack-swift-object-replicator.service openstack-swift-object-updater.service
|
|
# systemctl start openstack-swift-object.service openstack-swift-object-auditor.service \
|
|
openstack-swift-object-replicator.service openstack-swift-object-updater.service
|
|
|
|
.. only:: obs
|
|
|
|
3. On all nodes, ensure proper ownership of the configuration directory:
|
|
|
|
.. code-block:: console
|
|
|
|
# chown -R swift:swift /etc/swift
|
|
|
|
4. On the controller node and any other nodes running the proxy service,
|
|
start the Object Storage proxy service including its dependencies and
|
|
configure them to start when the system boots:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable openstack-swift-proxy.service memcached.service
|
|
# systemctl start openstack-swift-proxy.service memcached.service
|
|
|
|
5. On the storage nodes, start the Object Storage services and configure
|
|
them to start when the system boots:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable openstack-swift-account.service openstack-swift-account-auditor.service \
|
|
openstack-swift-account-reaper.service openstack-swift-account-replicator.service
|
|
# systemctl start openstack-swift-account.service openstack-swift-account-auditor.service \
|
|
openstack-swift-account-reaper.service openstack-swift-account-replicator.service
|
|
# systemctl enable openstack-swift-container.service openstack-swift-container-auditor.service \
|
|
openstack-swift-container-replicator.service openstack-swift-container-updater.service
|
|
# systemctl start openstack-swift-container.service openstack-swift-container-auditor.service \
|
|
openstack-swift-container-replicator.service openstack-swift-container-updater.service
|
|
# systemctl enable openstack-swift-object.service openstack-swift-object-auditor.service \
|
|
openstack-swift-object-replicator.service openstack-swift-object-updater.service
|
|
# systemctl start openstack-swift-object.service openstack-swift-object-auditor.service \
|
|
openstack-swift-object-replicator.service openstack-swift-object-updater.service
|