dev@glassfish.java.net

Re: question about version attribute of domain element

From: Tom Mueller <tom.mueller_at_oracle.com>
Date: Tue, 15 Mar 2011 14:10:36 -0500

On 3/15/2011 12:07 PM, Vince Kraemer wrote:
> Hi all,
>
> How is the version attribute of the domain element used?
The value is included in the output of the "asadmin version" command, in
the parenthesis after the word "build". It also shows up in the
"About..." screen in the admin console.

> Does it indicate the version of that particular domain.xml... so using
> 'asadmin set' and the like would update the value?
The build process modifies the domain.xml template that is used to
create domains to have the build information.
The Domain ConfigBean has no setVersion operation, so it cannot be set
using "asadmin set". It also cannot be set via the REST interface.

Note: the set command doesn't fail when you do "asadmin set
domain.version=foo", but it doesn't change it either. This is a bug.

>
> Does it indicate the version of the server that wrote that file?
Right now, it indicates the version of the domain.xml template that was
used to create the domain. Or, if the user edits the domain.xml file
manually, it means whatever they want it to mean.

Near the end of the 3.1 release, I was considering using this to
determine the version of the software that last wrote the file so that
it could be used to help determine whether it was necessary to start the
domain with the --upgrade option, but I gave up on that because the
value wasn't reliable or predictable.

Tom

>
> Thanks,
> vbk
>