![]() |
JAXM Messaging Provider Sample Application |
JAXM Messaging Provider Sample Application
This document describes how to utilize the JAXM Messaging Provider Sample application in conjunction with the Sun Java (tm) System Application Server version 7.This application document contains the following sections:
Overview
A messaging provider is a service that handles the transmission and routing of messages. It works behind the scenes to keep track of messages and see that they are sent to the proper destination or destinations. The JAXM tutorial gives more information about messaging providers in the section Messaging Providers.
IMPORTANT: It must be emphasized that the Messaging Provider Sample application is provided for sample purposes only. It is not production quality and not supported in any way. These were originally part of the Java Web Services Developer Pack and provided here as a convenience.
For more information on JAXM, go to http://java.sun.com/xml/jaxm/index.html.
Deploying the Sample Application
To deploy the application, do the following:The Sun Java (tm) System Application Server requires the proper runtime libraries for this messaging provider (as well as the JAXM samples that communicate with messaging providers) to operate correctly. The runtime libraries are located at <install-root>/samples/webservices/jaxm/lib/jaxm-sampleproviderruntime.jar.
Add the jaxm-sampleproviderruntime.jar library to the server classpath via the application server Admininistration Tool.
- Login into the Administration Tool via http://<host>:<admin port>/admin
- On the left menu pane, navigate App Server Instances -> server1. Click on "server1".
- Click on "JVM Settings" tab.
- Click on "Path Settings" link.
- Append the jaxm-sampleproviderruntime.jar libary path to the Classpath Suffix text area. For instance, if the path is /usr/lib/jaxm-sampleproviderruntime.jar, append this on a separate
- Click the "server1" menu in the left menu pane.
- Click "Apply Changes". Click "Restart" to restart your server instance.
Execute the command asant deploy under <install_root>/samples/webservices/jaxm/jaxm-provider/src
This will deploy the jaxm-provider.war file located under <install_root>/samples/webservices/jaxm/jaxm-provider/
Note You must run asant undeploy before redeploying this sample. This will ensure that all modules are undeployed and the resources are disabled.
Verifying Deployment
As an optional step, you can use the Sun Java (tm) System Application Server Administration Tool to verify that the application has been registered.To verify the registration of the application, do the following:
Execute the command asadmin list-components to look at applications deployed with a server instance. For example:
<install_root>/bin/asadmin list-components -u <username> -w <password> -H <host> -p <port> <server instance name>
You will see jaxm-provider listed.
- If you encounter problems when running the application, review the log files at <install-root>/domains/domain1/<server-instance>/logs/server.log to learn what exactly went wrong.
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.
Last Updated July 12, 2002