Return-Path: Delivered-To: apmail-ws-axis-cvs-archive@www.apache.org Received: (qmail 57555 invoked from network); 19 Jan 2006 08:17:42 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 19 Jan 2006 08:17:42 -0000 Received: (qmail 7319 invoked by uid 500); 19 Jan 2006 08:17:40 -0000 Delivered-To: apmail-ws-axis-cvs-archive@ws.apache.org Received: (qmail 7257 invoked by uid 500); 19 Jan 2006 08:17:40 -0000 Mailing-List: contact axis-cvs-help@ws.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list axis-cvs@ws.apache.org Received: (qmail 7244 invoked by uid 500); 19 Jan 2006 08:17:39 -0000 Delivered-To: apmail-ws-axis2-cvs@ws.apache.org Received: (qmail 7241 invoked by uid 99); 19 Jan 2006 08:17:39 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 19 Jan 2006 00:17:39 -0800 X-ASF-Spam-Status: No, hits=-9.4 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.29) with SMTP; Thu, 19 Jan 2006 00:17:37 -0800 Received: (qmail 57355 invoked by uid 65534); 19 Jan 2006 08:17:17 -0000 Message-ID: <20060119081717.57353.qmail@minotaur.apache.org> Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r370415 [2/2] - in /webservices/axis2/trunk/java/xdocs/0_94: Axis2ArchitectureGuide.html installationguide.html Date: Thu, 19 Jan 2006 08:17:16 -0000 To: axis2-cvs@ws.apache.org From: chinthaka@apache.org X-Mailer: svnmailer-1.0.5 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Modified: webservices/axis2/trunk/java/xdocs/0_94/installationguide.html URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/0_94/installationguide.html?rev=370415&r1=370414&r2=370415&view=diff ============================================================================== --- webservices/axis2/trunk/java/xdocs/0_94/installationguide.html (original) +++ webservices/axis2/trunk/java/xdocs/0_94/installationguide.html Thu Jan 19 00:17:07 2006 @@ -1,5 +1,3 @@ -<<<<<<< .mine - @@ -7,14 +5,21 @@ + +

Axis2 Installation Guide

@@ -42,85 +47,113 @@ - -

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.94.

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.94.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Distribution Name	Description	Items
Minimal Distribution - Binary	This 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.94.jar will contain compiled versions of common, xml, wsdl and core modules.)	- axis2-core-0.94.jar, axis2-adb-0.94.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 - Binary	This 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 - Source	This 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) Distribution	This 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 Distribution	This will contain all the documentation in one package.	- xdocs - javadocs -
Plugin Distribution	This will contain the plugins that are created for Eclipse and IDEA.	- Intellij IDEA plugins - Eclipse plugins -
Distribution Name	Description	Items
Minimal Distribution - Binary	This 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.94.jar will contain + compiled versions of common, xml, wsdl and core modules.)	+ axis2-core-0.94.jar, axis2-adb-0.94.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 - Binary	This 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 - Source	This 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) Distribution	This 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 Distribution	This will contain all the documentation in one package.	+ xdocs + javadocs + +
Plugin Distribution	This will contain the plugins that are created for Eclipse and + IDEA.	+ Intellij IDEA plugins + Eclipse plugins + +

- -

System Requirements

+ +

System Requirements

@@ -139,7 +172,10 @@ - @@ -169,35 +205,35 @@

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 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
Windows

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

clip_image002 (15K)

- -

Unix based OS (Linux etc)

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 @@ -205,17 +241,16 @@ 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.

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)

@@ -236,8 +271,7 @@

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

- -

Installing Axis2 in a Servlet container

Download Axis2 war file
Drop the war in the webapps folder. Most servlet containers will @@ -248,7 +282,8 @@ browser to the http:// <host :port>/ axis2. It should produce the following page.

Use validate link to ensure that everything is fine and smooth. If the @@ -260,12 +295,13 @@

+ -

Uploading services

The Axis2 web application also provides an interface to upload services. @@ -273,8 +309,8 @@ 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 @@ -289,22 +325,20 @@ 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 +

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 Installation Guide @@ -361,80 +399,110 @@

Download Axis2


Maven	1.0.2 or higher (download) +	1.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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Distribution Name	Description	Items
Minimal Distribution - Binary	This 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.94.jar will contain compiled versions of common, xml, wsdl and core modules.)	- axis2-core-0.94.jar, axis2-adb-0.94.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 - Binary	This 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 - Source	This 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) Distribution	This 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 Distribution	This will contain all the documentation in one package.	- xdocs - javadocs -
Plugin Distribution	This will contain the plugins that are created for Eclipse and IDEA.	- Intellij IDEA plugins - Eclipse plugins -
Distribution Name	Description	Items
Minimal Distribution - Binary	This 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.94.jar will contain + compiled versions of common, xml, wsdl and core modules.)	+ axis2-core-0.94.jar, axis2-adb-0.94.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 - Binary	This 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 - Source	This 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) Distribution	This 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 Distribution	This will contain all the documentation in one package.	+ xdocs + javadocs + +
Plugin Distribution	This will contain the plugins that are created for Eclipse and + IDEA.	+ Intellij IDEA plugins + Eclipse plugins + +

System Requirements

@@ -488,14 +556,16 @@

Maven

Windows
Windows

Download and run the Windows installer package
Set the 'Environment Variables' ( create system variable MAVEN_HOME and @@ -506,11 +576,11 @@
Run maven --version to verify that it is correctly installed.

clip_image002 (15K)

- -

Unix based OS (Linux etc)

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 @@ -518,16 +588,15 @@ 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)

@@ -599,24 +668,22 @@ 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 +

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 ->>>>>>> .r370149 + +