Application Assembly Tool troubleshooting tips

 

If you are having problems installing the WAS AAT, follow these steps:

  • If a problem occurs using this component, the first thing to do is to enable the printing of messages and exceptions to the screen.

    • Modify the assembly.bat file located in the bin directory of the product installation. Change the statement "start javaw" to just "java" .

    • Restart the AAT and a hanging command prompt window will appear through the lifetime of the Java process and display messages and exceptions.

    • Look up any error or warning messages you see in the message reference table.

  • With a problem application open in the AAT, use the Verify menu command. This command will go through all components of the application and validate them for any XML errors or invalid entries such as missing fields, invalid bean or class references.

  • To verify the integrity of an EAR (Enterprise Application Resource) file, expand it manually (outside of the AAT) by running the WebSphere Application Server $WAS_HOME\bin\EARExpander.bat or EARExpander.sh file and supplying the name of the EAR file as a parameter. Browse the directory structure of the expanded EAR file to see if contains all the expected files.

    Here is an example using the Windows command prompt:

    EARExpander -ear my.ear -expandDir c:\tmp\myear -operation expand

  • Contact the developer of the EAR file or its component files and ensure that they comply with J2EE specification level 1.3 and that any enterprise beans it contains conform to the EJB 2.0 Specification level.

If none of these steps solves the problem, check to see if the problem is identified and documented using the links in Diagnosing and fixing problems: Links. If you do not see a problem that resembles yours, or if the information provided does not solve your problem, contact IBM support for further assistance.

Troubleshooting installation problems

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.