Edit deployment descriptors


A deployment descriptor is an XML file that describes how to deploy a module or application by specifying configuration and container options. When you create a module, the Assembly Toolkit creates deployment descriptor files for the module.

You can edit a deployment descriptor file manually. However, it is preferable to edit a deployment descriptor using an Assembly Toolkit deployment descriptor editor to ensure that the deployment descriptor has valid properties and that its references contain appropriate values.

Deployment descriptor editor Resources modified in the editor
Application deployment

  • application.xml
  • ibm-application-bnd.xmi
  • ibm-application-ext.xmi

Web deployment

  • WEB-INF/web.xml
  • Binding information
  • IBM binding and extensions information such as ibm-web-bnd.xmi and ibm-web-ext.xmi files

EJB deployment

  • ejb-jar.xml
  • ibm-ejb-jar-bnd.xml
  • ibm-ejb-jar-ext.xml
  • ibm-ejb-access-bean.xml

Client deployment

  • application-client.xml
  • ibm-application-client-bnd.xmi
  • ibm-application-client-ext.xmi

Web services

Web services client editor

  1. Ensure that you are working in the J2EE Perspective. Click Window > Open Perspective > J2EE.

  2. In a J2EE Hierarchy view (Window > Show View > J2EE Hierarchy), right-click the module with deployment descriptor values that you want to browse or edit, and click Open With > Deployment Descriptor Editor. A deployment descriptor editor for the module displays in a view. You can click tabs such as Overview, Module, Security, and Source at the bottom of the view to browse or edit specific deployment descriptor values. Clicking Source displays editable source code; it is preferable to edit values in fields on or accessible from the other tabs rather than edit the source code manually.

  3. Edit the deployment descriptor values as desired. For information on fields in the deployment descriptor editor, press F1 and click a topic.

  4. Save your changes to the deployment descriptor.

    1. Close the deployment descriptor editor.

    2. When prompted, click Yes to indicate that you want to save changes to the deployment descriptor.

    You also can save changes to deployment descriptors at any time by pressing Ctrl-S.


See Also

Developing Web services deployment descriptor templates for an EJB implementation
Developing Web services deployment descriptor templates for a Java bean implementation
Assembling applications with the Assembly Toolkit
web.xml file