[Linux-HA] Learning the CIB

[Andrew Beekhof]

On 1/5/07, Pavol Gono <palo.gono at gmail.com> wrote:
> Hi
>
> Nice reading is in source tree:
> crm/crm-1.0.dtd
> crm/crm.txt (chapter 5)
> Just take the latest sources from http://hg.linux-ha.org/dev/. Web
> page http://www.linux-ha.org/ClusterResourceManager/DTD1.0/Annotated
> is maybe not quite up-to-date.
>
> I'll answer what is simple to answer :)
>
>
> On 1/5/07, vini.bill at gmail.com <vini.bill at gmail.com> wrote:
> > Hi guys.
> >
> >     As I said in a previous mail, I'm Writing a document teaching how to use
> > the CIB Tags, how to place them, what they mean and something more that I
> > haven't foreseen. I intend to contribute it back to the project. I'd like to
> > discuss some topics that I haven't understood very well so as I can write
> > about them. I'll also make some minor comparsions with XHTML to make things
> > a bit clearer to me but I won't make these on the final text.
> >
> >     Today, before leaving work I'll seek somewhere to post it so you can
> > take a look at my progress. It`ll be in a Wiki format since I`m going to
> > publish it on the wiki we have here and to make easier to add to the main
> > documentation.
> >
> > 1) Is there any directive that isn't contained on the <cib> </cib> ? Can I
> > create groups of configurations ( if yes, what would be the necessity to
> > have it? ) ?

i dont understand the question

> >
> > 2) There are only 4 configuration tags: (1) constraints, (2) crm_config and
> > (3) resources and the (4) nodes. Is that right ?
>
> yes

correct.  and how do we know this?
we know this because the DTD says so:
  <!ELEMENT configuration (crm_config, nodes, resources, constraints)>

I suggest starting with wikipedia's entry on DTDs:
    http://en.wikipedia.org/wiki/Document_Type_Definition

>
> >
> > 3) What does the empty <nodes/> tag mean? The CRM daemon will fill in every
> > node automagically ?
>
> yes, user doesn't need to fill in nodes tag.
>
> >
> > 4) What do operations do in a primitive?
>
> e.g. you can tell heartbeat to monitor your resource

or override various defaults... like what action to take if a start
action fails (or how long to wait before deciding that it failed)

>
> >
> > 5) What is the difference between <atributes> and <instance_atributes> ??

more information?

> > 6) Is there any tag missing on this page (
> > http://www.linux-ha.org/ClusterResourceManager/DTD1.0/Annotated ) that I
> > should look for by myself ?
>
> See crm/crm-1.0.dtd

correct, the online version seems to be somewhat out of date

> > 7) What does the empty <status/> tag mean?
>
> status tag is filled in by heartbeat at runtime, user shouldn't write
> to it. The command "cibadmin -Ql" is good for reading this tag.