Bootstrap FreeKB - IBM WebSphere - Deployment Descriptor
IBM WebSphere - Deployment Descriptor

Updated:   |  IBM WebSphere articles

The Deployment Descriptor is an XML file that configures an app with certain settings when the app is deployed or restarted. For example, the Deployment Descriptor can configure the app with a certain context root, such as /beta.

The Deployment Descriptor XML file can be viewed in the WebSphere admin console or on the server that is running WebSphere. To view the Deployment Descriptor in the WebSphere admin console, you will navigate to Applications > All applications > your application > View Deployment Descriptor.

In this example, when Delta.ear is deployed to WebSphere, the display name of the EAR will be devWASDelta001, and the EAR contains a WAR (beta.war), where the context root of the WAR will be /beta, and a security role called Authenitcated will be created.


In this example, the Deployment Descriptor is almost identical to the application.xml file in the EAR. The only difference is that the Deployment Descriptor has one additional line - <initialize-in-order> False</initialize-in-order>.


Different files are read by WebSphere when an app is deployed or restarted based on the type of file that has been deployed.

  • EAR = application.xml
  • WAR = web.xml, portlet.xml, and ibm-web-ext.xml
  • EJB = ejb-jar.xml
  • Application Client = application-client.xml
  • Web Service = webservices.xml
  • Resource Adapter = ra.xml


Did you find this article helpful?

If so, consider buying me a coffee over at Buy Me A Coffee


Add a Comment

Please enter d33c2f in the box below so that we can be sure you are a human.