From: Andre Noll <maan@systemlinux.org>
To: Tommi Virtanen <tommi.virtanen@dreamhost.com>
Cc: Gregory Farnum <gregory.farnum@dreamhost.com>,
Sage Weil <sage@newdream.net>,
ceph-devel@vger.kernel.org
Subject: Re: v0.38 released
Date: Mon, 21 Nov 2011 18:32:54 +0100 [thread overview]
Message-ID: <20111121173254.GN13394@systemlinux.org> (raw)
In-Reply-To: <CAORUGqBNus_UuYOvkjcAtsbz+S1AKbafB1utwqAyq=sB7j8g9w@mail.gmail.com>
[-- Attachment #1: Type: text/plain, Size: 3843 bytes --]
On Fri, Nov 18, 10:47, Tommi Virtanen wrote:
> On Fri, Nov 18, 2011 at 07:01, Andre Noll <maan@systemlinux.org> wrote:
> > For starters, it would be nice to include the ceph osd subcommands
> > in the man pages. To my knowledge they are only documented on the
> > (old) wiki
> >
> > http://ceph.newdream.net/wiki/Monitor_commands
> >
> > at the moment. Would a patch that adds the subcommands and descriptions
> > to the man pages be accepted?
>
> I'm not sure if the man page are the best for that; there's a lot of
> subcommands, and man forces it into a big list of things. I'd
> personally go for putting a reference under
> http://ceph.newdream.net/docs/latest/ops/ and using the structure for
> separating osd/mon/mds etc into slightly more manageable chunks.
I believe that code and documentation should be located as close as
possible, and I'd also prefer to edit and access the documentation
locally via command line tools rather than through a browser. But
I don't have a strong opinion on this, so let's go for the web
documentation.
Should I prepare something and post a request for inclusion to the
web pages on this mailing list, or do you want me to edit the web
documentation directly?
> > If so, I'd be willing to do this work. However, the files in man/
> > of the ceph git repo seem to be generated by docutils, so I suspect
> > they are not meant to be edited directly. What's the preferred way
> > to patch the man pages?
>
> The content comes from doc/man/ and is built with ./admin/build-doc
>
> That puts the whole html into build-doc/output/html/ and the *roff in
> build-doc/output/man/ and from there it is migrated to man/ "by need"
> (there's too much noise in the changes to keep doing that all the
> time, and there's too many toolchain dependencies to generate docs on
> every build).
I see, thanks for explaining. The ./admin/build-doc command worked
for me out of the box on an Ubuntu lucid system btw.
> >> Step 2: have a monitoring system be able to feed back information to
> >> use as osd weights, with admin customazability
> > How could such a monitoring system be implemented? In particular if
> > abstract criteria like "future extension plans" have to be considered.
>
> Going back to my initial list: storage size, disk IO speed, network
> link bandwidth, heat in that
> part of the data center, future expansion plans, ..
>
> That divides into 3 groups:
> - things that are more about the capability of the hardware (= change
> very seldomly)
> - things that are monitored outside of ceph
> - plans
>
> Hence, it seems to me that a sysadmin would do something like look at
> the node data gathered by something like Ohai/Chef, combine that with
> collectd/munin-style monitoring of the data center, optionally do
> something like "increase weights of rack 7 by 40%", and then spit out
> a mapping of osd id -> weight.
OK, got the idea. However, in this example the difficult thing is
the decision "increase weights of rack 7 by 40%", which is made by a
human. Recomputing the osd weights accordingly should be fairly simple.
> Our chef cookbooks will probably provide a skeleton for that in the
> future, but that's not a short term need; most installations will
> probably set the weights once when the hardware is new, and I'd expect
> practically all clusters <6 months old to have fairly homogenous
> hardware, and thus identical weights.
Are you implying that ceph is only suitable for new clusters with
homogeneous hardware? I'm asking because our cluster is far from
homogeneous. There are 8 year old 2-core nodes with small SCSI disks
as well as 64-core boxes with much larger SATA disks.
Thanks
Andre
--
The only person who always got his work done by Friday was Robinson Crusoe
[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 198 bytes --]
next prev parent reply other threads:[~2011-11-21 17:31 UTC|newest]
Thread overview: 23+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-11-11 5:14 v0.38 released Sage Weil
2011-11-15 16:42 ` Andre Noll
2011-11-15 19:53 ` Gregory Farnum
2011-11-16 9:56 ` Andre Noll
2011-11-16 18:04 ` Tommi Virtanen
2011-11-17 10:35 ` Andre Noll
2011-11-17 18:01 ` Tommi Virtanen
2011-11-18 15:01 ` Andre Noll
2011-11-18 18:47 ` Tommi Virtanen
2011-11-21 17:32 ` Andre Noll [this message]
2011-11-21 17:36 ` Tommi Virtanen
2011-11-21 18:06 ` Andre Noll
2011-11-28 14:04 ` [PATCH/RFC 0/6]: Introduction Andre Noll
2011-11-28 14:04 ` [PATCH/RFC 1/6] doc: Import the list of ceph subcommands from wiki Andre Noll
2011-11-28 14:04 ` [PATCH/RFC 2/6] doc: Add documentation of missing osd commands Andre Noll
2011-11-28 14:04 ` [PATCH/RFC 3/6] doc: Document pause and unpause " Andre Noll
2011-11-28 14:04 ` [PATCH/RFC 4/6] doc: Update the list of fields for the pool set command Andre Noll
2011-11-28 14:04 ` [PATCH/RFC 5/6] doc: Add missing documentation for osd pool get Andre Noll
2011-11-28 18:37 ` Gregory Farnum
2011-11-28 19:27 ` Andre Noll
2011-11-28 14:04 ` [PATCH/RFC 6/6] doc: Clarify documentation of reweight command Andre Noll
2011-12-05 21:09 ` [PATCH/RFC 0/6]: Introduction Tommi Virtanen
2011-12-06 17:01 ` Andre Noll
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20111121173254.GN13394@systemlinux.org \
--to=maan@systemlinux.org \
--cc=ceph-devel@vger.kernel.org \
--cc=gregory.farnum@dreamhost.com \
--cc=sage@newdream.net \
--cc=tommi.virtanen@dreamhost.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox