Assembling applications

Assemble application modules (known as EAR files) from new or existing J2EE 1.3 modules, including these archives:

  • Webapp archives
  • Resource adapter archives
  • Enterprise beans
  • Application client archives

This packaging and configuration of code artifacts into application modules or stand-alone Web modules is necessary for deploying the applications onto the appserver.

For the Windows and Linux Intel operating systems, the Assembly Toolkit replaces the Application Assembly Tool (AAT).

To download the Assembly Toolkit, go to:

www-3.ibm.com/software/webservers/appserv/was/support/

The Assembly Toolkit consists of the J2EE Perspective of the WebSphere Studio Application Developer product without the code generation capabilities.

 

Gather the code artifacts that you want to package into one or more assembled modules. Code artifacts include these items that you have created and unit tested in your favorite integrated development environment:

 

  1. Start the Application Assembly Tool (AAT).

  2. Migrate existing J2EE 1.2 modules to J2EE 1.3.

    The Application Assembly Tool (AAT) has an option for migrating J2EE 1.2 application modules to J2EE 1.3. The J2EE 1.2 module is kept intact, with a new 1.3 module created. See also the earconvert tool documentation.

    You must migrate J2EE 1.2 application modules to which you want to add J2EE 1.3 level WAR, RAR, EJB and client modules. This tool migrates only the application modules. J2EE 1.2-level modules inside a J2EE 1.2 application module must be migrated by other means.

  3. Assemble new EJB modules (enterprise bean JAR files).

    Assemble an EJB module to contain enterprise beans and related code artifacts. Group(Web components, client code, and resource adapter code in separate modules.)

    One can install an EJB module as a stand-alone application or you can combine it with other modules into an enterprise application.

  4. Assemble new Web modules (WAR files).

    Assemble a Web module to contain servlets, JSP files, and related code artifacts. Group(enterprise beans, client code, and resource adapter code in separate modules.)

    One can install a Web module as a stand-alone application or combine it with other modules into an enterprise application.

  5. Assemble new application client modules (client JAR files).

  6. Assemble new resource adapter archives (RAR files).

    Assemble a resource adapter archive module to contain the library implementation code that your application uses to connect to enterprise information systems . Group(enterprise beans, Web components, and client code in separate modules.)

  7. Assemble an application module from other module types.

    You are ready to combine your new or migrated modules into an application module (EAR file). For applications containing only Web modules, this step is optional. It is feasible to deploy Web modules without assembling them into application modules.

  8. Verify your archive files.

    Verify your archive files and correct any problems so that generation of deployment code is successful. During verification, the Application Assembly Tool (AAT) checks that an archive file is complete, and that deployment descriptor properties and references contain appropriate values.

  9. Remember to save your application one last time.

  10. Generate code for deployment for applications containing EJB modules.

    If the application modules contain EJB modules, generate deployment code for the enterprise beans in the application before you deploy applications on the server. The Application Assembly Tool (AAT) provides this ability, or you can use the ejbdeploy command line tool.

  11. Open existing modules File(> Open) in the AAT to modify them.

    For example, you can add or remove modules and edit deployment descriptor properties.

 

What to do next

After assembling your applications, use a systems management tool to deploy the EAR or WAR files onto the appserver.

The systems management tool follows the security and deployment instructions defined in the deployment descriptor, and enables you to modify bindings specified within the AAT. The tool locates the required external resources that the application uses, such as enterprise beans and databases.

Select a tool to use:

If you are uncertain of which systems management tool to use, try using the administrative console.

Application assembly and J2EE applications
Archive support in Version 5.0
Application assembly performance checklist
Application Assembly Tool: Links

 

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.