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 majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
