Steps to get the JAXM samples working with J2EE 1.3_01

- Copy all jars from
$(JAXM_HOME)/lib to $(J2EE_HOME)/lib/system.
- Copy jaxm-runtime.jar from $(JAXM_HOME)/jaxm to $(J2EE_HOME)/lib/system.
- Extract provider.jar from jaxm-provider.war located in $(JAXM_HOME)/jaxm
- Copy provider.jar (on extraction) to $(J2EE_HOME)/lib/system.
- Copy all jars from $(JAXP_HOME) to $(J2EE_HOME)/lib/system.
- Edit $(J2EE_HOME)/bin/userconfig.sh (or userconfig.bat) to put all
the above jars in J2EE_CLASSPATH.
- Start j2ee server.
- Create a j2ee application (You can use deploytool for this).
- Add the sample war file to the application.
- Deploy it.
For all samples :
The web server that gets bundled with J2EE, runs at port 8000 unlike Tomcat, which starts at port 8080.
- The first option is to make sure that the port number is modified from 8080 to 8000
within the JAXM samples.
For samples that use the messaging provider (jaxm-remote, jaxm-soaprp), make sure that the port specified in
provider.xml (within the jaxm-provider.war) is 8000. This can be done via the provideradmin tool.
Within the provider.xml, the URL is the only place that stores the port number;
and this is alterable.
Changing the port number can easily be done by simply editing the URI-URL mapping from e.g.
"http://localhost:8080/jaxm-remote" --> "http://localhost:8000/jaxm-remote".
This change gets updated in provider.xml, and is effective immediately.
- The second option is to modify $(J2EE_HOME)/config/web.properties in order to run the server on 8080.
For the second option, you do not need to modify any of the JAXM samples.
Note: (For jaxm-remote and jaxm-soaprp samples)
- jaxm-provider app should have been deployed to run these samples.
- Make sure that the port number is 8000 instead of 8080 in client.xml, and within the code. (if using the first option).
For jaxm-translator sample and admin tool:
Modify the following policy file : $(J2EE_HOME)/lib/security/server.policy , so
that the following codebase has PropertyPermission set as follows:
grant codeBase "file:${com.sun.enterprise.home}/public_html/-"
{...
permission java.util.PropertyPermission "*", "read,write";
...}
For standalone sample:
Make sure that the port number in StandAlone.java class is 8000. (if using the first option).
Also make sure that the simple sample is deployed in J2EE.
Please read the README files to get the sample running.
For running the admin tool :
- Make sure jaxm-provider.war is deployed.
- Create a new J2EE jaxm-provideradmin application. Add
jaxm-provideradmin.war to the app.
- Using the deploytool, add a new role j2ee as an authorized role.
Remove role tomcat.
- Add user j2ee from this role as an authorized user.
- Deploy the app.
- Login to the app using the standard j2ee user and passwd j2ee/j2ee.
Please send feedback to jaxm-feedback@sun.com.