Update install guide common content for Rocky

No updates on distro packages yet.

This deserves more automation with templates in the future, but
get this in for now.

Change-Id: I2cac95b57febe067e956be9d14808d1209b42495
This commit is contained in:
Petr Kovar 2018-08-30 15:55:45 +02:00
parent 2fe5ba3f39
commit 4bca243c86
9 changed files with 79 additions and 42 deletions

View File

@ -24,17 +24,17 @@ For the available OpenStack documentation, see
The following guides explain how to install a Proof-of-Concept OpenStack cloud
and its associated components:
* `Queens Installation Guides <https://docs.openstack.org/queens/install/>`_
* `Rocky Installation Guides <https://docs.openstack.org/rocky/install/>`_
The following books explain how to configure and run an OpenStack cloud:
* `Architecture Design Guide <https://docs.openstack.org/arch-design/>`_
* `Queens Administrator Guides <https://docs.openstack.org/queens/admin/>`_
* `Rocky Administrator Guides <https://docs.openstack.org/rocky/admin/>`_
* `Queens Configuration Guides <https://docs.openstack.org/queens/configuration/>`_
* `Rocky Configuration Guides <https://docs.openstack.org/rocky/configuration/>`_
* `Queens Networking Guide <https://docs.openstack.org/neutron/queens/admin/>`_
* `Rocky Networking Guide <https://docs.openstack.org/neutron/rocky/admin/>`_
* `High Availability Guide <https://docs.openstack.org/ha-guide/>`_
@ -44,8 +44,8 @@ The following books explain how to configure and run an OpenStack cloud:
The following book explains how to use the command-line clients:
* `Queens API Bindings
<https://docs.openstack.org/queens/language-bindings.html>`_
* `Rocky API Bindings
<https://docs.openstack.org/rocky/language-bindings.html>`_
The following documentation provides reference and guidance information
for the OpenStack APIs:

View File

@ -71,9 +71,11 @@ 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
`Compute service documentation for Pike <https://docs.openstack.org/nova/pike/admin/root-wrap-reference.html>`_
`Compute service documentation for Pike <https://docs.openstack.org/nova/pike/admin/root-wrap-reference.html>`_,
the
`Compute service documentation for Queens <https://docs.openstack.org/nova/queens/admin/root-wrap-reference.html>`_,
or the
`Compute service documentation for Queens <https://docs.openstack.org/nova/queens/admin/root-wrap-reference.html>`_
`Compute service documentation for Rocky <https://docs.openstack.org/nova/rocky/admin/root-wrap-reference.html>`_
for more information.
The Networking service assumes default values for kernel network

View File

@ -8,10 +8,11 @@ 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 for Pike
<https://docs.openstack.org/swift/pike/install/>`_
or `Object Storage Installation Guide for Queens
<https://docs.openstack.org/swift/queens/install/>`_
skip to
`Object Storage Installation Guide for Pike <https://docs.openstack.org/swift/pike/install/>`_,
`Object Storage Installation Guide for Queens <https://docs.openstack.org/swift/queens/install/>`_,
or
`Object Storage Installation Guide for Rocky <https://docs.openstack.org/swift/rocky/install/>`_
after configuring the appropriate nodes for it.
You must use an account with administrative privileges to configure each node.
@ -70,9 +71,11 @@ of nested VMs.
interface.
For more information about system requirements, see the
`OpenStack Pike Administrator Guides <https://docs.openstack.org/pike/admin/>`_
`OpenStack Pike Administrator Guides <https://docs.openstack.org/pike/admin/>`_,
the
`OpenStack Queens Administrator Guides <https://docs.openstack.org/queens/admin/>`_,
or the
`OpenStack Queens Administrator Guides <https://docs.openstack.org/queens/admin/>`_.
`OpenStack Rocky Administrator Guides <https://docs.openstack.org/rocky/admin/>`_.
.. toctree::
:maxdepth: 1

View File

@ -138,10 +138,10 @@ Attach the volume to an instance
to use the volume.
For more information about how to manage volumes, see the
`python-openstackclient documentation for Pike
<https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/volume.html>`_
`python-openstackclient documentation for Pike <https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/volume.html>`_,
the
`python-openstackclient documentation for Queens <https://docs.openstack.org/python-openstackclient/queens/cli/command-objects/volume.html>`_,
or the
`python-openstackclient documentation for Queens
<https://docs.openstack.org/python-openstackclient/queens/cli/command-objects/volume.html>`_.
`python-openstackclient documentation for Rocky <https://docs.openstack.org/python-openstackclient/rocky/cli/command-objects/volume.html>`_.
Return to :ref:`launch-instance`.

View File

@ -268,11 +268,11 @@ Access the instance remotely
.. end
If your instance does not launch or seem to work as you expect, see the
`Troubleshoot Compute documentation for Pike
<https://docs.openstack.org/nova/pike/admin/support-compute.html>`_
`Troubleshoot Compute documentation for Pike <https://docs.openstack.org/nova/pike/admin/support-compute.html>`_,
the
`Troubleshoot Compute documentation for Queens <https://docs.openstack.org/nova/queens/admin/support-compute.html>`_,
or the
`Troubleshoot Compute documentation for Queens
<https://docs.openstack.org/nova/queens/admin/support-compute.html>`_
`Troubleshoot Compute documentation for Rocky <https://docs.openstack.org/nova/rocky/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,11 +308,11 @@ Access the instance remotely
.. end
If your instance does not launch or seem to work as you expect, see the
`Troubleshoot Compute documentation for Pike
<https://docs.openstack.org/nova/pike/admin/support-compute.html>`_
`Troubleshoot Compute documentation for Pike <https://docs.openstack.org/nova/pike/admin/support-compute.html>`_,
the
`Troubleshoot Compute documentation for Queens <https://docs.openstack.org/nova/queens/admin/support-compute.html>`_,
or the
`Troubleshoot Compute documentation for Queens
<https://docs.openstack.org/nova/queens/admin/support-compute.html>`_
`Troubleshoot Compute documentation for Rocky <https://docs.openstack.org/nova/rocky/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

@ -9,21 +9,24 @@ instances. Networking option 1 includes one provider (external) network
with one instance that uses it. Networking option 2 includes one provider
network with one instance that uses it and one self-service (private)
network with one instance that uses it.
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
`OpenStackClient documentation for Pike
<https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/server.html#server-create>`_
`OpenStackClient documentation for Pike <https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/server.html#server-create>`_,
the
`OpenStackClient documentation for Queens <https://docs.openstack.org/python-openstackclient/queens/cli/command-objects/server.html#server-create>`_,
or the
`OpenStackClient documentation for Queens
<https://docs.openstack.org/python-openstackclient/queens/cli/command-objects/server.html#server-create>`_.
`OpenStackClient documentation for Rocky <https://docs.openstack.org/python-openstackclient/rocky/cli/command-objects/server.html#server-create>`_.
To use the dashboard, see the
`Dashboard User Documentation for Pike
<https://docs.openstack.org/horizon/pike/user/>`_
`Dashboard User Documentation for Pike <https://docs.openstack.org/horizon/pike/user/>`_,
the
`Dashboard User Documentation for Queens <https://docs.openstack.org/horizon/queens/user/>`_,
or the
`Dashboard User Documentation for Queens
<https://docs.openstack.org/horizon/queens/user/>`_.
`Dashboard User Documentation for Rocky <https://docs.openstack.org/horizon/rocky/user/>`_.
.. _launch-instance-networks:
@ -225,11 +228,11 @@ If your environment includes the Orchestration service, you can create
a stack that launches an instance.
For more information, see the
`Orchestration installation guide for Pike
<https://docs.openstack.org/heat/pike/install/>`_
`Orchestration installation guide for Pike <https://docs.openstack.org/heat/pike/install/>`_,
the
`Orchestration installation guide for Queens <https://docs.openstack.org/heat/queens/install/>`_,
or the
`Orchestration installation guide for Queens
<https://docs.openstack.org/heat/queens/install/>`_.
`Orchestration installation guide for Rocky <https://docs.openstack.org/heat/rocky/install/>`_.
Shared File Systems
-------------------
@ -238,8 +241,8 @@ 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 for Pike
<https://docs.openstack.org/manila/pike/install/>`_
`Shared File Systems installation guide for Pike <https://docs.openstack.org/manila/pike/install/>`_,
the
`Shared File Systems installation guide for Queens <https://docs.openstack.org/manila/queens/install/>`_,
or the
`Shared File Systems installation guide for Queens
<https://docs.openstack.org/manila/queens/install/>`_.
`Shared File Systems installation guide for Rocky <https://docs.openstack.org/manila/rocky/install/>`_.

View File

@ -10,6 +10,8 @@ locations:
<https://docs.openstack.org/pike/install/>`_
* `OpenStack Installation Guides for Queens
<https://docs.openstack.org/queens/install/>`_
* `OpenStack Installation Guides for Rocky
<https://docs.openstack.org/rocky/install/>`_
Minimal deployment for Pike
~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -52,3 +54,24 @@ minimal deployment services:
* Dashboard `horizon installation for Queens <https://docs.openstack.org/horizon/queens/install/>`_
* Block Storage service `cinder installation for Queens <https://docs.openstack.org/cinder/queens/install/>`_
Minimal deployment for Rocky
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
At a minimum, you need to install the following services. Install the services
in the order specified below:
* Identity service `keystone installation for Rocky
<https://docs.openstack.org/keystone/rocky/install/>`_
* Image service `glance installation for Rocky
<https://docs.openstack.org/glance/rocky/install/>`_
* Compute service `nova installation for Rocky
<https://docs.openstack.org/nova/rocky/install/>`_
* Networking service `neutron installation for Rocky
<https://docs.openstack.org/neutron/rocky/install/>`_
We advise to also install the following components after you have installed the
minimal deployment services:
* Dashboard `horizon installation for Rocky <https://docs.openstack.org/horizon/rocky/install/>`_
* Block Storage service `cinder installation for Rocky <https://docs.openstack.org/cinder/rocky/install/>`_

View File

@ -70,6 +70,12 @@ For more information on production architectures for Queens, see the
and
`OpenStack Administrator Guides for Queens <https://docs.openstack.org/queens/admin/>`_.
For more information on production architectures for Rocky, see the
`Architecture Design Guide <https://docs.openstack.org/arch-design/>`_,
`OpenStack Networking Guide for Rocky <https://docs.openstack.org/neutron/rocky/admin/>`_,
and
`OpenStack Administrator Guides for Rocky <https://docs.openstack.org/rocky/admin/>`_.
.. _figure-hwreqs:
.. figure:: figures/hwreqs.png