This is an automated email from the ASF dual-hosted git repository. josephwu pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/mesos.git
commit 539841088a074b558a636a8e235f0f69f97b037f Author: Meng Zhu <[email protected]> AuthorDate: Wed Mar 6 11:02:48 2019 -0800 Added documentation regarding downgrading a Mesos cluster. The list of minimum capabilities is empty on purpose, as no downgrade-blocking capabilities have been added yet. Review: https://reviews.apache.org/r/70077/ --- docs/downgrades.md | 23 +++++++++++++++++++++++ docs/home.md | 1 + 2 files changed, 24 insertions(+) diff --git a/docs/downgrades.md b/docs/downgrades.md new file mode 100644 index 0000000..0820001 --- /dev/null +++ b/docs/downgrades.md @@ -0,0 +1,23 @@ +--- +title: Apache Mesos - Downgrade Compatibility +layout: documentation +--- + +# Downgrade Mesos + +This document serves as a guide for users who wish to downgrade from an +existing Mesos cluster to a previous version. This usually happens when +rolling back from problematic upgrades. Mesos provides compatibility +between any 1.x and 1.y versions of masters/agents as long as new features +are not used. Since Mesos 1.8, we introduced a check for minimum capabilities +on the master. If a backwards incompatible feature is used, a corresponding +minimum capability entry will be persisted to the registry. If an old master +(that does not possess the capability) tries to recover from the registry +(e.g. when rolling back), an error message will be printed containing the +missing capabilities. This document lists the detailed information regarding +these minimum capabilities and remediation for downgrade errors. + + +## List of Master Minimum Capabilities + +Currently, no minimum capabilities will block downgrades. diff --git a/docs/home.md b/docs/home.md index d0f3eb3..ad19919 100644 --- a/docs/home.md +++ b/docs/home.md @@ -23,6 +23,7 @@ layout: documentation * [Framework Rate Limiting](framework-rate-limiting.md) * [Maintenance](maintenance.md) for performing maintenance on a Mesos cluster. * [Upgrades](upgrades.md) for upgrading a Mesos cluster. +* [Downgrades](downgrades.md) for downgrading a Mesos cluster. * [Logging](logging.md) * [Monitoring / Metrics](monitoring.md) * [Debugging using the new CLI](cli.md)
