The steps needed to upgrade the undercloud were
specified in two different files. This commit
updates the steps to cover O to P from commit
496223 in the 'Undercloud Installation' section
and reuses that doc file for the 'Upgrading to
a Next Major Release'.
As an addition, a new class 'otop' has been
added to include specific documentation sections
when upgrading from Ocata to Pike.
Change-Id: I9097ca11a95f94c5eaf580fb8a82b3173d606a5d
We currently do the following to add the 'stack' user on the undercloud
to the 'docker' group so it can access the docker daemon (when the local
docker registry option is enabled):
...
if str2bool(hiera('enable_docker_registry', true)) {
group { 'docker':
ensure => 'present',
}
user { 'docker_user':
name => hiera('tripleo_install_user'),
groups => 'docker',
notify => Service['docker'],
}
include ::tripleo::profile::base::docker_registry
}
...
For this to work the stack user needs to logoff and logon again.
Closes-Bug: #1722498
Change-Id: Ia1f76f61828c119667879c41f1ad5d86b8901adb
undercloud_hostname is a less error-prone method of configuring all
the undercloud hostname settings correctly. We probably want to
make it a mandatory option and avoid hostname-related bugs, but for
the moment let's at least document it as the preferred way to handle
hostname configuration.
Note that this option has existed since Mitaka, so it applies to
all of our currently supported branches.
Change-Id: I2506a44abac999d4b0450c402fe40cab89410cea
We haven't actually recommended installing anything from source for
quite a while and it probably doesn't work anymore anyway. Let's
get rid of this admonition and clean things up a little.
Change-Id: I005bc042f4d1ff855a90710599d796a9645b71f1
Due to missing spaces, some of the content in the installation
guide is displayed as blockquote without being really quoted
content. This change adds the needed spaces to remove the
generated HTML blockquotes.
The repositories.txt file gets included at different locations
and that file contained the formatting spaces which were needed
from the location which includes that file. It's most of the time
better to do the indentation at the ".. include" level and leave
the file which gets included *without* indentation. Because here,
the indentation in the included file worked for some includes but
not for all, because the content got used at different indentation
levels. That made it necessary to touch the includes in
basic_deployment and post_deployment too.
Follow up patches will deal with the other install guide sections
more in details.
Change-Id: Ie2e7fea6d92f7742d23e22452e394b8ff40975eb
The user is required to install ceph-ansible in pike.
The package can not be made a dependency of tripleoclient [1]
Updated install, update/upgrade, and backup and restore
The installation section was updated to cover deployment
of Ceph via TripleO with either puppet-ceph (Ceph not in
containers) or ceph-ansible (Ceph in containers).
[1] http://eavesdrop.openstack.org/meetings/rdo_meeting___2017_06_21/2017/rdo_meeting___2017_06_21.2017-06-21-15.01.log.html#l-29
Co-Authored-By: John Fulton <fulton@redhat.com>
Change-Id: I8e9def9577dc84b63895e10924a01a4949d02aef
The undercloud upgrade process is now able to stop services itself,
so there is no need for the user to do so (and they should not, in
case part of the upgrade expects the services to be running).
This moves the service stop into a stable admonition and leaves an
explanation as to why it should not be done on Pike+.
bp undercloud-upgrade
Change-Id: Ifc52866d7f22427ec41e6ac616710e3e431dffe3
There have been a couple of admonitions added recently that were
not completely wired into the admonition system, which makes them
essentially glorified note sections instead of dynamic admonitions.
This patch finishes the configuration of the admonitions.
It also does some re-organizing of the existing admonitions. The
SSL admonitions are dropped in favor of a generic "Optional"
admonition that can be used for these one-off optional features.
Change-Id: I9fd5c3a7f50e4916e45ad16a6e9aaaffd83affe8
The upstream docs structure is changing, so this change updates our
existing docs into contributor and install guide sections.
Change-Id: I37fabd25fdda6bc56fcfb331b74e3294e31e68bb
Jose Luis Franco Arza