https://tracker.ceph.com/https://tracker.ceph.com/favicon.ico2022-11-16T04:53:38ZCeph Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2282472022-11-16T04:53:38ZZac Dover
<ul></ul><p><a class="external" href="https://docs.ceph.com/en/quincy/rbd/">https://docs.ceph.com/en/quincy/rbd/</a></p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2282482022-11-16T04:56:03ZCole Mitchell
<ul></ul><p>As of 16 Nov 2022 AEST, the front matter of the RBD book reads as follows:</p>
<blockquote>
<p>A block is a sequence of bytes (often 512). Block-based storage interfaces are a mature and common way to store data on media including HDDs, SSDs, CDs, floppy disks, and even tape. The ubiquity of block device interfaces is a perfect fit for interacting with mass data storage including Ceph.</p>
<p>Ceph block devices are thin-provisioned, resizable, and store data striped over multiple OSDs. Ceph block devices leverage RADOS capabilities including snapshotting, replication and strong consistency. Ceph block storage clients communicate with Ceph clusters through kernel modules or the librbd library.</p>
<p>Ceph’s block devices deliver high performance with vast scalability to kernel modules, or to KVMs such as QEMU, and cloud-based computing systems like OpenStack and CloudStack that rely on libvirt and QEMU to integrate with Ceph block devices. You can use the same cluster to operate the Ceph RADOS Gateway, the Ceph File System, and Ceph block devices simultaneously.</p>
</blockquote> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2283932022-11-23T16:26:59ZZac Dover
<ul></ul><p><a class="external" href="https://medium.com/system-design-blog/eventual-consistency-vs-strong-consistency-b4de1f92534d">https://medium.com/system-design-blog/eventual-consistency-vs-strong-consistency-b4de1f92534d</a> - A medium.com article describing the difference between "strong consistency" and "immediate consistency".</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2283942022-11-23T16:32:29ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49035">https://github.com/ceph/ceph/pull/49035</a></p>
<p>This PR swaps the order of the first two paragraphs in the front matter.</p>
<p>This sentence remains in need of a rewrite: "The ubiquity of block device interfaces is a perfect fit for interacting with mass data storage including Ceph.". I doubt that block device interfaces' ubiquity is what makes block device interfaces a perfect fit for interacting with mass data storage. I suspect rather that block device interfaces are generally available and are likely to be familiar or easily learned.</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2289272022-12-06T13:04:31ZZac Dover
<ul><li><strong>Subject</strong> changed from <i>Improve RBD Getting Started Documentation</i> to <i>RBD Rewrite Project</i></li><li><strong>Category</strong> set to <i>documentation</i></li><li><strong>Status</strong> changed from <i>New</i> to <i>In Progress</i></li></ul><p>Many semantic errors are present in the text of the RBD documentation as of 06 Dec 2022. Each of the files in the doc/rbd/ directory could be improved by an editorial pass focused on the semantics of the text.</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2289282022-12-06T13:18:11ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49282">https://github.com/ceph/ceph/pull/49282</a> - Refine the "Create a Block Device Pool" section of doc/rbd/rados-rbd-cmds.rst.</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2289332022-12-06T14:22:32ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49283">https://github.com/ceph/ceph/pull/49283</a> - Refine "Create a Block Device User" in doc/rbd/rados-rbd-cmds.rst.</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2290452022-12-07T16:54:47ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49282">https://github.com/ceph/ceph/pull/49282</a> - Refine the "Create a Block Device Pool" section of doc/rbd/rados-rbd-cmds.rst.</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2290732022-12-08T05:26:40ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49306">https://github.com/ceph/ceph/pull/49306</a> - Refine "Create a Block Device User"</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2291412022-12-08T23:55:40ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49338">https://github.com/ceph/ceph/pull/49338</a> - doc/rbd: refine "Creating a Block Device Image"</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2291422022-12-09T00:23:44ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49339">https://github.com/ceph/ceph/pull/49339</a> - refine "Listing Block Device Images" in doc/rbd/rados-rbd-cmds.rst</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2291432022-12-09T00:28:15ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49340">https://github.com/ceph/ceph/pull/49340</a> - refine "Retrieving Image Information" in doc/rbd/rados-rbd-cmds.rst.</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2291452022-12-09T01:04:36ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49341">https://github.com/ceph/ceph/pull/49341</a> -refine "Resizing a Block Device Image" in doc/rbd/rados-rbd-cmds.rst.</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2291472022-12-09T01:21:17ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49342">https://github.com/ceph/ceph/pull/49342</a> - refine "Removing a Block Device Image" in doc/rbd/rados-rbd-cmds.rst</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2291482022-12-09T01:33:03ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49343">https://github.com/ceph/ceph/pull/49343</a> - refine "Restoring a Block Device Image" in doc/rbd/rados-rbd-cmds.rst</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2292782022-12-13T03:22:12ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49394">https://github.com/ceph/ceph/pull/49394</a> - refine rbd-snapshot.rst</p> Ceph - Documentation #57001: RBD Rewrite Projecthttps://tracker.ceph.com/issues/57001?journal_id=2295412022-12-18T15:35:18ZZac Dover
<ul></ul><p><a class="external" href="https://github.com/ceph/ceph/pull/49488">https://github.com/ceph/ceph/pull/49488</a> - refine rbd-exclusive-locks.rst</p>