Opening or deploying a V5.0 enterprise archive (.ear) file in the V4.0 Application Assembly Toolkit (AAT) or EARExpander generates a warning exception
 Technote (FAQ)
 
Problem
You have created an .ear file within WebSphere® Studio Application Developer V5.0. When trying to either view the .ear file with the version 4.0 Application Assembly Toolkit (AAT) or deploy the .ear file with the EARExpander, you receive a warning exception.

Now you want to know: Is WebSphere Studio Application Developer V5.0 backward compatible?
 
Cause
The version of Java™ 2 Enterprise Edition (J2EE™) was set incorrectly when the .ear project was created.
 
Solution
Yes, WebSphere Studio Application Developer V5.0 is backward compatible. However, there are some steps you must take before having a backward-compatible .ear file.

When starting to create your application in WebSphere Studio Application Developer V5.0, you must create the .ear project and choose the proper Java™ 2 Enterprise Edition (J2EE™) version. The correct version is V1.2, not V1.3, because version 1.3 is not used in WebSphere Application Server until the V5.0 releases.

When creating your .ear file with WebSphere Studio Application Developer V5.0, the ibm-application-ext.xmi file contains fields that are not present when compared to the ibm-application-ext.xmi file that was created with WebSphere Studio Application Developer V4.0 or AAT V4.0. The message that displays is not an error but rather a warning.

The following is the warning message in full:

WarningsException ResourceImpl, file = META-INF/ibm-application-ext.xmi
[WarningsException: com.ibm.xmi.base.FeatureNotFoundException, line number = 2]
        at org.apache.xerces.framework.XMLParser.parse(XMLParser.java:1133)
        at org.xml.sax.helpers.XMLReaderAdapter.parse(XMLReaderAdapter.java:223)
       at javax.xml.parsers.SAXParser.parse(SAXParser.java:350)

        at com.ibm.xmi.base.impl.StartLoad.load(StartLoad.java:50)
        at com.ibm.xmi.base.impl.XMIFactoryImpl.load(XMIFactoryImpl.java:252)
        at com.ibm.etools.emf.resource.impl.ResourceFactoryImpl.load(ResourceFactoryImpl.java:91)
       at
com.ibm.etools.emf.resource.impl.ResourceFactoryImpl.load(ResourceFactoryImpl.java:79)
       at
com.ibm.etools.emf.resource.impl.ResourceSetImpl.load(ResourceSetImpl.java:225)

        at
com.ibm.ejs.models.base.bindings.commonbnd.AbstractTraversalHelper.getBindingOrExtensionInExistingResource(AbstractTraversalHelper.java:87)
       at
com.ibm.ejs.models.base.bindings.commonbnd.AbstractTraversalHelper.getBindingOrExtension(AbstractTraversalHelper.java:63)
       at
com.ibm.ejs.models.base.extensions.helper.CommonExtensionsHelper.getExtension(CommonExtensionsHelper.java:21)
       at
com.ibm.ejs.models.base.extensions.applicationext.ApplicationExtensionsHelper.getApplicationExtension(ApplicationExtensionsHelper.java:41)
       at
com.ibm.etools.commonarchive.impl.EARFileImpl.getExtensions(EARFileImpl.java:405)
       at
com.ibm.etools.archive.impl.LoadStrategyImpl.collectFilesFromModuleExtensions(LoadStrategyImpl.java:194)
       at
com.ibm.etools.archive.impl.LoadStrategyImpl.collectFilesFromLooseArchives(LoadStrategyImpl.java:162)
       at
com.ibm.etools.archive.impl.LoadStrategyImpl.collectFiles(LoadStrategyImpl.java:153)
       at
com.ibm.etools.commonarchive.impl.ContainerImpl.getFiles(ContainerImpl.java:193)
       at
com.ibm.etools.commonarchive.impl.ContainerImpl.getFile(ContainerImpl.java:155)
       at
com.ibm.etools.commonarchive.impl.EARFileImpl.getModuleFile(EARFileImpl.java:471)
       at
com.ibm.etools.commonarchive.impl.EARFileImpl.getDeploymentDescriptor(EARFileImpl.java:348)
       at
com.ibm.etools.commonarchive.impl.EARFileImpl.getDeploymentDescriptor(EARFileImpl.java:356)
       at
com.ibm.etools.commonarchive.impl.EARFileImpl.rollUpRoles(EARFileImpl.java:824)
       at
com.ibm.etools.commonarchive.impl.EARFileImpl.rollUpRoles(EARFileImpl.java:814)
       at
com.ibm.ejs.assembly.gui.object.EARInstance.rollUpRoles(EARInstance.java:83)
       at
com.ibm.ejs.assembly.gui.object.JarInstance.newInstance(JarInstance.java:42)
       at
com.ibm.ejs.assembly.gui.control.OpenAction$2.run(OpenAction.java:85)
       at
java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:168)
       at java.awt.EventQueue.dispatchEvent(EventQueue.java:432)
       at
java.awt.EventDispatchThread.pumpOneEventForHierarchy(EventDispatchThread.java:234)
       at
java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:141)
       at
java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:132)
       at
java.awt.EventDispatchThread.run(EventDispatchThread.java:124)

Again, this error is issued when viewing the WebSphere Studio Application Developer V5.0 .ear in the AAT or when executing the EARExpander.

The following steps show you how to get your WebSphere Studio Application Developer V5.0 file to work without warning messages:

  1. Open myNewApp.ear in the version 4.0 AAT.

    Note: The warning message is in the DOS background window.

  2. Select File > Generate Code for Deployment. This will generate without warnings or errors.

  3. Save file as: myNewAppTest.ear so you will not overwrite the original .ear file.

  4. Close the myNewApp.ear in AAT.

  5. Open the myNewAppTest.ear in AAT; no warning message displays.

  6. Deploy with EARExpander; no warning message displays.
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Software Development WebSphere Studio Application Developer General
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Deploy (for example: AAT or ANT or EAR/WAR/JAR)
Operating system(s): Windows
Software version: 4.0
Software edition:
Reference #: 1139335
IBM Group: Software Group
Modified date: Mar 27, 2006