[install] General edits for install guide

* Update links to point to pike content
* Improve titles and ToC
* Remove Debian
* Fix formatting
* Update repo url for Pike
* Edit openstack-services

Change-Id: I258d6ce980b0b3408d88b40e487f3079c2b55cdb
This commit is contained in:
Petr Kovar 2017-08-28 19:33:22 +02:00 committed by Emma Foley
parent b44da4c032
commit 7c7791c66d
30 changed files with 239 additions and 376 deletions

View File

@ -1,5 +1,5 @@
SUSE Memcached
~~~~~~~~~~~~~~
Memcached for SUSE
~~~~~~~~~~~~~~~~~~
The Identity service authentication mechanism for services uses Memcached
to cache tokens. The memcached service typically runs on the controller
@ -11,18 +11,11 @@ Install and configure components
#. Install the packages:
.. code-block:: console
.. code-block:: console
# zypper install memcached python-python-memcached
.. end
.. end
2. Edit the ``/etc/sysconfig/memcached`` file and complete the
following actions:
@ -41,12 +34,9 @@ Install and configure components
Change the existing line ``MEMCACHED_PARAMS="-l 127.0.0.1,::1"``.
Finalize installation
---------------------
* Start the Memcached service and configure it to start when the system
boots:
@ -56,4 +46,3 @@ Finalize installation
# systemctl start memcached.service
.. end

View File

@ -1,5 +1,5 @@
Red Hat Memcached
~~~~~~~~~~~~~~~~~
Memcached for RHEL and CentOS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The Identity service authentication mechanism for services uses Memcached
to cache tokens. The memcached service typically runs on the controller
@ -11,17 +11,11 @@ Install and configure components
#. Install the packages:
.. code-block:: console
.. code-block:: console
# yum install memcached python-memcached
.. end
.. end
2. Edit the ``/etc/sysconfig/memcached`` file and complete the
following actions:
@ -40,13 +34,9 @@ Install and configure components
Change the existing line ``OPTIONS="-l 127.0.0.1,::1"``.
Finalize installation
---------------------
* Start the Memcached service and configure it to start when the system
boots:
@ -56,4 +46,3 @@ Finalize installation
# systemctl start memcached.service
.. end

View File

@ -1,5 +1,5 @@
Ubuntu Memcached
~~~~~~~~~~~~~~~~
Memcached for Ubuntu
~~~~~~~~~~~~~~~~~~~~
The Identity service authentication mechanism for services uses Memcached
to cache tokens. The memcached service typically runs on the controller
@ -12,15 +12,11 @@ Install and configure components
#. Install the packages:
.. code-block:: console
.. code-block:: console
# apt install memcached python-memcache
.. end
.. end
2. Edit the ``/etc/memcached.conf`` file and configure the
service to use the management IP address of the controller node.
@ -36,13 +32,9 @@ Install and configure components
Change the existing line that had ``-l 127.0.0.1``.
Finalize installation
---------------------
* Restart the Memcached service:
.. code-block:: console
@ -50,5 +42,3 @@ Finalize installation
# service memcached restart
.. end

View File

@ -1,5 +1,5 @@
SUSE Message queue
~~~~~~~~~~~~~~~~~~
Message queue for SUSE
~~~~~~~~~~~~~~~~~~~~~~
OpenStack uses a :term:`message queue` to coordinate operations and
status information among services. The message queue service typically
@ -19,16 +19,11 @@ Install and configure components
1. Install the package:
.. code-block:: console
.. code-block:: console
# zypper install rabbitmq-server
.. end
.. end
2. Start the message queue service and configure it to start when the
system boots:
@ -62,5 +57,3 @@ Install and configure components
Setting permissions for user "openstack" in vhost "/" ...
.. end

View File

@ -1,5 +1,5 @@
Red Hat Message queue
~~~~~~~~~~~~~~~~~~~~~
Message queue for RHEL and CentOS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
OpenStack uses a :term:`message queue` to coordinate operations and
status information among services. The message queue service typically
@ -19,16 +19,11 @@ Install and configure components
1. Install the package:
.. code-block:: console
.. code-block:: console
# yum install rabbitmq-server
.. end
.. end
2. Start the message queue service and configure it to start when the
system boots:
@ -62,5 +57,3 @@ Install and configure components
Setting permissions for user "openstack" in vhost "/" ...
.. end

View File

@ -1,5 +1,5 @@
Ubuntu Message queue
~~~~~~~~~~~~~~~~~~~~
Message queue for Ubuntu
~~~~~~~~~~~~~~~~~~~~~~~~
OpenStack uses a :term:`message queue` to coordinate operations and
status information among services. The message queue service typically
@ -19,17 +19,11 @@ Install and configure components
1. Install the package:
.. code-block:: console
.. code-block:: console
# apt install rabbitmq-server
.. end
.. end
2. Add the ``openstack`` user:
@ -53,4 +47,3 @@ Install and configure components
Setting permissions for user "openstack" in vhost "/" ...
.. end

View File

@ -23,7 +23,7 @@ Configure network interfaces
Replace ``INTERFACE_NAME`` with the actual interface name. For example,
*eth1* or *ens224*.
For Ubuntu or Debian:
For Ubuntu:
* Edit the ``/etc/network/interfaces`` file to contain the following:
@ -38,7 +38,7 @@ Configure network interfaces
.. end
For Red Hat or CentOS:
For RHEL or CentOS:
* Edit the ``/etc/sysconfig/network-scripts/ifcfg-INTERFACE_NAME`` file
to contain the following:

View File

@ -19,7 +19,7 @@ Configure network interfaces
Replace ``INTERFACE_NAME`` with the actual interface name. For example,
*eth1* or *ens224*.
For Ubuntu or Debian:
For Ubuntu:
* Edit the ``/etc/network/interfaces`` file to contain the following:
@ -34,7 +34,7 @@ Configure network interfaces
.. end
For Red Hat or CentOS:
For RHEL or CentOS:
* Edit the ``/etc/sysconfig/network-scripts/ifcfg-INTERFACE_NAME`` file
to contain the following:

View File

@ -80,13 +80,13 @@ among the nodes before proceeding further.
.. note::
Red Hat and SUSE enables a restrictive :term:`firewall` by
RHEL, CentOS and SUSE distributions enable a restrictive :term:`firewall` by
default. During the installation process, certain steps will fail
unless you alter or disable the firewall. For more information
about securing your environment, refer to the `OpenStack Security
Guide <https://docs.openstack.org/security-guide/>`_.
Debian and Ubuntu do not enable a restrictive :term:`firewall` by
Ubuntu does not enable a restrictive :term:`firewall` by
default. For more information about securing your environment,
refer to the `OpenStack Security Guide
<https://docs.openstack.org/security-guide/>`_.

View File

@ -12,11 +12,10 @@ distribution, see the documentation.
.. seealso::
* `Debian Network Configuration <https://wiki.debian.org/NetworkConfiguration>`__
* `Ubuntu Network Configuration
<https://help.ubuntu.com/lts/serverguide/network-configuration.html>`__
* `Red Hat Network Configuration
<https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Networking_Guide/sec-Using_the_Command_Line_Interface.html>`__
* `RHEL 7 Network Configuration
<https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Networking_Guide/sec-Network_Config_Using_CLI.html>`__
* `SLES 12
<https://www.suse.com/documentation/sles-12/book_sle_admin/data/sec_basicnet_manconf.html>`__
or `openSUSE
@ -84,8 +83,8 @@ the controller node.
.. note::
Red Hat and SUSE distributions enable a restrictive
:term:`firewall` by default. Ubuntu and Debian do not. For more
RHEL, CentOS and SUSE distributions enable a restrictive
:term:`firewall` by default. Ubuntu does not. For more
information about securing your environment, refer to the
`OpenStack Security Guide
<https://docs.openstack.org/security-guide/>`_.

View File

@ -11,7 +11,7 @@ Install and configure components
1. Install the packages:
For Debian or Ubuntu:
For Ubuntu:
.. code-block:: console
@ -19,7 +19,7 @@ Install and configure components
.. end
For Red Hat or CentOS:
For RHEL or CentOS:
.. code-block:: console
@ -69,7 +69,7 @@ Install and configure components
4. Restart the NTP service:
For Debian or Ubuntu:
For Ubuntu:
.. code-block:: console
@ -77,7 +77,7 @@ Install and configure components
.. end
For Red Hat or SUSE:
For RHEL, CentOS, or SUSE:
.. code-block:: console

View File

@ -12,13 +12,13 @@ Install and configure components
1. Install the packages.
For Debian or Ubuntu:
For Ubuntu:
.. code-block:: console
# apt install chrony
For Red Hat:
For RHEL or CentOS:
.. code-block:: console
@ -48,7 +48,7 @@ Install and configure components
4. Restart the NTP service.
For Debian or Ubuntu:
For Ubuntu:
.. code-block:: console
@ -56,7 +56,7 @@ Install and configure components
.. end
For Red Hat or SUSE:
For RHEL, CentOS, or SUSE:
.. code-block:: console

View File

@ -3,10 +3,10 @@
Network Time Protocol (NTP)
~~~~~~~~~~~~~~~~~~~~~~~~~~~
You should install Chrony, an implementation of :term:`NTP <Network Time
Protocol (NTP)>`, to properly synchronize services among nodes. We recommend
that you configure the controller node to reference more accurate (lower
stratum) servers and other nodes to reference the controller node.
To properly synchronize services among nodes, you can install Chrony, an
implementation of :term:`NTP <Network Time Protocol (NTP)>`. We recommend that
you configure the controller node to reference more accurate (lower stratum)
servers and other nodes to reference the controller node.
.. toctree::
:maxdepth: 1

View File

@ -1,5 +1,5 @@
SUSE OpenStack packages
~~~~~~~~~~~~~~~~~~~~~~~
OpenStack packages for SUSE
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Distributions release OpenStack packages as part of the distribution or
using other methods because of differing release schedules. Perform
@ -72,18 +72,16 @@ Enable the OpenStack repository
.. end
Finalize the installation
-------------------------
#. Upgrade the packages on all nodes:
.. code-block:: console
.. code-block:: console
# zypper refresh && zypper dist-upgrade
.. end
.. end
.. note::
@ -92,10 +90,8 @@ Finalize the installation
#. Install the OpenStack client:
.. code-block:: console
.. code-block:: console
# zypper install python-openstackclient
.. end
.. end

View File

@ -1,5 +1,5 @@
Red Hat OpenStack packages
~~~~~~~~~~~~~~~~~~~~~~~~~~
OpenStack packages for RHEL and CentOS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Distributions release OpenStack packages as part of the distribution or
using other methods because of differing release schedules. Perform
@ -20,8 +20,6 @@ these procedures on all nodes.
Disable or remove any automatic update services because they can
impact your OpenStack environment.
Prerequisites
-------------
@ -55,8 +53,6 @@ Prerequisites
.. end
Enable the OpenStack repository
-------------------------------
@ -65,9 +61,11 @@ Enable the OpenStack repository
default, so you can simply install the package to enable the OpenStack
repository.
**When installing the Pike release, run:**
.. code-block:: console
# yum install centos-release-openstack-ocata
# yum install centos-release-openstack-pike
.. end
@ -80,22 +78,18 @@ Enable the OpenStack repository
.. end
The RDO repository RPM installs the latest available OpenStack release.
Finalize the installation
-------------------------
1. Upgrade the packages on all nodes:
.. code-block:: console
.. code-block:: console
# yum upgrade
.. end
.. end
.. note::
@ -104,16 +98,11 @@ Finalize the installation
2. Install the OpenStack client:
.. code-block:: console
.. code-block:: console
# yum install python-openstackclient
.. end
.. end
3. RHEL and CentOS enable :term:`SELinux` by default. Install the
``openstack-selinux`` package to automatically manage security
@ -124,4 +113,3 @@ Finalize the installation
# yum install openstack-selinux
.. end

View File

@ -1,5 +1,5 @@
Ubuntu OpenStack packages
~~~~~~~~~~~~~~~~~~~~~~~~~
OpenStack packages for Ubuntu
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Distributions release OpenStack packages as part of the distribution or
using other methods because of differing release schedules. Perform
@ -27,28 +27,20 @@ Enable the OpenStack repository
.. code-block:: console
# apt install software-properties-common
# add-apt-repository cloud-archive:ocata
# add-apt-repository cloud-archive:pike
.. end
Finalize the installation
-------------------------
1. Upgrade the packages on all nodes:
.. code-block:: console
.. code-block:: console
# apt update && apt dist-upgrade
.. end
.. end
.. note::
@ -57,13 +49,8 @@ Finalize the installation
2. Install the OpenStack client:
.. code-block:: console
.. code-block:: console
# apt install python-openstackclient
.. end
.. end

View File

@ -70,8 +70,8 @@ during installation and operation. In some cases, services perform
modifications to the host that can interfere with deployment automation
tools such as Ansible, Chef, and Puppet. For example, some OpenStack
services add a root wrapper to ``sudo`` that can interfere with security
policies. See the `OpenStack Administrator Guide <https://docs.openstack.org/
admin-guide/compute-root-wrap-reference.html>`__
policies. See the
`Compute service documentation for Pike <https://docs.openstack.org/nova/pike/admin/root-wrap-reference.html>`__
for more information.
The Networking service assumes default values for kernel network

View File

@ -1,5 +1,5 @@
SUSE SQL database
~~~~~~~~~~~~~~~~~
SQL database for SUSE
~~~~~~~~~~~~~~~~~~~~~
Most OpenStack services use an SQL database to store information. The
database typically runs on the controller node. The procedures in this
@ -7,25 +7,16 @@ guide use MariaDB or MySQL depending on the distribution. OpenStack
services also support other SQL databases including
`PostgreSQL <https://www.postgresql.org/>`__.
Install and configure components
--------------------------------
#. Install the packages:
.. code-block:: console
.. code-block:: console
# zypper install mariadb-client mariadb python-PyMySQL
.. end
.. end
2. Create and edit the ``/etc/my.cnf.d/openstack.cnf`` file
and complete the following actions:
@ -50,25 +41,18 @@ Install and configure components
.. end
Finalize installation
---------------------
#. Start the database service and configure it to start when the system
boots:
.. code-block:: console
.. code-block:: console
# systemctl enable mysql.service
# systemctl start mysql.service
.. end
.. end
2. Secure the database service by running the ``mysql_secure_installation``
script. In particular, choose a suitable password for the database
@ -79,4 +63,3 @@ Finalize installation
# mysql_secure_installation
.. end

View File

@ -1,5 +1,5 @@
Red Hat SQL database
~~~~~~~~~~~~~~~~~~~~
SQL database for RHEL and CentOS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Most OpenStack services use an SQL database to store information. The
database typically runs on the controller node. The procedures in this
@ -7,25 +7,16 @@ guide use MariaDB or MySQL depending on the distribution. OpenStack
services also support other SQL databases including
`PostgreSQL <https://www.postgresql.org/>`__.
Install and configure components
--------------------------------
#. Install the packages:
.. code-block:: console
.. code-block:: console
# yum install mariadb mariadb-server python2-PyMySQL
.. end
.. end
2. Create and edit the ``/etc/my.cnf.d/openstack.cnf`` file
and complete the following actions:
@ -50,25 +41,18 @@ Install and configure components
.. end
Finalize installation
---------------------
#. Start the database service and configure it to start when the system
boots:
.. code-block:: console
.. code-block:: console
# systemctl enable mariadb.service
# systemctl start mariadb.service
.. end
.. end
2. Secure the database service by running the ``mysql_secure_installation``
script. In particular, choose a suitable password for the database
@ -79,4 +63,3 @@ Finalize installation
# mysql_secure_installation
.. end

View File

@ -1,5 +1,5 @@
Ubuntu SQL database
~~~~~~~~~~~~~~~~~~~
SQL database for Ubuntu
~~~~~~~~~~~~~~~~~~~~~~~
Most OpenStack services use an SQL database to store information. The
database typically runs on the controller node. The procedures in this
@ -7,7 +7,6 @@ guide use MariaDB or MySQL depending on the distribution. OpenStack
services also support other SQL databases including
`PostgreSQL <https://www.postgresql.org/>`__.
.. note::
As of Ubuntu 16.04, MariaDB was changed to use
@ -17,24 +16,16 @@ services also support other SQL databases including
the root user no longer uses a password for local access to
the server.
Install and configure components
--------------------------------
#. Install the packages:
.. code-block:: console
.. code-block:: console
# apt install mariadb-server python-pymysql
.. end
.. end
2. Create and edit the ``/etc/mysql/mariadb.conf.d/99-openstack.cnf`` file
and complete the following actions:
@ -55,14 +46,12 @@ Install and configure components
max_connections = 4096
collation-server = utf8_general_ci
character-set-server = utf8
.. end
Finalize installation
---------------------
#. Restart the database service:
.. code-block:: console
@ -71,10 +60,6 @@ Finalize installation
.. end
2. Secure the database service by running the ``mysql_secure_installation``
script. In particular, choose a suitable password for the database
``root`` account:
@ -84,4 +69,3 @@ Finalize installation
# mysql_secure_installation
.. end

View File

@ -8,8 +8,8 @@ node using the example architecture.
Although most environments include Identity, Image service, Compute, at least
one networking service, and the Dashboard, the Object Storage service can
operate independently. If your use case only involves Object Storage, you can
skip to `Object Storage Installation Guide
<https://docs.openstack.org/swift/>`_
skip to `Object Storage Installation Guide for Pike
<https://docs.openstack.org/swift/pike/install/>`_
after configuring the appropriate nodes for it.
You must use an account with administrative privileges to configure each node.
@ -67,8 +67,8 @@ of nested VMs.
a way to disable MAC address filtering on the provider network
interface.
For more information about system requirements, see the `OpenStack
Operations Guide <https://docs.openstack.org/ops-guide/>`_.
For more information about system requirements, see the
`OpenStack Pike Administrator Guides <https://docs.openstack.org/pike/admin/>`_.
.. toctree::
:maxdepth: 1

View File

@ -13,10 +13,13 @@ through a set of interrelated services. Each service offers an
integration. Depending on your needs, you can install some or all
services.
The OpenStack services
======================
The following table describes the OpenStack services that make up the
OpenStack architecture:
.. list-table:: OpenStack Services
.. list-table:: The OpenStack services
:header-rows: 1
:widths: 10 10 40
@ -81,6 +84,11 @@ OpenStack architecture:
by specifying parameters like Hadoop version, cluster topology and nodes
hardware details.
The OpenStack architecture
==========================
The following sections describe the OpenStack architecture in more detail:
.. toctree::
:maxdepth: 2

View File

@ -5,9 +5,9 @@
.. toctree::
:maxdepth: 3
common/conventions.rst
preface
get-started-with-openstack
common/conventions.rst
overview.rst
environment.rst
openstack-services.rst

View File

@ -138,8 +138,7 @@ Attach the volume to an instance
to use the volume.
For more information about how to manage volumes, see the
`Manage volumes
<https://docs.openstack.org/user-guide/common/cli-manage-volumes.html>`__
in OpenStack End User Guide.
`python-openstackclient documentation for Pike
<https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/volume.html>`__.
Return to :ref:`launch-instance`.

View File

@ -268,9 +268,9 @@ Access the instance remotely
.. end
If your instance does not launch or seem to work as you expect, see the
`Instance Boot Failures
<https://docs.openstack.org/ops-guide/ops-maintenance-compute.html#instances>`__
section in OpenStack Operations Guide for more information or use one of
`Troubleshoot Compute documentation for Pike
<https://docs.openstack.org/nova/pike/admin/support-compute.html>`__
for more information or use one of
the :doc:`many other options <common/app-support>`
to seek assistance. We want your first installation to work!

View File

@ -308,9 +308,9 @@ Access the instance remotely
.. end
If your instance does not launch or seem to work as you expect, see the
`Instance Boot Failures
<https://docs.openstack.org/ops-guide/ops-maintenance-compute.html#instances>`__
section in OpenStack Operations Guide for more information or use one of
`Troubleshoot Compute documentation for Pike
<https://docs.openstack.org/nova/pike/admin/support-compute.html>`__
for more information or use one of
the :doc:`many other options <common/app-support>`
to seek assistance. We want your first installation to work!

View File

@ -13,11 +13,11 @@ The instructions in this section use command-line interface (CLI)
tools on the controller node. However, you can follow the instructions
on any host that the tools are installed.
For more information on the CLI tools, see the
`OpenStack End User Guide
<https://docs.openstack.org/user-guide/cli-launch-instances.html>`__.
`OpenStackClient documentation for Pike
<https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/server.html#server-create>`__.
To use the dashboard, see the
`OpenStack End User Guide
<https://docs.openstack.org/user-guide/dashboard.html>`__.
`Dashboard User Documentation for Pike
<https://docs.openstack.org/horizon/pike/user/>`__.
.. _launch-instance-networks:
@ -219,7 +219,8 @@ If your environment includes the Orchestration service, you can create
a stack that launches an instance.
For more information, see the
`Orchestration installation guide <https://docs.openstack.org/orchestration/>`_.
`Orchestration installation guide for Pike
<https://docs.openstack.org/heat/pike/>`_.
Shared File Systems
-------------------
@ -228,5 +229,5 @@ If your environment includes the Shared File Systems service, you can create
a share and mount it in an instance.
For more information, see the
`Shared File Systems installation guide
<https://docs.openstack.org/shared-file-system/>`_.
`Shared File Systems installation guide for Pike
<https://docs.openstack.org/manila/pike/>`_.

View File

@ -6,23 +6,29 @@ The installation of individual OpenStack services is covered in the
Project Installation Guides that are available at the following
locations:
* `OpenStack Pike Installation Tutorials and Guides
* `OpenStack Installation Tutorials and Guides for Pike
<https://docs.openstack.org/pike/install/>`_
.. Note that this guide is release independent, so we will add more
entries to the list above.
Minimal deployment
==================
At minimal you need to install - in this order - the following
components:
At a minimum, you need to install the following services. Install the services
in the order specified below:
* Identity service (keystone)
* Image service (glance)
* Compute service (nova)
* Networking service (neutron)
* Identity service `keystone installation for Pike
<https://docs.openstack.org/keystone/pike/install/>`_
* Image service `glance installation for Pike
<https://docs.openstack.org/glance/pike/install/>`_
* Compute service `nova installation for Pike
<https://docs.openstack.org/nova/pike/install/>`_
* Networking service `neutron installation for Pike
<https://docs.openstack.org/neutron/pike/install/>`_
We advise to also install afterwards:
We advise to also install the following components after you have installed the
minimal deployment services:
* Dashboard (horizon)
* Block Storage service (cinder)
* Dashboard `horizon installation for Pike <https://docs.openstack.org/horizon/pike/install/>`_
* Block Storage service `cinder installation for Pike <https://docs.openstack.org/cinder/pike/install/>`_

View File

@ -60,8 +60,8 @@ follows:
For more information on production architectures, see the
`Architecture Design Guide <https://docs.openstack.org/arch-design/>`_,
`OpenStack Operations Guide <https://docs.openstack.org/ops-guide/>`_, and
`OpenStack Networking Guide <https://docs.openstack.org/ocata/networking-guide/>`_.
`OpenStack Networking Guide for Pike <https://docs.openstack.org/neutron/pike/admin/>`_,
and `OpenStack Administrator Guides for Pike <https://docs.openstack.org/pike/admin/>`_.
.. _figure-hwreqs:

View File

@ -36,24 +36,6 @@ Pike release. It will cover multiple releases in the future.
Operating Systems
~~~~~~~~~~~~~~~~~
Debian
++++++
This guide walks through an installation by using packages
available through Debian 8 (code name: Jessie).
.. note::
This guide uses installation with debconf set to non-interactive
mode. That is, there will be no debconf prompt. To configure a computer
to use this mode, run the following command:
.. code-block:: console
# dpkg-reconfigure debconf
.. end
openSUSE and SUSE Linux Enterprise Server
+++++++++++++++++++++++++++++++++++++++++