Deploy web services applications onto application servers
Overview
After assembling the artifacts required to enable the web module for web services into an EAR file, we can deploy the EAR file into the application server.
For JAX-WS web services, using webservices.xml is optional. We can use annotations to specify all of the information contained within the deployment descriptor file. We can use the deployment descriptor file to augment or override existing JAX-WS annotations. Information defined in webservices.xml overrides any corresponding information specified by annotations.
To install or deploy a JAX-WS application, we only need to install the JAX-WS enabled EAR file. If the web services application contains only JAX-WS endpoints, we do not need to run wsdeploy, which is used to process JAX-RPC endpoints.
Install the HTTP or JMS router module generated with the endptEnabler command onto the same target as the web services enterprise bean JAR files. These HTTP or JMS router modules are included in the web services application, and they need to use the runtime libraries of the application server.
Deploy web services applications
To install an application containing web services using the console, select...
Install New Application | Deploy WebServices
If the JAX-RPC web services application was previously deployed with wsdeploy, it is not necessary to specify web services deployment during installation.
To deploy the EAR file using wsadmin...
JAX-WS ./wsadmin.sh $AdminApp install EARfile "-usedefaultbindings" JAX-RPC $AdminApp install EARfile "-usedefaultbindings -deployws"
Confirm the web services application was deployed by entering the web service endpoint URL in a browser, then viewing an informative page...
{http://webservice.pli.tc.wssvt.ibm.com}RetireWebServices Hello! This is an Axis2 web service!
The first line of this information is variable, depending on the web service. The URI in the brackets is the namespace and the string that follows, in this example RetireWebServices, is the name of the port used to access the web service.
Optional: Apply security to the web service.
Results
You have a web service installed onto the application server.
While installing if you receive out of memory errors, increase the JVM heap size for application and dmgr servers.
Subtopics
- Provide options to perform the web services deployment settings
- wsdeploy command
- JAX-WS application deployment model
Related concepts
Overview of standards and programming models for web services message-level securitySecure web services Related tasks
Making deployed web services applications available to clientsDevelop a webservices.xml deployment descriptor for JAX-WS applications Develop JAX-RPC web services deployment descriptor templates for a JavaBeans implementation Secure web services Task overview: Implement web services applications Tune the IBM virtual machine for Java Install enterprise application files with the console