Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: document "readforward" and "readproxy" cache mode #7023

Merged
1 commit merged into from Dec 23, 2015
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
17 changes: 17 additions & 0 deletions doc/rados/operations/cache-tiering.rst
Expand Up @@ -64,6 +64,23 @@ configure how this migration takes place. There are two main scenarios:
might contain out-of-date data provides weak consistency. Do not use
``readonly`` mode for mutable data.

And the modes above are accomodated to adapt different configurations:

- **Read-forward Mode:** this mode is the same as the ``writeback`` mode
when serving write requests. But when Ceph clients is trying to read objects
not yet copied to the cache tier, Ceph **forward** them to the backing tier by
replying with a "redirect" message. And the clients will instead turn to the
backing tier for the data. If the read performance of the backing tier is on
a par with that of its cache tier, while its write performance or endurance
falls far behind, this mode might be a better choice.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

clients might have a stale read here? e.g. the newly writes are not flushed to the base tier from cache tier, but the read requests are serviced from base tier.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

right. that's why i put a precondition here

read objects not yet copied to the cache tier

- **Read-proxy Mode:** this mode is similar to ``readforward`` mode: both
of them do not promote/copy the data when the requested object does not
exist in the cache tier. But instead of redirecting the Ceph clients to the
backing tier when cache misses, the cache tier reads from the backing tier
on behalf of the clients. Under some circumstances, this mode can help to
reduce the latency.

Since all Ceph clients can use cache tiering, it has the potential to
improve I/O performance for Ceph Block Devices, Ceph Object Storage,
the Ceph Filesystem and native bindings.
Expand Down