Bug 813729

Summary: EPP configuration files use multiple version of kernel xsd definition
Product: [JBoss] JBoss Enterprise Portal Platform 5 Reporter: Viliam Rockai <vrockai>
Component: PortalAssignee: Peter Palaga <ppalaga>
Status: VERIFIED --- QA Contact:
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 5.2.1.CR02CC: epp-bugs, theute
Target Milestone: ---   
Target Release: 5.2.2.ER01   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
It was discovered that several versions of kernel_1_*.xsd were referenced in XML configutation files. While no harmful consequences existed by having these obsolete templates declared, it made the XML files appear inconsistent. The fix removes all kernel_1_[^2].xsd, and replaces these references with kernel_1_2.xsd which makes the XML configuration files consistent.
Story Points: ---
Clone Of: Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Viliam Rockai 2012-04-18 10:30:36 UTC
EPP configuration files use multiple version of kernel xsd definition. Those version are 1.0, 1.1 and 1.2. 1.2 is the correct version according to our reference guide.

$ cd $JBOSS_HOME/server/default
$ grep -C 3 'kernel_' * -R

this will give the list of kernel versions in EPP files.

Comment 1 Peter Palaga 2012-06-12 11:32:00 UTC
Version 1.2 should be used not only for kernel XSD but also for two other XSDs: gatein_objects and gatein_resources. 
The occurrences should be fixed not only in the configuration files but also in the documentation.
Use the following greps to find only the problematic locations:

grep -C 3 'kernel_1_[^2]' * -R
grep -C 3 'gatein_objects_1_[^2]' * -R
grep -C 3 'gatein_resources_1_[^2]' * -R

Comment 2 Peter Palaga 2012-06-15 10:20:47 UTC
Fixed only for kernel XSD refs. All changed XML files are valid against kernel_1_2.xsd.

After discussing this with Bolek, we decided to WONTFIX this for gatein_objects and gatein_resources XSDs. The code which reads the corresponding XMLs does not validate them against any XSDs. The change would be too extensive for a minor release and could break running instances.

Comment 3 Peter Palaga 2012-06-15 10:20:48 UTC
    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
Cause: Due to historical reasons several versions of kernel_1_*.xsd were referenced from XML configutation files.
Consequence: No harmful consequences known. XML configuration files seemed to be unconsistent.
Fix: All kernel_1_[^2].xsd references were replaced by kernel_1_2.xsd.
Result: XML configuration files look consistent.

Comment 4 Jared MORGAN 2012-08-21 01:34:58 UTC
    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -1,4 +1 @@
-Cause: Due to historical reasons several versions of kernel_1_*.xsd were referenced from XML configutation files.
+It was discovered that several versions of kernel_1_*.xsd were referenced in XML configutation files. While no harmful consequences existed by having these obsolete templates declared, it made the XML files appear inconsistent. The fix removes all kernel_1_[^2].xsd, and replaces these references with kernel_1_2.xsd which makes the XML configuration files  consistent.-Consequence: No harmful consequences known. XML configuration files seemed to be unconsistent.
-Fix: All kernel_1_[^2].xsd references were replaced by kernel_1_2.xsd.
-Result: XML configuration files look consistent.

Comment 5 Viliam Rockai 2012-08-28 12:19:15 UTC
Verified again at 5.2.2 CR01