Merge "[install-guide] Include environment-networking"

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
+

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.

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