| ====================================================== |
| Apache Axis2 ${project.version} build (${buildTimestamp}) |
| |
| http://axis.apache.org/axis2/java/core/ |
| ------------------------------------------------------ |
| |
| ___________________ |
| Building |
| =================== |
| |
| We use Maven 3 (http://maven.apache.org) to build, and you'll find a |
| pom.xml in each module, as well as at the top level. Use "mvn install" |
| (or "mvn clean install" to clean up first) to build. |
| |
| IMPORTANT: the *first* time you build a given version of Axis2, you may not |
| be able to do a regular "mvn install" from the top level - this is because |
| we have a couple of custom Maven plugins that (due to some dependency- |
| resolution issues in Maven) must be built and installed in your local |
| repository before a build will succeed. This being said, it is worth |
| trying "mvn install" none-the-less. In the case where this fails, it |
| means you need to do the following: |
| |
| 1) Manually "mvn install" both of the plugins in the following places: |
| |
| modules/tool/axis2-mar-maven-plugin |
| modules/tool/axis2-aar-maven-plugin |
| |
| ___________________ |
| Documentation |
| =================== |
| |
| Documentation can be found in the 'docs' distribution of this release |
| and in the main site. To build the documentation locally, simply do |
| "mvn site". Additionally, the Axis2 Javadoc documentation can be |
| produced by executing "mvn javadoc:javadoc". |
| Users should then look in $AXIS2_HOME/target for the documentation. |
| |
| ___________________ |
| Deploying |
| =================== |
| |
| To deploy a new Web service in Axis2 the following three steps must |
| be performed: |
| 1) Create the Web service implementation class, supporting classes |
| and the services.xml file, |
| 2) Archive the class files into a jar with the services.xml file in |
| the META-INF directory |
| 3) Drop the jar file to the $AXIS2_HOME/WEB-INF/services directory |
| where $AXIS2_HOME represents the install directory of your Axis2 |
| runtime. (In the case of a servlet container this would be the |
| "axis2" directory inside "webapps".) |
| |
| To verify the deployment please go to http://<yourip>:<port>/axis2/ and |
| follow the "Services" Link. |
| |
| For more information please refer to the User's Guide. |
| |
| ___________________ |
| Support |
| =================== |
| |
| Any problem with this release can be reported to Axis mailing list |
| or in the JIRA issue tracker. If you are sending an email to the mailing |
| list make sure to add the [Axis2] prefix to the subject. |
| |
| Mailing list subscription: |
| java-dev-subscribe@axis.apache.org |
| |
| Jira: |
| http://issues.apache.org/jira/browse/AXIS2 |
| |
| |
| Thank you for using Axis2! |
| |
| The Axis2 Team. |
