[ClusterLabs] Q: All the versions

[Ken Gaillot]

On Wed, 2020-03-18 at 10:31 +0100, Ulrich Windl wrote:
> Hi!
> 
> I have a question on the various versions in the RA metadata. For
> example:
> 
> <?xml version="1.0"?>
> <!DOCTYPE resource-agent SYSTEM "ra-api-1.dtd">
> <resource-agent name="HealthCPU" version="0.1">
> <version>1.0</version>
> 
> The XML version should be OK. Next version is the RA API version 1 as
> indicated in the file name.
> Then the resource-agent element has version "0.1".
> Is that the version (0.1) that should be incremented if the metadata
> changes or the contents of the <version> element (1.0)?
> 
> Confused, sorry!
> 
> Regards,
> Ulrich

It is definitely confusing.

The version inside <resource-agent> is for the agent's own use, so the
agent developer can do whatever they want with that one.

The <version> tag is for the RA API version (it happens to be in the
DTD filename as well, but what that file is named is not considered to
have any significance). If possible I'd rename this to be clearer but
that's probably not a good idea due to backward compatibility issues.
-- 
Ken Gaillot <kgaillot at redhat.com>