Re: Documentation and Versions

[Josh Durgin <josh.durgin@inktank.com>]

On 08/01/2012 11:53 AM, Mandell Degerness wrote:
> Thank you.
>
> I'd like to make two additional, related requests:
>
> 1) The internal ceph --help output should include the new command options

Yeah, the help output could certainly be improved. The client tool
needs to talk to the monitors to determine what basic commands are
available, but it would help to give each subsystem a "help" command
that queried them as necessary to report available commands.

Some commands (like ceph osd tell ...) are implemented on the osds,
so the available subcommands could vary if osd versions differed, but
it's still possible to provide usage info for a given osd.

I've opened http://www.tracker.newdream.net/issues/2894 for this.

> 2) The internal error information should be better written.  Right
> now, "ceph osd crush set ..." seems to work (on 0.48).  If, however,
> you type "ceph osd crush get" (i.e. trying to see what other options
> work), you get the result "unknown command crush" which implies to me
> that none of the crush subcommands are implemented, rather than that
> the "get" subcommand is not implemented.

Yeah, the command processing could be a lot better.
I created http://www.tracker.newdream.net/issues/2895 for this
particular error.

Josh

> Regards,
> Mandell Degerness
>
> On Wed, Aug 1, 2012 at 10:12 AM, Josh Durgin <josh.durgin@inktank.com> wrote:
>> On 07/31/2012 03:10 PM, Mandell Degerness wrote:
>>>
>>> I was looking through the latest documentation on ceph.com and I
>>> really like some of the new ways of doing things.  What I find
>>> confusing, however, is the lack of documentation as to what version of
>>> ceph you need to be running in order to use the commands.  In
>>> particular, what is the required version of ceph to run the "ceph osd
>>> crush ..." commands?
>>
>>
>> Yeah, there should probably be versions in the docs. The 'ceph osd crush'
>> commands were added in 0.46, but there are bug fixes for
>> 'ceph osd crush set' in 0.48 and 'ceph osd crush move' in 0.49.
>>
>>> Regards,
>>> Mandell Degerness
>>
>>