doc: 12.2.0 major release announcements #16915

theanalyst · 2017-08-08T18:47:56Z

Reordered the RC releases sections back to their respective components,
added a ceph-mon section, added links to documentation wherever
possible, and a few forgotten RGW announcements.

Signed-off-by: Abhishek Lekshmanan abhishek@suse.com

theanalyst · 2017-08-08T18:48:42Z

can everyone please review their respective sections (not only a part of the diff) to see that we've missed nothing out

liewegas · 2017-08-08T19:14:29Z

doc/release-notes.rst

-      will form the basis for API-based management of Ceph going forward.
-    - *ceph-mgr* also includes a `Prometheus exporter <../mgr/prometheus>`_
-       plugin, which can provide Ceph perfcounters to Prometheus.
-


This section is for high-level highlights and should stay where it is.

liewegas · 2017-08-08T19:15:34Z

doc/release-notes.rst

+  * The 'mon_warn_osd_usage_min_max_delta' config option has been
+    removed and the associated health warning has been disabled because
+    it does not address clusters undergoing recovery or CRUSH rules that do
+    not target all devices in the cluster.


This stuff shoudl go in the compatibility notes section below

liewegas · 2017-08-08T19:16:31Z

doc/release-notes.rst

+    containing high-level information of the Ceph cluster. This makes
+    it easy to monitor a Ceph cluster's status and send out
+    notifications in case of a malfunction.
+


this should go back above where it was

branch-predictor · 2017-08-09T08:09:22Z

Missing stuff form PendingReleaseNotes?

theanalyst · 2017-08-09T08:50:37Z

@branch-predictor updated, thanks!

theanalyst · 2017-08-09T08:58:32Z

Rendered version of docs at http://docs.ceph.com/docs/doc-12.2.0-major-changes/release-notes/

liuchang0812 · 2017-08-10T03:51:51Z

doc/release-notes.rst

@@ -46,17 +42,24 @@ Major Changes from Kraken
    allowing them to be used with RBD and CephFS.

  * *ceph-mgr*:
-


do not delete this blank line. reStructedText needs it.

smithfarm · 2017-08-09T12:55:11Z

doc/release-notes.rst

+      ``ceph osd pool stats``. Although these commands do not
+      self-update like ``ceph -w`` did, they do have the ability to
+      return formatted output by providing a ``--format=<format>``
+      option.


@theanalyst Please drop this entire "New ceph -w behavior" bullet point. The old behavior has been reinstated and "ceph pg stat" is giving me EINVAL.

So, I still don't quite know what is going on, but the ceph -w behavior in luminous is definitely different and, I think, deserves a release note. The current one isn't quite right, though, because - AFAICT - in luminous it is still possible to get real-time I/O information from ceph -w. So, let's change it to this:

+ - New "ceph -w" behavior - the "ceph -w" output no longer updates + available space, pg info, etc. in real time because these are no + longer logged to the central log (which is what "-w" + shows). Some of the information can be obtained by running ``ceph pg + stat``. Also, if the I/O information provided by "-w" is not fine-grained + enough, I/O rates per pool can be determined using + ``ceph osd pool stats``.

@jcsp What do you think? The current ceph -w behavior is a little confusing - it sits there, apparently listening to the central log, but in a quiescent cluster nothing appears. So far I tried creating and deleting rbd images, which I would think would create some I/O, but still nothing appeared. I have anecdotal evidence that ceph -w does produce self-updating I/O information during performance tests.

@theanalyst Now I know what's going on. In Luminous, ceph -w just displays the same info as ceph -s and then enters an infinite wait loop. It doesn't update anything. I opened http://tracker.ceph.com/issues/20995 to track that bug.

So, please ignore everything I have said up until now, and leave the release note as it is!

alfredodeza · 2017-08-11T19:43:04Z

jenkins test docs

alfredodeza · 2017-08-16T20:00:39Z

this will need to be rebased to make use of all the fixes for docs that just went into master

alfredodeza · 2017-08-16T20:00:47Z

jenkins test docs

theanalyst · 2017-08-24T12:42:09Z

jenkins render docs

theanalyst · 2017-08-28T18:33:05Z

jenkins render docs

liewegas · 2017-08-28T18:36:13Z

doc/release-notes.rst

+  * Added new configuration "public bind addr" to support dynamic
+    environments like Kubernetes. When set the Ceph MON daemon could
+    bind locally to an IP address and advertise a different IP address
+    ``public addr`` on the network.


This is mixing in the detailed compat notes into the feature highlights section. This stuff goes in the lower section, 'Upgrade compatibility notes'

Actually, let's move the 'pg force-*' bits to teh CLi changes, and the choose-args encoding to the compat notes. Pool metadata can stay.

ceph-jenkins · 2017-08-28T18:43:00Z

Doc render available at http://docs.ceph.com/ceph-prs/16915/

theanalyst · 2017-08-28T22:03:51Z

jenkins render docs

theanalyst · 2017-08-29T09:21:49Z

jenkins render docs

theanalyst · 2017-08-29T09:22:36Z

@liewegas made the changes, also added the changelog from post 12.1.4, and amalgamated all the previous RC/dev releases into one large 12.2.0 changelog, wdyt?

xiexingguo · 2017-08-29T10:19:02Z

doc/release-notes.rst

+      option.
+
+    - Added new commands ``pg force-recovery`` and
+      ``pg-force-backfill``. Use them to boost recovery or backfill


s/pg-force-backfill/pg force-backfill/

Reordered the RC releases sections back to their respective components, added a ceph-mon section, added links to documentation wherever possible, and a few forgotten RGW announcements. Also cleared up the PendingReleaseNotes upto this point Signed-off-by: Abhishek Lekshmanan <abhishek@suse.com>

theanalyst · 2017-08-29T12:45:59Z

jenkins render docs

theanalyst · 2017-08-29T12:46:41Z

@liewegas can you review again

liewegas · 2017-08-29T13:29:34Z

doc/release-notes.rst

@@ -90,34 +93,47 @@ Major Changes from Kraken
    ``osd_snap_trim_sleep``, and ``osd_scrub_sleep`` have been
    reimplemented to work efficiently.  (These are used in some cases
    to work around issues throttling background work.)
+  * The crush ``choose_args`` encoding has been changed to make it
+    architecture-independent.


this compat note should go in the upgrade notes down below.

liewegas · 2017-08-29T13:31:58Z

doc/release-notes.rst


+    Ceph versions are released through the regular FreeBSD ports and packages


eliminating this newline will (i think) make the blank lines in teh rendered output go away.

theanalyst · 2017-08-29T13:48:33Z

jenkins render docs

theanalyst · 2017-08-29T15:08:40Z

jenkins render docs

ceph-jenkins · 2017-08-29T15:17:28Z

Doc render available at http://docs.ceph.com/ceph-prs/16915/

theanalyst · 2017-08-29T15:18:21Z

@liewegas docs build succeeded, does http://docs.ceph.com/ceph-prs/16915/release-notes/ look ok?

tchaikov · 2017-08-29T15:40:47Z

doc/release-notes.rst

-* msg: Initialize member variables in Infiniband (`pr#16781 <https://github.com/ceph/ceph/pull/16781>`_, amitkuma)
-* msg: Remove unused variable perf_counter in RDMAStack (`pr#16783 <https://github.com/ceph/ceph/pull/16783>`_, amitkuma)
-* msgr: messages: Initializing uninitialized members MMonGetVersion (`pr#16811 <https://github.com/ceph/ceph/pull/16811>`_, amitkuma)
-* msgr: messages: Initializing uninitialized members MMonGet


@theanalyst this line does not look right.

tchaikov · 2017-08-29T15:42:40Z

doc/release-notes.rst

-* msg: Initialize member variables in Infiniband (`pr#16781 <https://github.com/ceph/ceph/pull/16781>`_, amitkuma)
-* msg: Remove unused variable perf_counter in RDMAStack (`pr#16783 <https://github.com/ceph/ceph/pull/16783>`_, amitkuma)
-* msgr: messages: Initializing uninitialized members MMonGetVersion (`pr#16811 <https://github.com/ceph/ceph/pull/16811>`_, amitkuma)
-* msgr: messages: Initializing uninitialized members MMonGet


@theanalyst and this line does not look right.

tchaikov · 2017-08-29T15:43:20Z

doc/release-notes.rst

-* msg: Initialize member variables in Infiniband (`pr#16781 <https://github.com/ceph/ceph/pull/16781>`_, amitkuma)
-* msg: Remove unused variable perf_counter in RDMAStack (`pr#16783 <https://github.com/ceph/ceph/pull/16783>`_, amitkuma)
-* msgr: messages: Initializing uninitialized members MMonGetVersion (`pr#16811 <https://github.com/ceph/ceph/pull/16811>`_, amitkuma)
-* msgr: messages: Initializing uninitialized members MMonGet


theanalyst · 2017-08-29T16:05:27Z

jenkins render docs

theanalyst · 2017-08-29T16:08:19Z

jenkins render docs

ceph-jenkins · 2017-08-29T16:17:40Z

Doc render available at http://docs.ceph.com/ceph-prs/16915/

Amalgamated all the dev & RC changelogs + the changelog we saw post 12.1.4 into one large 12.2.0 changelog. Signed-off-by: Abhishek Lekshmanan <abhishek@suse.com>

theanalyst · 2017-08-29T18:51:55Z

@liewegas squashed the commits, this can be merged

theanalyst requested review from mattbenjamin, liewegas, jecluis, batrick, jcsp, jdurgin and dillaman August 8, 2017 18:47

theanalyst added the documentation label Aug 8, 2017

liewegas requested changes Aug 8, 2017

View reviewed changes

batrick approved these changes Aug 8, 2017

View reviewed changes

theanalyst force-pushed the doc-12.2.0-major-changes branch from 9dc8efe to 81bec60 Compare August 8, 2017 19:55

theanalyst force-pushed the doc-12.2.0-major-changes branch from 81bec60 to 272961c Compare August 9, 2017 08:49

theanalyst requested a review from smithfarm August 9, 2017 12:46

theanalyst force-pushed the doc-12.2.0-major-changes branch from 272961c to adf8bf0 Compare August 9, 2017 12:50

liuchang0812 reviewed Aug 10, 2017

View reviewed changes

smithfarm reviewed Aug 10, 2017

View reviewed changes

theanalyst force-pushed the doc-12.2.0-major-changes branch from adf8bf0 to 932a60d Compare August 24, 2017 12:41

theanalyst force-pushed the doc-12.2.0-major-changes branch from 932a60d to d9a7c2d Compare August 24, 2017 17:13

liewegas reviewed Aug 28, 2017

View reviewed changes

theanalyst force-pushed the doc-12.2.0-major-changes branch from d9a7c2d to 36b3b9b Compare August 28, 2017 21:08

theanalyst force-pushed the doc-12.2.0-major-changes branch from 36b3b9b to 541cef2 Compare August 28, 2017 22:03

xiexingguo reviewed Aug 29, 2017

View reviewed changes

theanalyst force-pushed the doc-12.2.0-major-changes branch from 36d4bcd to 6f71c0a Compare August 29, 2017 12:45

liewegas reviewed Aug 29, 2017

View reviewed changes

theanalyst force-pushed the doc-12.2.0-major-changes branch from 5053d5b to 3be2c1b Compare August 29, 2017 14:20

theanalyst force-pushed the doc-12.2.0-major-changes branch from 2a4c86f to fb6ba94 Compare August 29, 2017 15:36

tchaikov reviewed Aug 29, 2017

View reviewed changes

theanalyst force-pushed the doc-12.2.0-major-changes branch from fb6ba94 to f84bdb4 Compare August 29, 2017 16:04

theanalyst force-pushed the doc-12.2.0-major-changes branch from f84bdb4 to 45c2b56 Compare August 29, 2017 16:08

doc: release notes: changelog for 12.2.0

12b4097

Amalgamated all the dev & RC changelogs + the changelog we saw post 12.1.4 into one large 12.2.0 changelog. Signed-off-by: Abhishek Lekshmanan <abhishek@suse.com>

theanalyst force-pushed the doc-12.2.0-major-changes branch from 45c2b56 to 12b4097 Compare August 29, 2017 18:51

liewegas approved these changes Aug 29, 2017

View reviewed changes

liewegas merged commit 1be5a85 into ceph:master Aug 29, 2017

		@@ -46,17 +42,24 @@ Major Changes from Kraken
		allowing them to be used with RBD and CephFS.

		* ceph-mgr:


		Ceph versions are released through the regular FreeBSD ports and packages

doc: 12.2.0 major release announcements #16915

doc: 12.2.0 major release announcements #16915

Conversation

theanalyst commented Aug 8, 2017

theanalyst commented Aug 8, 2017

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

branch-predictor commented Aug 9, 2017

theanalyst commented Aug 9, 2017

theanalyst commented Aug 9, 2017

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

smithfarm Aug 14, 2017 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

alfredodeza commented Aug 11, 2017

alfredodeza commented Aug 16, 2017

alfredodeza commented Aug 16, 2017

theanalyst commented Aug 24, 2017

theanalyst commented Aug 28, 2017

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ceph-jenkins commented Aug 28, 2017

theanalyst commented Aug 28, 2017

theanalyst commented Aug 29, 2017

theanalyst commented Aug 29, 2017

Choose a reason for hiding this comment

Choose a reason for hiding this comment

theanalyst commented Aug 29, 2017

theanalyst commented Aug 29, 2017

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

theanalyst commented Aug 29, 2017

theanalyst commented Aug 29, 2017

ceph-jenkins commented Aug 29, 2017

theanalyst commented Aug 29, 2017

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

theanalyst commented Aug 29, 2017

theanalyst commented Aug 29, 2017

ceph-jenkins commented Aug 29, 2017

theanalyst commented Aug 29, 2017

smithfarm Aug 14, 2017 •

edited