[OCF] proposal for improving the ra-api-1.dtd

[Huang Zhen]

Alan, would you like to update the ra-api-1.dtd?
Thank you very much!

<?xml version="1.0" ?>

<!ELEMENT resource-agent (version,longdesc+,shortdesc+,parameters,actions,special) >
<!ATTLIST resource-agent
     name    CDATA    #REQUIRED
     version CDATA   #IMPLIED>

<!ELEMENT version (#PCDATA)>

<!ELEMENT parameters (parameter*)>

<!ELEMENT actions (action*)>

<!ELEMENT parameter (longdesc+,shortdesc+,content)>
<!ATTLIST parameter
     name    CDATA    #REQUIRED
     unique    (1|0)    "0"
     required (1|0)  "0"
     expert_level (0|1|2|3) "0">

<!ELEMENT longdesc ANY>
<!ATTLIST longdesc
     lang    NMTOKEN    #IMPLIED>

<!ELEMENT shortdesc ANY>
<!ATTLIST shortdesc
     lang    NMTOKEN    #IMPLIED>

<!ELEMENT content EMPTY>
<!ATTLIST content
     type    (string|integer|boolean)    #REQUIRED
     default CDATA    #IMPLIED>

<!ELEMENT action EMPTY>
<!ATTLIST action
     name    (start|stop|recover|status|reload|meta-data|verify-all)    #REQUIRED
     timeout        CDATA    #REQUIRED
     interval     CDATA    #IMPLIED
     start-delay     CDATA    #IMPLIED
     depth        CDATA    #IMPLIED>

<!ELEMENT special ANY>
<!ATTLIST special
     tag    CDATA    #REQUIRED>


Huang Zhen wrote:
> Hello,
> If no opposition here, would someone kindly tell me what process I 
> should follow to update the DTD in CVS?
> 
> Lon Hohberger wrote:
> 
>> On Tue, 2005-11-22 at 08:51 +0800, Huang Zhen wrote:
>>
>>> Lon Hohberger wrote:
>>>
>>>> On Mon, 2005-11-21 at 11:00 +0800, Huang Zhen wrote:
>>>>
>>>>
>>>>
>>>>> 1. Add "longdesc" and "shortdesc" to resource-agent. The 
>>>>> description of resource agent itself will be put here.
>>>>> 2. Add "required" to parameter. if it's 1, the parameter is required.
>>>>
>>>>
>>>>
>>>> +1 for these two.  I have no opinion on the third.
>>>
>>>
>>> Sorry that I may misunderstood your meaning, do you mean that we 
>>> should add only one of first two points?
>>> I think the 1) is about the resource-agent, and 2) is about the 
>>> parameter, they are not duplicated.
>>> Would you like to explain more? Thanks!
>>
>>
>>
>> Sorry - I think #1 and #2 are both good.  In fact, I also suggested the
>> same things about a year ago, although nothing came of it in the end.
>>
>> #3 makes a lot of sense too, esp. if you are auto-generating a UI based
>> on meta-data output from the RAs.
>>
>> The amount of information in the RA metadata is currently insufficient
>> to present a good, auto-generated UI.  All three of your suggestions
>> improve on that.
>>
>> -- Lon
>>
>> _______________________________________________
>> OCF mailing list
>> OCF at lists.community.tummy.com
>> http://lists.community.tummy.com/mailman/listinfo/ocf
>>
> 
> 


-- 
Best Regards,
Huang Zhen
Linux Technology Center
IBM China Development Lab, Beijing
Telno: (8610)82782244-2845