Bug 748019

Summary: Plugin docs: Fails to build because it doesn't recognize drift or bundle config in the descriptor
Product: [Other] RHQ Project Reporter: Deon Ballard <dlackey>
Component: PluginsAssignee: RHQ Project Maintainer <rhq-maint>
Status: CLOSED NOTABUG QA Contact: Mike Foley <mfoley>
Severity: unspecified Docs Contact:
Priority: medium    
Version: unspecifiedCC: hrupp
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-10-21 18:37:13 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Deon Ballard 2011-10-21 17:51:18 UTC 
I am building the resource plug-in docs:
http://support.rhq-project.org/display/RHQ/Generating+Plugin+Documentation

At step 2, when I'm building the plugin docs for all plugins, I run...

mvn org.rhq:rhq-core-plugindoc:plugindoc -Dmaven.test.skip=true

And I get a build failure at the platform plug-in....

[snip]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 4.217s
[INFO] Finished at: Fri Oct 21 13:49:50 EDT 2011
[INFO] Final Memory: 15M/76M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.rhq:rhq-core-plugindoc:4.0.1:plugindoc (default-cli) on project rhq-platform-plugin: Could not successfully parse plugin descriptor '/NotBackedUp/dlackey/rhq/modules/plugins/platform/src/main/resources/META-INF/rhq-plugin.xml'. UnmarshalException: cvc-complex-type.2.4.a: Invalid content was found starting with element 'drift-definition'. One of '{"urn:xmlns:rhq-plugin":content, "urn:xmlns:rhq-plugin":resource-configuration, "urn:xmlns:rhq-plugin":help, "urn:xmlns:rhq-plugin":server, "urn:xmlns:rhq-plugin":service}' is expected. -> [Help 1]
[snip]

I *think* the schema definition needs to be updated for those plugins which use drift and bundles (just platforms and JBoss, I think) to account for the new config.
Comment 1 Deon Ballard 2011-10-21 18:08:49 UTC 
Nope, that's not it. I checked rhq/modules/core/client-api/src/main/resources/rhq-plugin.xsd, and both drift-detection and bundle-target are declared.

Back to the drawing board.
Comment 2 Deon Ballard 2011-10-21 18:17:23 UTC 
Okay, one oddity just to note. How come the error says org.rhq:rhq-core-plugindoc:4.0.1 when the plugindoc jar that i build is version 4.1.0?
Comment 3 Deon Ballard 2011-10-21 18:37:13 UTC 
Yeah, that was the problem. It was maven looking at an old version of the plugindoc thing in my ~/.m2/ directory. When I manually set the version of the plugindoc thing to use -- mvn org.rhq:rhq-core-plugindoc:4.1.0-SNAPSHOT:plugindoc -- it built just fine.