Documentation and Versions

Documentation and Versions

[Mandell Degerness]

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?

Regards,
Mandell Degerness

Re: Documentation and Versions

[Josh Durgin]

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

Re: Documentation and Versions

[Mandell Degerness]

Thank you.

I'd like to make two additional, related requests:

1) The internal ceph --help output should include the new command options
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.

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
>
>

Re: Documentation and Versions

[Josh Durgin]

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
>>
>>