On 05/04/2011 09:28 PM, Sage Weil wrote:

>> As an aside, I think that, to a certain extent, improving the 
>> documentation could contribute more to the code base...

> The replication is covered by
> http://ceph.newdream.net/wiki/Adjusting_replication_level

> Any specific suggestions on how that should be improved?

The wiki is a reasonably good instruction in getting ceph up and running,
but it could do a lot better in explaining the hows and whys of the system.

http://ceph.newdream.net/wiki/Adjusting_replication_level is a good example
of this. It tells you exactly how to adjust the overall replication level,
but it doesn't tell you how to control where the replicas are put. So you
go searching and you find 
http://ceph.newdream.net/wiki/Custom_data_placement_with_CRUSH
and it explains pretty well how to implement crush rules, but it doesn't
tell what each rule parametre actually does, nor does it (appear to) give
an exhaustive list of all parametres that are available.

So, all in all, I think that what is mostly needed in the wiki is a general
introduction to ceph, an explanation and diagram of how it works and how
its internals relate to each-other. All of this is in your thesis, I know,
but it is very difficult to connect an abstract academic paper to a concrete
configuration problem and configuration parametre.

I happily contribute to the wiki when I'm 100% sure that what I'm writing is
correct, but most of the time when I see a potential improvent of the wiki,
I lack the solid understanding that's needed for me to make that improvement
myself.

Z

--
To unsubscribe from this list: send the line "unsubscribe ceph-devel" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to