Operating Systems: i5/OS
             Personalize the table of contents and search results

 

Viewing deployment descriptors

 

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 installed an application or module on a server and that you want to view its deployment descriptor.

 

Overview

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 administrative console.

 

Procedure

  1. Access a deployment descriptor view.

    Click the navigational option stated in Accessing a console view to view the deployment descriptor for a given module:

    Module Deployment descriptor file Accessing a console view
    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
    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 >


    Viewing Web services deployment descriptors in the administrative console describes the views.

    Resource adapter ra.xml Resource Adapters > Resource Adapters > module_name > View deployment descriptor

  2. Click Expand All to view the deployment descriptor contents.

 

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 WebSphere Application Server 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 Java Naming and Directory Interface (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


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

 

Related Reference


web.xml file