axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chinth...@apache.org
Subject svn commit: r470700 - /webservices/axis2/branches/java/1_1/xdocs/1_1/installationguide.html
Date Fri, 03 Nov 2006 07:33:06 GMT
Author: chinthaka
Date: Thu Nov  2 23:33:06 2006
New Revision: 470700

URL: http://svn.apache.org/viewvc?view=rev&rev=470700
Log:
more improvements to the document.


Modified:
    webservices/axis2/branches/java/1_1/xdocs/1_1/installationguide.html

Modified: webservices/axis2/branches/java/1_1/xdocs/1_1/installationguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/xdocs/1_1/installationguide.html?view=diff&rev=470700&r1=470699&r2=470700
==============================================================================
--- webservices/axis2/branches/java/1_1/xdocs/1_1/installationguide.html (original)
+++ webservices/axis2/branches/java/1_1/xdocs/1_1/installationguide.html Thu Nov  2 23:33:06
2006
@@ -1,367 +1,269 @@
 <html>
 <head>
-  <meta http-equiv="content-type" content="">
-  <title>Axis2 Installation Guide</title>
-  <style type="text/css">
-  </style>
+    <meta http-equiv="content-type" content="">
+    <title>Axis2 Installation Guide</title>
+    <style type="text/css">
+    </style>
 </head>
 
 <body lang="en">
 <h1 align="center">Apache Axis2 Installation Guide</h1>
 
 <p>This document will give you information on Axis2 distribution packages,
-system prerequisites &amp; setting up environment variables and tools
-followed by detailed instructions on installation methods.</p>
+    system prerequisites &amp; setting up environment variables and tools
+    followed by detailed instructions on installation methods.</p>
 
 <p><i>Send your feedback to: <a
-href="mailto:axis-dev@ws.apache.org">axis-dev@ws.apache.org</a></i>. Prefix
-subject with [Axis2]. To subscribe to mailing list see <a
-href="http://ws.apache.org/axis2/mail-lists.html">here.</a></p>
+        href="mailto:axis-dev@ws.apache.org">axis-dev@ws.apache.org</a></i>.
Prefix
+    subject with [Axis2]. To subscribe to mailing list see <a
+        href="http://ws.apache.org/axis2/mail-lists.html">here.</a></p>
 
 <h2>Contents</h2>
 <ul>
-  <li><a href="#Download_Axis2">Download Axis2</a></li>
-  <li><a href="#requirements">System Requirements</a></li>
-  <li><a href="#standalone">Standalone Insatallation Using Standard Binary Distribution</a></li>
-  <li><a href="#build_war">Building WAR File Using Standard Binary Distribution</a></li>
-  <li><a href="#servlet_container">Installing Axis2 in a Servlet
-  Container</a></li>
-  <li><a href="#upload">Uploading Services</a></li>
-  <li><a href="#advanced">Advanced</a>
-    <ul>
-      <li><a href="#source">Axis2 Source Distribution</a>
+    <li><a href="#Download_Axis2">Download Axis2</a></li>
+    <li><a href="#requirements">System Requirements</a></li>
+    <li><a href="#standalone">Standalone Insatallation Using Standard Binary
Distribution</a></li>
+    <li><a href="#build_war">Building WAR File Using Standard Binary Distribution</a></li>
+    <li><a href="#servlet_container">Installing Axis2 in a Servlet
+        Container</a></li>
+    <li><a href="#upload">Uploading Services</a></li>
+    <li><a href="#advanced">Advanced</a>
         <ul>
-          <li><a href="#_Toc96698083">Setting up the Environment and
-          Tools</a></li>
-          <li><a href="#_Toc96698085">Building Axis2 Binaries and WAR file
-            Using the Source Distribution</a></li>
+            <li><a href="#source">Axis2 Source Distribution</a>
+                <ul>
+                    <li><a href="#_Toc96698083">Setting up the Environment and
+                        Tools</a></li>
+                    <li><a href="#_Toc96698085">Building Axis2 Binaries and WAR
file
+                        Using the Source Distribution</a></li>
+                </ul>
+            </li>
         </ul>
-      </li>
-    </ul>
-  </li>
+    </li>
 </ul>
 <a name="Download_Axis2"></a>
 
 <h2>Download Axis2</h2>
 
 <p>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. This Installation Guide will mainly focus on running Apache Axis2 using
-the Standard Binary Distribution.</p>
-
-<p><a href="http://ws.apache.org/axis2/download.cgi">Download</a> distribution
packages
-of the latest release -Axis2 is <a href="../index.html">version 1.1</a>.
-Distribution packages of all versions are available for <a
-href="http://ws.apache.org/axis2/download.cgi">download.</a></p>
+    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. This Installation Guide will mainly focus on running Apache Axis2 using
+    the Standard Binary Distribution.</p>
+
+<p><a href="http://ws.apache.org/axis2/download/1_1/download.cgi">Download</a>
distribution packages
+    of the latest Axis2 release - <a href="../index.html">version 1.1</a>.
+    Distribution packages of all versions are available for <a
+        href="http://ws.apache.org/axis2/download.cgi">download.</a></p>
 
 <p>The Distribution Packages Provided are as follows:</p>
 
 <h3><a name="std-bin" id="std-bin"></a>1. Standard Binary Distribution</h3>
 
-<p>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 <a
-href="../modules/index.html">downloaded</a> separately.</p>
+<p>This is the complete version of Axis2 and include samples and convenient scripts
as
+    well. 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 <a href="../modules/index.html">downloaded</a>
separately.
+</p>
 
-<p><a href="../download/1_1/download.html#std-bin">Download</a> Standard
-Binary Distribution</p>
+<p><a href="http://ws.apache.org/axis2/download/1_1/download.cgi">Download</a>
Standard
+    Binary Distribution</p>
 <a name="war1"></a>
 
 <h3>2. WAR (Web Archive) Distribution</h3>
 
 <p>This will be the Web application of Axis2 which can be deployed in most of
-the servlet containers.</p>
+    the servlet containers.</p>
 
-<p><a href="../download/1_1/download.html#war">Download</a> WAR (Web Archive)
-Distribution</p>
+<p><a href="http://ws.apache.org/axis2/download/1_1/download.cgi">Download</a>
WAR (Web Archive)
+    Distribution</p>
 
 <h3>3. Documents Distribution</h3>
 
 <p>This will contain all the documentation in one package. The package
-includes the xdocs and the Java API docs of this project.</p>
+    includes the xdocs and the Java API docs of this project.</p>
 
-<p><a href="../download/1_1/download.html#docs">Download</a> Documents
-Distribution</p>
+<p><a href="http://ws.apache.org/axis2/download/1_1/download.cgi">Download</a>
Documents
+    Distribution</p>
 
 <h3>4. Source Distribution</h3>
 
 <p>This will contain the sources of Axis2 standard distribution, and is
-mainly for the benefit of the advance users. One can generate a binary
-distribution using the source by typing <span class="style1">$maven
+    mainly for the benefit of the advance users. One can generate a binary
+    distribution using the source by typing <span class="style1">$maven
 dist-standard-bin. </span> You need to set up the Axis2 environment before
-running this command. Step by step details on how to create the binary
-distribution is available in the <a href="#advanced">Advanced</a> section.</p>
-
-<p><a href="../download/1_1/download.html#src">Download</a> Source
-Distribution</p>
+    running this command. Step by step details on how to create the binary
+    distribution is available in the <a href="#advanced">Advanced</a> section.</p>
 
-<!--<h3>5. Minimal Binary Distribution</h3>
+<p><a href="http://ws.apache.org/axis2/download/1_1/download.cgi">Download</a>
Source
+    Distribution</p>
 
-<p>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-kernel-1.1.jar will contain compiled versions of
-common and core modules.)</p>
-
-<p><a href="../download/1_1/download.html#min">Download</a> Minimal Binary
-Distribution</p>-->
-<!--<table width="940" border="1" cellpadding="1">
-<tbody>
-<tr>
-<th width="83" scope="col">Distribution Name</th>
-<th width="633" scope="col">Description</th>
-<th width="202" scope="col">Items</th>
-</tr>
-<tr>
-<td><strong>Minimal Distribution - Binary</strong></td>
-<td>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-kernel-1.1.jar will contain
-compiled versions of common and core modules.)</td>
-<td><ul>
-<li>axis2-kernel-1.1.jar, axis2-adb-1.1.jar</li>
-<li>third party distributable libraries</li>
-<li>README.TXT and release-notes.html</li>
-</ul>
-</td>
-</tr>
-<tr>
-<td><strong>Minimal Distribution - Source</strong></td>
-<td background="#_Toc96698083"><p>This will contain the sources of
-Axis2 minimal distribution. One can generate a binary distribution
-from this by typing  <span class="style1">$maven dist-min-bin.
-</span>(<a href="#_Toc96698083">Set up Axis2 environment</a> before
-running this command)</p>
-</td>
-<td><ul>
-<li>sources of Axis2 common, java2wsdl , adb and core modules</li>
-<li>README.TXT and release-notes.html</li>
-</ul>
-</td>
-</tr>
-<tr>
-<td><strong>Standard Distribution - Binary</strong></td>
-<td>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 <a
-href="http://ws.apache.org/axis2/modules/index.html">here</a>.)</td>
-<td><ul>
-<li>all the content of minimal-binary distribution</li>
-<li>Contents of codegen and doom modules</li>
-<li>Samples</li>
-<li>addressing-1.1.mar</li>
-</ul>
-</td>
-</tr>
-<tr>
-<td><strong>Standard Distribution - Source</strong></td>
-<td>This will contain the sources of Axis2 standard distribution. One
-can generate a binary distribution from this by typing <span
-class="style1">$maven dist-standard-bin. </span>(<a
-href="#_Toc96698083">Set up Axis2 environment</a> before running this
-command)</td>
-<td><ul>
-<li>all the content of minimal-source distribution</li>
-<li>Contents of codegen and doom modules</li>
-<li>Samples</li>
-</ul>
-</td>
-</tr>
-<tr>
-<td><strong>WAR (Web Archive) Distribution</strong></td>
-<td>This will be the web application of Axis2 which can be deployed in
-most of the servlet containers.</td>
-<td><ul>
-<li>all the contents of the minimal distribution</li>
-<li>Admin Web Application</li>
-</ul>
-</td>
-</tr>
-<tr>
-<td><strong>Documents Distribution</strong></td>
-<td>This will contain all the documentation in one package.</td>
-<td><ul>
-<li>xdocs</li>
-<li>javadocs</li>
-</ul>
-</td>
-</tr>
-<tr>
-<td><a name="Plugin" id="Plugin">Plugin Distribution</a></td>
-<td>This will contain the plugins that are created for Eclipse and
-IDEA.</td>
-<td><ul>
-<li>IntelliJ IDEA plugins</li>
-<li>Eclipse plugins</li>
-</ul>
-</td>
-</tr>
-</tbody>
-</table>-->
 <a name="requirements"></a>
 
 <h2>System Requirements</h2>
 
 <table border="2">
-  <caption></caption>
-  <tbody>
-    <tr>
-      <td>Java Runtime
-
-        <p>Environment</p>
-      </td>
-      <td>1.4 or 1.5 (For instructions on setting up the JRE in different
-        operating systems, visit <a
-        href="http://java.sun.com/">http://java.sun.com</a>)</td>
-    </tr>
-    <tr>
-      <td><strong>Build Tool</strong>- <a href="http://maven.apache.org/maven-1.x/">Apache
Maven</a>
-
-        <p><em>Required only for building Axis2 from Source
-        Distribution</em></p>
-      </td>
-      <td>1.0.2 or higher in Maven 1.x series (<a
-        href="http://maven.apache.org/maven-1.x/start/download.html">download</a>).
-        <strong>Please download maven 1.x version. Axis2 is not compatible
-        with maven2 yet.</strong></td>
-    </tr>
-    <tr>
-      <td><strong>Build Tool</strong>- <a href="http://ant.apache.org/">Apache
Ant</a></td>
-      <td>Version 1.6.5 (<a
-        href="http://ant.apache.org/bindownload.cgi">download</a>).</td>
-    </tr>
-    <tr>
-      <td>Memory</td>
-      <td>No minimum requirement</td>
-    </tr>
-    <tr>
-      <td>Disk</td>
-      <td>No minimum requirement.
-
-        <p>Approximately 7 MB will be used for war distribution</p>
-      </td>
-    </tr>
-    <tr>
-      <td>Operating system</td>
-      <td>Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu,
-      Gentoo</td>
-    </tr>
-  </tbody>
+    <caption></caption>
+    <tbody>
+        <tr>
+            <td>Java Runtime
+                <p>Environment</p>
+            </td>
+            <td>1.4 or 1.5 (For instructions on setting up the JRE in different operating
systems,
+                visit
+                <a href="http://java.sun.com/">http://java.sun.com</a>)</td>
+        </tr>
+        <tr>
+            <td><strong>Build Tool</strong>- <a href="http://maven.apache.org/maven-1.x/">Apache
+                Maven</a>
+
+                <p><em>Required only for building Axis2 from Source
+                    Distribution</em></p>
+            </td>
+            <td>1.0.2 or higher in Maven 1.x series (<a
+                    href="http://maven.apache.org/maven-1.x/start/download.html">download</a>).
+                <strong>Please download maven 1.x version. Axis2 is not compatible
+                    with maven2 yet.</strong></td>
+        </tr>
+        <tr>
+            <td><strong>Build Tool</strong>- <a href="http://ant.apache.org/">Apache
Ant</a></td>
+            <td>Version 1.6.5 (<a
+                    href="http://ant.apache.org/bindownload.cgi">download</a>).</td>
+        </tr>
+        <tr>
+            <td>Memory</td>
+            <td>No minimum requirement</td>
+        </tr>
+        <tr>
+            <td>Disk</td>
+            <td>No minimum requirement.
+
+                <p>Approximately 11 MB will be used for war distribution</p>
+            </td>
+        </tr>
+        <tr>
+            <td>Operating system</td>
+            <td>Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu,
+                Gentoo</td>
+        </tr>
+    </tbody>
 </table>
 <a name="standalone"></a>
+
 <h2>Standalone Insatallation Using Standard Binary Distribution</h2>
 
 <p>All the required jars are shipped with the standard binary
-distribution.</p>
+    distribution.</p>
 
 <p>Installing Axis2 is merely a matter of <a
-href="../download/1_1/download.html#std-bin">downloading</a> and extracting
-the Standard Binary Distribution and setting the system variable JAVA_HOME to the location
of your JDK, eg. C:\Program Files\Java\jdk1.5.0_02Java home.</p>
+        href="http://ws.apache.org/axis2/download/1_1/download.cgi">downloading</a>
and extracting
+    the Standard Binary Distribution and setting the system variables JAVA_HOME and AXIS2_HOME.
+    Point JAVA_HOME to the location of
+    your JDK, eg. C:\Program Files\Java\jdk1.5.0_02 and AXIS2_HOME to the extracted folder
of the
+    release.</p>
 <a name="build_war"></a>
-<h2>Building the WAR File  Using Standard Binary Distribution</h2>
+
+<h2>Building the WAR File Using Standard Binary Distribution</h2>
 
 <p>The following examples will run you through on how to build the axis2.war
-file which is required to install Apache Axis2 in a J2EE compliant servlet
-container.</p>
+    file which is required to install Apache Axis2 in a J2EE compliant servlet
+    container.</p>
 <ol>
-  <li><a href="../download/1_1/download.html#std-bin">Download</a> Standard
-    Binary Distribution and extract it to your machine</li>
-  <li>Locate to the following directory in your AXIS home -- /webapps (i.e:-
-    AXIS_HOME/webapps)</li>
-  <li>There is a build.xml file, which can be used to build axis2.war</li>
-  <li>Run the following ant target inorder to build axis2.war using <code>ant
-    create.war</code></li>
-  <li>You can find the generated axis2.war inside dist directory
-    (AXIS_HOME/dist)</li>
+    <li><a href="http://ws.apache.org/axis2/download/1_1/download.cgi">Download</a>
Standard
+        Binary Distribution and extract it to your box.</li>
+    <li>Locate to the following directory in your AXIS2 home -- /webapps (i.e:-
+        AXIS2_HOME/webapps)</li>
+    <li>There is a build.xml file, which can be used to build axis2.war</li>
+    <li>Run the following ant target inorder to build axis2.war using <code>ant
+        create.war</code></li>
+    <li>You can find the generated axis2.war inside dist directory
+        (AXIS2_HOME/dist)</li>
 </ol>
 <a name="servlet_container"></a>
+
 <h2>Installing Axis2 in a Servlet Container</h2>
 
 <p>Which ever the distribution, installing Axis2 in a J2EE compliant servlet
-container is as follows:</p>
+    container is as follows:</p>
 <ol>
-  <li><a href="../download/1_1/download.html#war">Download</a> Axis2 WAR
-    file. (This guide also gives you instructions on how to build axis2.war
-    using either the <a href="#build_war">Standard Binary Distribution</a> or
<a href="#war">Source
-    Distribution</a>.</li>
-  <li>Drop the war in the webapps folder of the servlet container. 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.)</li>
-  <li>Once the WAR is successfully installed, test it by pointing the web
-    browser to the <strong>http://&lt;host :port&gt;/axis2. </strong>It
-    should produce the following page which is the <strong>Axis2 Web
-    Application Home Page</strong>.</li>
-
-  <p align="center"><strong><img src="images/clip_image006.jpg"
-  alt=""></strong></p>
-  <li>Use the link "Validate" 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.</li>
+    <li><a href="http://ws.apache.org/axis2/download/1_1/download.cgi">Download</a>
Axis2 WAR
+        file. (This guide also gives you instructions on how to build axis2.war
+        using either the <a href="#build_war">Standard Binary Distribution</a>
or <a href="#war">Source
+        Distribution</a>.</li>
+    <li>Drop the war in the webapps folder of the servlet container. 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.)</li>
+    <li>Once the WAR is successfully installed, test it by pointing the web
+        browser to the <strong>http://&lt;host :port&gt;/axis2. </strong>It
+        should produce the following page which is the <strong>Axis2 Web
+        Application Home Page</strong>.</li>
+
+    <p align="center"><strong><img src="images/clip_image006.jpg"
+                                   alt=""></strong></p>
+    <li>Use the link "Validate" 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.</li>
 </ol>
 
 <p align="center"><img src="images/happyaxis.jpg"></p>
 <a name="upload"></a>
 
 <p><strong>Note:</strong> For any Application server specific installation
-information please refer <a href="app_server.html">Application Server
-Specific Configuration Guide</a>.</p>
+    information please refer <a href="app_server.html">Application Server
+    Specific Configuration Guide</a>.</p>
 
 <h2>Uploading Services</h2>
 <ol>
-  <p>The Axis2 Web application also provides an interface to upload services.
-  Once a service is created according to the service specification as
-  described in <a name="userguide.html" target="_blank">User's Guide that jar
-  file can be uploaded using the upload page.</a></p>
+    <p>The Axis2 Web application also provides an interface to upload services.
+        Once a service is created according to the service specification as
+        described in <a name="userguide.html" target="_blank">User's Guide that jar
+        file can be uploaded using the upload page.</a></p>
 
-  <p align="center"><strong><img src="images/clip_image010.jpg"
-  alt=""></strong></p>
+    <p align="center"><strong><img src="images/clip_image010.jpg"
+                                   alt=""></strong></p>
 
-  <p>The uploaded jar files will be stored in the default service directory.
-  For Axis2 this will be the &lt;webapps&gt;/axis2/WEB-INF/services
-  directory. Once a service is uploaded it will be installed instantly.</p>
-  <a name="hot_deployment"></a>
+    <p>The uploaded jar files will be stored in the default service directory.
+        For Axis2 this will be the &lt;webapps&gt;/axis2/WEB-INF/services
+        directory. Once a service is uploaded it will be installed instantly.</p>
+    <a name="hot_deployment"></a>
 
-  <p>Since Axis2 supports <strong>hot deployment</strong> 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.</p>
+    <p>Since Axis2 supports <strong>hot deployment</strong> 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.</p>
 
-  <p>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.</p>
+    <p>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.</p>
 
-  <p align="center"><img src="images/clip_image012.jpg" alt=""></p>
+    <p align="center"><img src="images/clip_image012.jpg" alt=""></p>
 
-  <p></p>
+    <p></p>
 
-  <p>If the service has deployment time errors it will list those services as
-  faulty services. If you click on the link you can see the deployment fault
-  error message(s).</p>
+    <p>If the service has deployment time errors it will list those services as
+        faulty services. If you click on the link you can see the deployment fault
+        error message(s).</p>
 
-  <p align="center"><img src="images/faultservice.jpg" alt=""></p>
+    <p align="center"><img src="images/faultservice.jpg" alt=""></p>
 
-  <p>Deployment time error message</p>
+    <p>Deployment time error message</p>
 
-  <p align="center"><strong><img src="images/faultmsg.jpg"
-  alt=""></strong></p>
+    <p align="center"><strong><img src="images/faultmsg.jpg"
+                                   alt=""></strong></p>
 
-  <p></p>
+    <p></p>
 
-  <p>Axis2 Administration is all about configuring Axis2 at the run time and
-  the configuration will be transient. More descriptions are available in <a
-  href="webadminguide.html" target="_blank">Axis2 Web Administration
-  Guide</a></p>
+    <p>Axis2 Administration is all about configuring Axis2 at the run time and
+        the configuration will be transient. More descriptions are available in <a
+            href="webadminguide.html" target="_blank">Axis2 Web Administration
+        Guide</a></p>
 </ol>
 <a name="advanced"></a>
 
@@ -370,14 +272,15 @@
 
 <h2>Axis2 Source Distribution</h2>
 <a name="_Toc96698083">Using the Source Distribution both brinary files
-(which is downloadable as the </a><a href="#std-bin">Standard Binary
-Ditribution</a>) and axis2.war file (which is downloadable as the <a
-href="#war1">WAR distribution</a>) can be built using maven commands.
+    (which is downloadable as the </a><a href="#std-bin">Standard Binary
+    Ditribution</a>) and axis2.war file (which is downloadable as the <a
+        href="#war1">WAR distribution</a>) can be built using maven commands.
 
 <p>Required jar files do not come with the distribution and they will also
-have to be built by running the maven command. Before we go any further it is
-necessary to install <a href="http://maven.apache.org/maven-1.x/"
-target="_blank">Maven</aandsettheEnvironment.Thenextsectionwillguideyouhowtodojustthat.></a></p>
+    have to be built by running the maven command. Before we go any further it is
+    necessary to install <a href="http://maven.apache.org/maven-1.x/"
+                            target="_blank">Maven</aandsettheEnvironment.Thenextsectionwillguideyouhowtodojustthat.>
+</a></p>
 
 <h3>Setting Up the Environment and Tools</h3>
 <a name="maven"></a>
@@ -385,71 +288,72 @@
 <h4>Maven</h4>
 
 <p>The Axis2 build is based on <a href="http://maven.apache.org/maven-1.x/"
-target="_blank">Maven </a>. 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 <a href="http://maven.apache.org/maven-1.x/start/index.html"
-target="_blank">here </a>.</p>
+                                  target="_blank">Maven </a>. 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 <a href="http://maven.apache.org/maven-1.x/start/index.html"
+                       target="_blank">here </a>.</p>
 <ul>
-  <li>MS Windows</li>
+    <li>MS Windows</li>
 </ul>
 <ol>
-  <li>Download and run the Windows installer package for Maven.</li>
-  <li>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)</li>
-  <li>Make sure that system variable JAVA_HOME is set to the location of your
-    JDK, eg. C:\Program Files\Java\jdk1.5.0_02</li>
-  <li>Run maven --version to verify that it is correctly installed.</li>
+    <li>Download and run the Windows installer package for Maven.</li>
+    <li>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)</li>
+    <li>Make sure that system variable JAVA_HOME is set to the location of your
+        JDK, eg. C:\Program Files\Java\jdk1.5.0_02</li>
+    <li>Run maven --version to verify that it is correctly installed.</li>
 </ol>
 
 <p align="center"><img alt="clip_image002 (15K)"
-src="images/clip_image002.jpg" height="211" width="477"></p>
+                       src="images/clip_image002.jpg" height="211" width="477"></p>
 <ul>
-  <li>Unix based OS (Linux etc)</li>
+    <li>Unix based OS (Linux etc)</li>
 </ul>
 
 <p>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 <a href="http://maven.apache.org/download.html#Installation"
-target="_blank">here </a>.</p>
+    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 <a href="http://maven.apache.org/download.html#Installation"
+             target="_blank">here </a>.</p>
 
 <p>Once maven is properly installed you can start building Axis2.</p>
 
 <p><a href="../faq.html#d4">Maven commands that are frequently used</a>
in
-Axis2 are listed on the <a href="../faq.html">FAQs</a> page.</p>
+    Axis2 are listed on the <a href="../faq.html">FAQs</a> page.</p>
 <a name="_Toc96698085"></a>
 
 <h3>Building Binaries and WAR File Using the Source Distribution</h3>
 
 <p>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 <code>maven</code> command will build the
-Axis2 jar file.</p>
+    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 <code>maven</code> command will build the
+    Axis2 jar file.</p>
 
 <p align="center"><img alt="clip_image004 (43K)" src="images/maven.jpg"><br
-clear="all">
+        clear="all">
 </p>
 
 <p>Once the command completes, the binaries (jar files in this case) can be
-found at a newly created "target" directory.</p>
+    found at a newly created "target" directory.</p>
 
 <p><strong>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.</strong></p>
+    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.</strong></p>
 <a name="war"></a>
 
 <p><strong></strong>The default maven build will however build only the
Axis2
-jar file. To obtain a <strong>WAR (Web Archive)</strong>, <code>maven
-war</code> command should be issued. This will create a complete WAR with the
-name axis2.war inside the target directory.</p>
+    jar file. To obtain a <strong>WAR (Web Archive)</strong>, <code>maven
+    war</code> command should be issued. This will create a complete WAR with the
+    name axis2.war inside the target directory.</p>
 
 <p>Once this build step is complete, the binaries are ready to be
-deployed.</p>
+    deployed.</p>
 <a name="_Toc96698086"></a></body>
 </html>



---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org


Mime
View raw message