View deployment descriptors

 

+

Search Tips   |   Advanced Search

 

Overview

A deployment descriptor is an extensible markup language (XML) file that specifies configuration and container options for an application or module.

This topic assumes that you have already installed an application or module on a server.

When you create an application or module in an assembly tool, the assembly tool creates deployment descriptor files for the application or module. You can edit a deployment descriptor file manually. However, it is preferable to edit a deployment descriptor using an assembly tool deployment descriptor editor to ensure that the deployment descriptor has valid properties and that its references contain appropriate values.

After an application or module is installed on a server, you can view its deployment descriptor in the console.

 

Deployment descriptor views

• Enterprise application (application.xml)

  Applications | Enterprise Applications | application_name | View deployment descriptor

  

• Web application (WEB-INF/web.xml)

  Applications | Enterprise Applications | application_name | Manage Modules | module_name | View deployment descriptor

• Portlet application (WEB-INF/portlet.xml)

  Applications | Enterprise Applications | application_name | Manage Modules | module_name | View portlet deployment descriptor

• Enterprise bean (ejb-jar.xml)

  Applications | Enterprise Applications | application_name | Manage Modules | module_name | View deployment descriptor

• Application client (application-client.xml)

  No console view

• Web service (webservices.xml)

  Applications | Enterprise Applications | application_name | Manage Modules | module_name

  
  Views include...

  • View Web services client deployment descriptor extension
  • View Web services server deployment descriptor
  • View Web services server deployment descriptor extension

• Resource adapter (ra.xml)

  Resource Adapters | Resource Adapters | module_name | View deployment descriptor

 

Results

A deployment descriptor such as the following for the product DefaultApplication is displayed:

<application id="Application_ID" >
  <display-name> DefaultApplication.ear</display-name>
  <description> This is the IBM Default Application.</<description>
  <module id="WebModule_1" >
    <web>
      <web-uri> DefaultWebApplication.war</web-uri>
      <context-root> /</context-root>
    </web>
  </module>
  <module id="EjbModule_1" >
    <ejb> Increment.jar</ejb>
  </module>
  <security-role id="SecurityRole_1130344639273" >
    <description> All Authenticated users role.</description>
    <role-name> All Role</role-name>
  </security-role>
</application>

 

What to do next

Verify the deployment descriptor contents, including any configurations that it has for bindings, security roles, references to other resources, or JNDI names.

Change a deployment descriptor as needed in an assembly tool or using the console.

---

Application bindings
Web services security constraints
Assembly tools

 

Related tasks

Develop Web services deployment descriptor templates for an EJB implementation
Develop JAX-RPC Web services deployment descriptor templates for a JavaBeans implementation

 

Related Reference

web.xml file