Remove K, L & M release docs
Kilo, Liberty and Mitaka releases are no longer maintained, repo links don't work and the instructions get more complex with each release. This commit removes instructions relating to this release but retains Mitaka to Newton upgrade information. Change-Id: Id3ddd7f9e0f2e249a75f07e4c9e6866dc3263b3f
This commit is contained in:
parent
fcdad42af9
commit
e47a6006a7
@ -62,7 +62,6 @@
|
|||||||
.portal {background-color: #ded;}
|
.portal {background-color: #ded;}
|
||||||
.satellite {background-color: #dee;}
|
.satellite {background-color: #dee;}
|
||||||
.stable {background: #eed;}
|
.stable {background: #eed;}
|
||||||
.mitaka {background: #dee;}
|
|
||||||
.newton {background: #ede;}
|
.newton {background: #ede;}
|
||||||
.ocata {background: #edd;}
|
.ocata {background: #edd;}
|
||||||
.centos {background: #fef;}
|
.centos {background: #fef;}
|
||||||
|
@ -23,7 +23,6 @@
|
|||||||
<span class="title">Branches</span>
|
<span class="title">Branches</span>
|
||||||
<ul>
|
<ul>
|
||||||
<li><input type="checkbox" id="stable" checked=""><label for="stable" title="Step that should only be run when choosing to use components from their stable branches rather than using packages/source based on current master.">Install from stable branch</label></li>
|
<li><input type="checkbox" id="stable" checked=""><label for="stable" title="Step that should only be run when choosing to use components from their stable branches rather than using packages/source based on current master.">Install from stable branch</label></li>
|
||||||
<li><input type="checkbox" id="mitaka" checked=""><label for="mitaka" title="Step that should only be run when installing from the Mitaka stable branch.">Install from Mitaka branch</label></li>
|
|
||||||
<li><input type="checkbox" id="newton" checked=""><label for="newton" title="Step that should only be run when installing from the Newton stable branch.">Install from Newton branch</label></li>
|
<li><input type="checkbox" id="newton" checked=""><label for="newton" title="Step that should only be run when installing from the Newton stable branch.">Install from Newton branch</label></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
@ -54,8 +53,6 @@
|
|||||||
|
|
||||||
<span class="title">Upgrade Version</span>
|
<span class="title">Upgrade Version</span>
|
||||||
<ul>
|
<ul>
|
||||||
<li><input type="checkbox" id="ktol" checked="checked"><label for="ktol" title="Upgrading Kilo to Liberty is not supported">Upgrading Kilo to Liberty (unsupported)</label></li>
|
|
||||||
<li><input type="checkbox" id="ltom" checked="checked"><label for="ltom" title="Step that should only be run for upgrading from Liberty to Mitaka">Upgrading Liberty to Mitaka</label></li>
|
|
||||||
<li><input type="checkbox" id="mton" checked="checked"><label for="mton" title="Step that should only be run for upgrading from Mitaka to Newton">Upgrading Mitaka to Newton</label></li>
|
<li><input type="checkbox" id="mton" checked="checked"><label for="mton" title="Step that should only be run for upgrading from Mitaka to Newton">Upgrading Mitaka to Newton</label></li>
|
||||||
<li><input type="checkbox" id="ntoo" checked="checked"><label for="ntoo" title="Step that should only be run for upgrading from Newton to Ocata">Upgrading Newton to Ocata</label></li>
|
<li><input type="checkbox" id="ntoo" checked="checked"><label for="ntoo" title="Step that should only be run for upgrading from Newton to Ocata">Upgrading Newton to Ocata</label></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
@ -65,16 +65,6 @@ Then enroll only ``undercloud.json`` in your undercloud::
|
|||||||
source stackrc
|
source stackrc
|
||||||
openstack overcloud node import --provide undercloud.json
|
openstack overcloud node import --provide undercloud.json
|
||||||
|
|
||||||
.. admonition:: Stable Branch
|
|
||||||
:class: stable
|
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
For TripleO release Mitaka, the nodes should be imported with::
|
|
||||||
|
|
||||||
openstack baremetal import undercloud.json
|
|
||||||
|
|
||||||
.. admonition:: Virtual
|
.. admonition:: Virtual
|
||||||
:class: virtual
|
:class: virtual
|
||||||
|
|
||||||
|
@ -38,16 +38,6 @@ accept a device list in the order of preference, for example::
|
|||||||
|
|
||||||
openstack overcloud node configure --all-manageable --root-device=sdb,sdc,vda
|
openstack overcloud node configure --all-manageable --root-device=sdb,sdc,vda
|
||||||
|
|
||||||
.. admonition:: Stable Branch
|
|
||||||
:class: stable
|
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
For TripleO release Mitaka, the boot configuration command is::
|
|
||||||
|
|
||||||
openstack baremetal configure boot --root-device=sdb,sdc,vda
|
|
||||||
|
|
||||||
It can also accept one of two strategies: ``smallest`` will pick the smallest
|
It can also accept one of two strategies: ``smallest`` will pick the smallest
|
||||||
device, ``largest`` will pick the largest one. By default only disk devices
|
device, ``largest`` will pick the largest one. By default only disk devices
|
||||||
larger than 4 GiB are considered at all, set the ``--root-device-minimum-size``
|
larger than 4 GiB are considered at all, set the ``--root-device-minimum-size``
|
||||||
|
@ -225,9 +225,7 @@ be added as in the other values to indicate that this is a multi-line value.
|
|||||||
.. admonition:: Stable Branch
|
.. admonition:: Stable Branch
|
||||||
:class: stable
|
:class: stable
|
||||||
|
|
||||||
In Newton, the EndpointMap and SSL certificates have been decoupled,
|
From Newton, the EndpointMap and SSL certificates have been decoupled.
|
||||||
but in Mitaka it may be necessary to modify the EndpointMap
|
|
||||||
in enable-tls.yaml
|
|
||||||
|
|
||||||
When the certificate's common name is set to the public VIP, all instances
|
When the certificate's common name is set to the public VIP, all instances
|
||||||
of ``CLOUDNAME`` in enable-tls.yaml must be replaced with ``IP_ADDRESS``.
|
of ``CLOUDNAME`` in enable-tls.yaml must be replaced with ``IP_ADDRESS``.
|
||||||
|
@ -112,20 +112,6 @@ created on the undercloud, one should use a non-root user.
|
|||||||
.. admonition:: Stable Branch
|
.. admonition:: Stable Branch
|
||||||
:class: stable
|
:class: stable
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
export STABLE_RELEASE="mitaka"
|
|
||||||
|
|
||||||
.. admonition:: Ceph
|
|
||||||
:class: ceph
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
export DIB_YUM_REPO_CONF="$DIB_YUM_REPO_CONF /etc/yum.repos.d/CentOS-Ceph-Hammer.repo"
|
|
||||||
|
|
||||||
.. admonition:: Newton
|
.. admonition:: Newton
|
||||||
:class: newton
|
:class: newton
|
||||||
|
|
||||||
@ -195,14 +181,6 @@ created on the undercloud, one should use a non-root user.
|
|||||||
rhel-7-server-rhceph-2-osd-rpms
|
rhel-7-server-rhceph-2-osd-rpms
|
||||||
rhel-7-server-rhceph-2-tools-rpms
|
rhel-7-server-rhceph-2-tools-rpms
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
rhel-7-server-rhceph-1.3-mon-rpms
|
|
||||||
rhel-7-server-rhceph-1.3-osd-rpms
|
|
||||||
rhel-7-server-rhceph-1.3-tools-rpms
|
|
||||||
|
|
||||||
.. admonition:: RHEL Satellite Registration
|
.. admonition:: RHEL Satellite Registration
|
||||||
:class: satellite
|
:class: satellite
|
||||||
@ -295,21 +273,6 @@ used::
|
|||||||
|
|
||||||
openstack overcloud node import --introspect --provide instackenv.json
|
openstack overcloud node import --introspect --provide instackenv.json
|
||||||
|
|
||||||
.. admonition:: Stable Branch
|
|
||||||
:class: stable
|
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
For TripleO release Mitaka, the import command is::
|
|
||||||
|
|
||||||
openstack baremetal import --json instackenv.json
|
|
||||||
|
|
||||||
The following command must be run after registration to assign the
|
|
||||||
deployment kernel and ramdisk to all nodes::
|
|
||||||
|
|
||||||
openstack baremetal configure boot
|
|
||||||
|
|
||||||
Starting with the Newton release you can take advantage of the ``enroll``
|
Starting with the Newton release you can take advantage of the ``enroll``
|
||||||
provisioning state - see :doc:`../advanced_deployment/node_states` for details.
|
provisioning state - see :doc:`../advanced_deployment/node_states` for details.
|
||||||
|
|
||||||
@ -359,16 +322,6 @@ making the nodes available for deployment.
|
|||||||
|
|
||||||
openstack overcloud node introspect --all-manageable --provide
|
openstack overcloud node introspect --all-manageable --provide
|
||||||
|
|
||||||
.. admonition:: Stable Branch
|
|
||||||
:class: stable
|
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
For TripleO release Mitaka, the introspection command is::
|
|
||||||
|
|
||||||
openstack baremetal introspection bulk start
|
|
||||||
|
|
||||||
.. note:: **Introspection has to finish without errors.**
|
.. note:: **Introspection has to finish without errors.**
|
||||||
The process can take up to 5 minutes for VM / 15 minutes for baremetal. If
|
The process can take up to 5 minutes for VM / 15 minutes for baremetal. If
|
||||||
the process takes longer, see :ref:`introspection_problems`.
|
the process takes longer, see :ref:`introspection_problems`.
|
||||||
|
@ -82,11 +82,6 @@ Linux (RHEL). These steps are marked as follows:
|
|||||||
Step that should only be run when choosing to use components from their
|
Step that should only be run when choosing to use components from their
|
||||||
stable branches rather than using packages/source based on current master.
|
stable branches rather than using packages/source based on current master.
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
Step that should only be run when installing from the Mitaka stable branch.
|
|
||||||
|
|
||||||
.. admonition:: Newton
|
.. admonition:: Newton
|
||||||
:class: newton
|
:class: newton
|
||||||
|
|
||||||
|
@ -33,16 +33,6 @@ re-configured to use it. This can be done by re-running::
|
|||||||
|
|
||||||
openstack overcloud node configure --all-manageable
|
openstack overcloud node configure --all-manageable
|
||||||
|
|
||||||
.. admonition:: Stable Branch
|
|
||||||
:class: stable
|
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
For TripleO release Mitaka, the boot configuration command is::
|
|
||||||
|
|
||||||
openstack baremetal configure boot
|
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
If you want to use custom images for boot configuration, specify their names in
|
If you want to use custom images for boot configuration, specify their names in
|
||||||
``--deploy-kernel`` and ``--deploy-ramdisk`` options.
|
``--deploy-kernel`` and ``--deploy-ramdisk`` options.
|
||||||
|
@ -42,15 +42,6 @@ CRUSH map, from the OSDs map and delete the authentication keys::
|
|||||||
ceph osd rm $OSD_ID
|
ceph osd rm $OSD_ID
|
||||||
done
|
done
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
TripleO/Mitaka uses and supports Ceph/Hammer, not Jewel, which does not
|
|
||||||
use systemd but sysv init scripts. For Mitaka the systemctl command above
|
|
||||||
which stops the OSD should be replaced by::
|
|
||||||
|
|
||||||
service ceph stop osd.$OSD_ID
|
|
||||||
|
|
||||||
You are now free to reboot or shut down the node (using the Ironic API), or
|
You are now free to reboot or shut down the node (using the Ironic API), or
|
||||||
even remove it from the overcloud altogether by scaling down the overcloud
|
even remove it from the overcloud altogether by scaling down the overcloud
|
||||||
deployment, see :ref:`delete_nodes`.
|
deployment, see :ref:`delete_nodes`.
|
||||||
|
@ -6,11 +6,6 @@ first upgrading the undercloud, and then upgrading the overcloud.
|
|||||||
|
|
||||||
Note that there are version specific caveats and notes which are pointed out as below:
|
Note that there are version specific caveats and notes which are pointed out as below:
|
||||||
|
|
||||||
.. admonition:: Liberty to Mitaka
|
|
||||||
:class: ltom
|
|
||||||
|
|
||||||
liberty to mitaka specific note
|
|
||||||
|
|
||||||
.. admonition:: Mitaka to Newton
|
.. admonition:: Mitaka to Newton
|
||||||
:class: mton
|
:class: mton
|
||||||
|
|
||||||
@ -35,14 +30,6 @@ Upgrading the Undercloud
|
|||||||
1. Disable the old OpenStack release repositories and enable new
|
1. Disable the old OpenStack release repositories and enable new
|
||||||
release repositories on the undercloud:
|
release repositories on the undercloud:
|
||||||
|
|
||||||
.. admonition:: Liberty to Mitaka
|
|
||||||
:class: ltom
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
export CURRENT_VERSION=liberty
|
|
||||||
export NEW_VERSION=mitaka
|
|
||||||
|
|
||||||
.. admonition:: Mitaka to Newton
|
.. admonition:: Mitaka to Newton
|
||||||
:class: mton
|
:class: mton
|
||||||
|
|
||||||
@ -71,21 +58,6 @@ Upgrading the Undercloud
|
|||||||
|
|
||||||
2. Run undercloud upgrade:
|
2. Run undercloud upgrade:
|
||||||
|
|
||||||
.. admonition:: Liberty to Mitaka
|
|
||||||
:class: ltom
|
|
||||||
|
|
||||||
For liberty to mitaka upgrades we need to manually update
|
|
||||||
mariadb including a database backup/restore::
|
|
||||||
|
|
||||||
mysqldump -u root --flush-privileges --single-transaction --all-databases > /home/stack/backup.sql
|
|
||||||
sudo systemctl stop mariadb
|
|
||||||
sudo mv /var/lib/mysql /home/stack/mysql-backup
|
|
||||||
|
|
||||||
sudo yum -y update mariadb
|
|
||||||
|
|
||||||
sudo systemctl start mariadb
|
|
||||||
mysql -u root < /home/stack/backup.sql
|
|
||||||
|
|
||||||
.. admonition:: Mitaka to Newton
|
.. admonition:: Mitaka to Newton
|
||||||
:class: mton
|
:class: mton
|
||||||
|
|
||||||
@ -276,60 +248,6 @@ Upgrading the Overcloud to Newton and earlier
|
|||||||
`openstack stack list` and `sudo pcs status` on a controller
|
`openstack stack list` and `sudo pcs status` on a controller
|
||||||
reports everything running fine before proceeding to the next step.
|
reports everything running fine before proceeding to the next step.
|
||||||
|
|
||||||
.. admonition:: Liberty to Mitaka
|
|
||||||
:class: ltom
|
|
||||||
|
|
||||||
**Create the new CephClientKey**
|
|
||||||
|
|
||||||
If using a TripleO managed Ceph deployment, a new key for the
|
|
||||||
"client.openstack" CephX user needs to be provided. A sample
|
|
||||||
environment file would look like the following::
|
|
||||||
|
|
||||||
parameter_defaults:
|
|
||||||
CephClientKey: 'my_cephx_key'
|
|
||||||
|
|
||||||
A proper value for the key parameter can be generated from any of
|
|
||||||
the overcloud nodes with::
|
|
||||||
|
|
||||||
$ ceph-authtool --gen-print-key
|
|
||||||
|
|
||||||
.. admonition:: Liberty to Mitaka
|
|
||||||
:class: ltom
|
|
||||||
|
|
||||||
|
|
||||||
**Deliver the aodh migration.**
|
|
||||||
|
|
||||||
For Liberty to Mitaka we need to run an extra step in the upgrades workflow
|
|
||||||
after the upgrade initialisation.
|
|
||||||
|
|
||||||
This is to deliver the migration from ceilometer-alarms to aodh. To execute
|
|
||||||
this step run `overcloud deploy`, passing in the full set of environment
|
|
||||||
files plus `major-upgrade-aodh.yaml`. Note that the `--force-postconfig`
|
|
||||||
switch is needed in order to add the newly created aodh endpoint::
|
|
||||||
|
|
||||||
openstack overcloud deploy --templates \
|
|
||||||
-e <full environment> \
|
|
||||||
-e /usr/share/openstack-tripleo-heat-templates/environments/major-upgrade-aodh.yaml \
|
|
||||||
--force-postconfig
|
|
||||||
|
|
||||||
.. admonition:: Liberty to Mitaka
|
|
||||||
:class: ltom
|
|
||||||
|
|
||||||
|
|
||||||
**Deliver the migration for keystone to run under httpd.**
|
|
||||||
|
|
||||||
For Liberty to Mitaka we need to run an extra step in the upgrades workflow
|
|
||||||
after the aodh migration.
|
|
||||||
|
|
||||||
This is to deliver the migration for keystone to be run under httpd (apache)
|
|
||||||
rather than eventlet as was the case before. To execute this step run
|
|
||||||
`overcloud deploy`, passing in the full set of environment files plus
|
|
||||||
`major-upgrade-keystone-liberty-mitaka.yaml`::
|
|
||||||
|
|
||||||
openstack overcloud deploy --templates \
|
|
||||||
-e <full environment> \
|
|
||||||
-e /usr/share/openstack-tripleo-heat-templates/environments/major-upgrade-keystone-liberty-mitaka.yaml
|
|
||||||
|
|
||||||
.. admonition:: Mitaka to Newton
|
.. admonition:: Mitaka to Newton
|
||||||
:class: mton
|
:class: mton
|
||||||
|
|
||||||
|
@ -11,14 +11,4 @@ re-configured to use it. This can be done by re-running::
|
|||||||
|
|
||||||
openstack overcloud node configure --all-manageable
|
openstack overcloud node configure --all-manageable
|
||||||
|
|
||||||
.. admonition:: Stable Branch
|
|
||||||
:class: stable
|
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka
|
|
||||||
|
|
||||||
For TripleO release Mitaka, the boot configuration command is::
|
|
||||||
|
|
||||||
openstack baremetal configure boot
|
|
||||||
|
|
||||||
Now the new image should be fully ready for use by new deployments.
|
Now the new image should be fully ready for use by new deployments.
|
||||||
|
@ -4,31 +4,6 @@
|
|||||||
Enable the appropriate repos for the desired release, as indicated below.
|
Enable the appropriate repos for the desired release, as indicated below.
|
||||||
Do not enable any other repos not explicitly marked for that release.
|
Do not enable any other repos not explicitly marked for that release.
|
||||||
|
|
||||||
.. admonition:: Mitaka
|
|
||||||
:class: mitaka ltom
|
|
||||||
|
|
||||||
Enable latest RDO Mitaka Delorean repository for all packages
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
sudo curl -L -o /etc/yum.repos.d/delorean-mitaka.repo https://trunk.rdoproject.org/centos7-mitaka/current/delorean.repo
|
|
||||||
|
|
||||||
Enable the Mitaka Delorean Deps repository
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
sudo curl -L -o /etc/yum.repos.d/delorean-deps-mitaka.repo https://trunk.rdoproject.org/centos7-mitaka/delorean-deps.repo
|
|
||||||
|
|
||||||
.. admonition:: Ceph
|
|
||||||
:class: ceph
|
|
||||||
|
|
||||||
Enable the CentOS Storage SIG Ceph/Hammer repository if using Ceph
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
sudo yum -y install --enablerepo=extras centos-release-ceph-hammer
|
|
||||||
sudo sed -i -e 's%gpgcheck=.*%gpgcheck=0%' /etc/yum.repos.d/CentOS-Ceph-Hammer.repo
|
|
||||||
|
|
||||||
.. admonition:: Newton
|
.. admonition:: Newton
|
||||||
:class: newton mton
|
:class: newton mton
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user