kolla-ansible/doc/liberty-deployment-warning.rst
Swapnil Kulkarni (coolsvap) d87b4f63a2 Structuring the documentation
Restructured the documenation to

1. Add reference at the top
2. Updated the title formatting
3. Updated the heading formatting
4. Updated the links formatting

Change-Id: Ie3786e92fee674da1fa39cf07f1bf0a3badd5b92
2016-05-16 23:55:35 +05:30

40 lines
1.4 KiB
ReStructuredText

.. _liberty-deployment-warning:
================================
Liberty 1.0.0 Deployment Warning
================================
Warning Overview
================
Please use Liberty 1.1.0 tag or later when using Kolla. No data loss
occurs with this version. stable/liberty is also fully functional and
suffers no data loss.
Data loss with 1.0.0
====================
The Kolla community discovered in the of middle Mitaka development that it
was possible for data loss to occur if the data container is rebuilt. In
this scenario, Docker pulls a new container, and the new container doesn't
contain the data from the old container. Kolla stable/liberty and Kolla
1.0.0 are not to be used at this time, as they result in *critical data loss
problems*.
Resolution
==========
To rectify this problem, the OpenStack release and infrastructure teams
in coordination with the Kolla team executed the following actions:
* Deleted the stable/liberty branch (where 1.0.0 was tagged from)
* Created a tag liberty-early-demise at the end of the broken stable/liberty
branch development.
* Created a new stable/liberty branch based upon stable/mitaka.
* Corrected stable/liberty to deploy Liberty.
* Released Kolla 1.1.0 from the newly created stable/liberty branch.
End Result
==========
A fully functional Liberty OpenStack deployment based upon the two years of
testing that went into the development that went into stable/mitaka.
The docker-engine 1.10.0 or later is required.