From 8b5578c362125d0ec7efdc5742d185b344f892f0 Mon Sep 17 00:00:00 2001 From: Petr Kovar Date: Mon, 25 Jul 2016 18:34:21 +0200 Subject: [PATCH] [install-guide] Include environment-networking environment-networking.rst and edit_hosts_file.txt were left out when swift-specific content was moved from OpenStack Installation Guide to swift install-guide. Change-Id: I334cca0634e3071a7ea285e6ad49ed9baaf7dca8 Partially-Implements: blueprint projectspecificinstallguides Closes-Bug: 1605021 --- install-guide/source/edit_hosts_file.txt | 19 ++++++ .../source/environment-networking.rst | 66 +++++++++++++++++++ install-guide/source/index.rst | 1 + 3 files changed, 86 insertions(+) create mode 100644 install-guide/source/edit_hosts_file.txt create mode 100644 install-guide/source/environment-networking.rst diff --git a/install-guide/source/edit_hosts_file.txt b/install-guide/source/edit_hosts_file.txt new file mode 100644 index 00000000..2e9bc965 --- /dev/null +++ b/install-guide/source/edit_hosts_file.txt @@ -0,0 +1,19 @@ +Edit the ``/etc/hosts`` file to contain the following: + +.. code-block:: none + + # controller + 10.0.0.11 controller + + # compute1 + 10.0.0.31 compute1 + + # block1 + 10.0.0.41 block1 + + # object1 + 10.0.0.51 object1 + + # object2 + 10.0.0.52 object2 + diff --git a/install-guide/source/environment-networking.rst b/install-guide/source/environment-networking.rst new file mode 100644 index 00000000..befb309f --- /dev/null +++ b/install-guide/source/environment-networking.rst @@ -0,0 +1,66 @@ +.. _networking: + +Configure networking +~~~~~~~~~~~~~~~~~~~~ + +Before you start deploying the Object Storage service in your OpenStack +environment, configure networking for two additional storage nodes. + +First node +---------- + +Configure network interfaces +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +* Configure the management interface: + + * IP address: ``10.0.0.51`` + + * Network mask: ``255.255.255.0`` (or ``/24``) + + * Default gateway: ``10.0.0.1`` + +Configure name resolution +^^^^^^^^^^^^^^^^^^^^^^^^^ + +#. Set the hostname of the node to ``object1``. + +#. .. include:: edit_hosts_file.txt + +#. Reboot the system to activate the changes. + +Second node +----------- + +Configure network interfaces +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +* Configure the management interface: + + * IP address: ``10.0.0.52`` + + * Network mask: ``255.255.255.0`` (or ``/24``) + + * Default gateway: ``10.0.0.1`` + +Configure name resolution +^^^^^^^^^^^^^^^^^^^^^^^^^ + +#. Set the hostname of the node to ``object2``. + +#. .. include:: edit_hosts_file.txt + +#. Reboot the system to activate the changes. + +.. warning:: + + Some distributions add an extraneous entry in the ``/etc/hosts`` + file that resolves the actual hostname to another loopback IP + address such as ``127.0.1.1``. You must comment out or remove this + entry to prevent name resolution problems. **Do not remove the + 127.0.0.1 entry.** + +.. note:: + + To reduce complexity of this guide, we add host entries for optional + services regardless of whether you choose to deploy them. diff --git a/install-guide/source/index.rst b/install-guide/source/index.rst index 7869e05f..c6aee024 100644 --- a/install-guide/source/index.rst +++ b/install-guide/source/index.rst @@ -6,6 +6,7 @@ Object Storage service :maxdepth: 2 get_started.rst + environment-networking.rst controller-install.rst storage-install.rst initial-rings.rst