Axis2 Installation Guide

Version 0.95

Feedback: axis-dev@ws.apache.org

Download Axis2

Axis2 is distributed in several convenient distribution packages and can be installed either as a standalone server or as part of a J2EE compliant servlet container. Axis2 is distributed under the Apache License, version 2.0. You can download Axis2 here. Latest release of Axis2 is version 0.95.

Distribution NameDescriptionItems
Minimal Distribution - BinaryThis distribution is aimed at advanced users who will be embedding Axis2. It will contain the minimal runtime required to act as a Web Service client and/or a server (axis2-core-0.95.jar will contain compiled versions of common, xml, wsdl and core modules.)
  • axis2-core-0.95.jar, axis2-adb-0.95.jar
  • third party distributable libraries
  • README.TXT and release-notes.html
Minimal Distribution - Source

This will contain the sources of Axis2 minimal distribution. One can generate a binary distribution from this by typing $maven dist-min-bin. (Set up Axis2 environment before running this command)

  • sources of Axis2 common, xml, wsdl, adb and core modules
  • README.TXT and release-notes.html
Standard Distribution - BinaryThis is the complete version of Axis2 and will contain useful samples as well. Useful for some one to get familiar with Axis2. (Since WS-Addressing implementation module is engaged in to Axis2, by default, this distribution will contain addressing.mar. But the other modules that are being developed within Axis2 will not be included here and are available to be downloaded separately from here.)
  • all the content of minimal-binary distribution
  • Contents of codegen and DOOM modules
  • Samples
  • addressing.mar
Standard Distribution - SourceThis will contain the sources of Axis2 standard distribution. One can generate a binary distribution from this by typing $maven dist-standard-bin. (Set up Axis2 environment before running this command)
  • all the content of minimal-source distribution
  • Contents of codegen and DOOM modules
  • Samples
WAR (Web Archive) DistributionThis will be the web application of Axis2 which can be deployed in most of the servlet containers.
  • all the contents of the minimal distribution
  • Admin web app
Documents DistributionThis will contain all the documentation in one package.
  • xdocs
  • javadocs
Plugin DistributionThis will contain the plugins that are created for Eclipse and IDEA.
  • Intellij IDEA plugins
  • Eclipse plugins

System Requirements

Java Runtime

Environment

1.4 (It has not been fully tested on the latest JRE 1.5)

For instructions on setting up the JRE in different operating systems, visit http://java.sun.com

Maven1.0.2 or higher in Maven 1.x series (download). Please download maven 1.x version. Axis2 is not compatible with maven2 yet.

Required only for building Axis2 from source distribution

MemoryNo minimum requirement
DiskNo minimum requirement.

Approximately 20 MB will be used for war distribution

Operating systemTested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu, Gentoo

All the required jars are shipped with the binary distribution.

Running the Maven build will automatically download the required jars when using source distribution.

Setting up the Environment and Tools

Maven

The Axis2 build is based on

Maven . Hence the only prerequisite to build Axis2 from source distribution is to have Maven installed. Extensive instruction guides are available at the Maven site.This guide however contains the easiest path for quick environment setting. Advanced users who wish to know more about Maven can visit here .

  • Windows
  1. Download and run the Windows installer package
  2. Set the 'Environment Variables' ( create system variable MAVEN_HOME and edit path. eg: "C:\Program Files\Apache Software Foundation\maven-1.0.2"; path %MAVEN_HOME%\bin)
  3. Make sure that system variable JAVA_HOME is set to the location of your JDK, eg. C:\Program Files\Java\jdk1.5.0_02
  4. Run maven --version to verify that it is correctly installed.

clip_image002 (15K)

  • Unix based OS (Linux etc)

The tar ball or the zip archive is the best option. Once the archive is downloaded expand it to a directory of choice and set the environment variable MAVEN_HOME and add MAVEN_HOME/bin to the path as well. More instructions for installing Maven in Unix based operating systems can be found here .

Once maven is properly installed you can start building Axis2.

The Axis2 source distribution

The source distribution is available as a zipped archive. All the necessary build scripts are included with the source distribution. Once the source archive is expanded into a directory of choice, moving to the particular directory and running maven command will build the Axis2 jar file.

clip_image004 (43K)

Once the command completes, the binaries (jar files in this case) can be found at a newly created "target" directory.

Note: For the first Maven build (if the maven repository is not built first) it will take a while since required jars need to be downloaded. However this is a once only process and will not affect any successive builds.

The default maven build will however build only the Axis2 jar file. To obtain a WAR (Web Archive), "maven war" command should be issued. This will create a complete WAR with the name axis2.war inside the target directory.

Once this build step is complete, the binaries are ready to be deployed.

Installing Axis2 in a Servlet container

  1. Download Axis2 war file
  2. Drop the war in the webapps folder. Most servlet containers will automatically install war. (some servlet containers may require a restart in order to capture the new web application. Refer your servlet container documentation for more information about this.)
  3. Once the WAR is successfully installed, test it by pointing the web browser to the http:// <host :port>/ axis2. It should produce the following page which is the Axis2 Web Application Home Page.
  4. Use validate link to ensure that everything is fine and smooth. If the validation fails then the war has failed to install properly or some essential jars are missing. At such a situation the documentation of the particular servlet container should be consulted to find the problem. The following page is a successful validation. Note the statement core Axis2 libraries are present.

Uploading services

    The Axis2 web application also provides an interface to upload services. Once a service is created according to the service specification as described in userguide that jar file can be uploaded using the upload page.

    The uploaded jar files will be stored in the default service directory. For Axis2 this will be the <webapps>/axis2/WEB-INF/services directory. Once a service is uploaded it will be installed instantly.

    Since Axis2 supports hot deployment one can drop the service jar directly through the file system to the above mentioned services directory.It will also cause the service to be automatically installed without the container being restarted.

    Use the 'Services' link on the Web Application home page to check the successful installation of a service. The services and the operations of successfully installed services will be displayed in the available services page.

    If the service has deployment time error it will list those services as faulty services. If you click on the link you can see the your deployment fault error message(s).

    Deployment time error message

    Axis2 Administration is all about configuring Axis2 at the run time and the configuration will be transient. More descriptions are available in Axis2 Web Administration Guide