You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by de...@apache.org on 2005/06/06 13:44:55 UTC
svn commit: r180296 - in /webservices/axis/trunk/java/xdocs: ./ images/
Author: deepal
Date: Mon Jun 6 04:44:53 2005
New Revision: 180296
URL: http://svn.apache.org/viewcvs?rev=180296&view=rev
Log:
added installation gide
Added:
webservices/axis/trunk/java/xdocs/images/faultmsg.JPG (with props)
webservices/axis/trunk/java/xdocs/images/faultservice.JPG (with props)
webservices/axis/trunk/java/xdocs/images/maven.jpg (with props)
webservices/axis/trunk/java/xdocs/installationguide.htm
Modified:
webservices/axis/trunk/java/xdocs/images/clip_image006.jpg
webservices/axis/trunk/java/xdocs/images/clip_image008.jpg
webservices/axis/trunk/java/xdocs/images/clip_image010.jpg
webservices/axis/trunk/java/xdocs/images/clip_image012.jpg
Modified: webservices/axis/trunk/java/xdocs/images/clip_image006.jpg
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images/clip_image006.jpg?rev=180296&r1=180295&r2=180296&view=diff
==============================================================================
Binary files - no diff available.
Modified: webservices/axis/trunk/java/xdocs/images/clip_image008.jpg
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images/clip_image008.jpg?rev=180296&r1=180295&r2=180296&view=diff
==============================================================================
Binary files - no diff available.
Modified: webservices/axis/trunk/java/xdocs/images/clip_image010.jpg
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images/clip_image010.jpg?rev=180296&r1=180295&r2=180296&view=diff
==============================================================================
Binary files - no diff available.
Modified: webservices/axis/trunk/java/xdocs/images/clip_image012.jpg
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images/clip_image012.jpg?rev=180296&r1=180295&r2=180296&view=diff
==============================================================================
Binary files - no diff available.
Added: webservices/axis/trunk/java/xdocs/images/faultmsg.JPG
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images/faultmsg.JPG?rev=180296&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/axis/trunk/java/xdocs/images/faultmsg.JPG
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/axis/trunk/java/xdocs/images/faultservice.JPG
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images/faultservice.JPG?rev=180296&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/axis/trunk/java/xdocs/images/faultservice.JPG
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/axis/trunk/java/xdocs/images/maven.jpg
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images/maven.jpg?rev=180296&view=auto
==============================================================================
Binary file - no diff available.
Propchange: webservices/axis/trunk/java/xdocs/images/maven.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: webservices/axis/trunk/java/xdocs/installationguide.htm
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/installationguide.htm?rev=180296&view=auto
==============================================================================
--- webservices/axis/trunk/java/xdocs/installationguide.htm (added)
+++ webservices/axis/trunk/java/xdocs/installationguide.htm Mon Jun 6 04:44:53 2005
@@ -0,0 +1,121 @@
+<html>
+<head>
+<title>Axis2 Installation Guide</title>
+</head>
+<body>
+<h3><a name="_Toc96698081"></a>Introduction </h3>
+<p>Axis 2.0 can be downloaded as a <a href="releases.html">zipped binary </a> or the <a href="cvs-usage.html">source </a>.
+This section describes how Axis2 can be installed either as a
+standalone server or as part of a J2EE compliant servlet container. </p>
+
+<h3><a name="_Toc96698082"></a>Prerequisites </h3>
+<p>Axis2 requires the Java Runtime Environment to be properly
+installed. Axis is developed to be run on JRE 1.4 and upwards but it
+has not been fully tested with the latest JRE 1.5. Hence it is safe to
+run Axis with Java 1.4. If the JRE is not already in place it must be
+installed to proceed further. For instructions on setting up the JRE in
+different operating systems, please visit <a href="http://java.sun.com/">http://java.sun.com </a>. </p>
+<p>All the required jars are shipped with the binary distribution and
+if the source distribution is used, running the maven build will
+automatically download the required jars for you. </p>
+<p>Following sections describe how each type of distribution needs to
+be installed. Since the process with the source distribution is similar
+to the binary distribution after building, the first section explains
+the process of building Axis from source. If you have the binary
+distribution you can skip the build sections and directly go to the
+binary installation section. </p>
+<h3><a name="_Toc96698083"></a>Building Axis2 from source </h3>
+<h4><a name="_Toc96698084"></a>Setting up the Environment and the tools </h4>
+<p>The Axis2 build is based on <a href="http://maven.apache.org/">Maven </a>.
+Hence the prerequisite to build Axis2 from source is to have Maven
+installed. Even though extensive instruction guides are available at
+the Maven site, this guide also 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/start/index.html">here </a>. </p>
+
+<p>For Windows users the easiest way is to download the windows
+installer package. Once the installer package is run, all the necessary
+environment variables will be properly set. Once Maven is installed,
+the success of the installation can be tested by typing maven
+version in the command prompt. </p>
+<p align="center">
+<img alt="clip_image002 (15K)" src="images/clip_image002.jpg" height="211" width="477"/>
+<p> </p>
+<p>
+For Linux users the tar ball or the zip archive is the best
+options. (Unfortunately there is no rpm as such that can be easily
+installed) 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/start/install.html">here </a>. </p>
+<p>Once maven is properly installed it's all that is needed to start building Axis2. </p>
+<h4><a name="_Toc96698085"></a>The Axis source distribution </h4>
+<p>The <a href="releases.html">source distribution </a> is available as
+a zipped archive or a tar ball. 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 typing maven will build the axis jar file. </p>
+
+<p align="center"><img alt="clip_image004 (43K)" src="images/maven.jpg" height="338" width="669" /></p>
+<p>Once the command completes, the binaries (jar files in this case) can be 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>
+<p><strong> </strong>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. </p>
+<p>Once this build step is complete, the binaries are ready to be deployed. </p>
+<h3><a name="_Toc96698086"></a>Installing Axis2 in a Servlet container </h3>
+<p>Installation of the WAR is quite simple. It's a matter of dropping
+the war in the webapps folders and most servlet containers will
+automatically install the war. However some servlet containers may
+require a restart in order to capture the new web application. Please
+refer your servlet container documentation for more information about
+this. </p>
+<p>Once the WAR is successfully installed it can be tested by pointing the web
+browser to the <strong>http:// <host :port>/ axis2. </strong>It should produce the following page.
+</p>
+<p align="center"><strong><img src="images/clip_image006.JPG"></strong></p>
+<p>
+To ensure that everything is fine and smooth, a probing of the system can be done
+through the validate link. 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 axis libraries are present.
+</p>
+<p align="center"><strong><img src="images/clip_image008.JPG"></strong></p>
+<p>
+The axis 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.
+</p>
+<p align="center"><strong><img src="images/clip_image010.JPG"></strong></p>
+<p>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 instantly installed. </p>
+<p>Since Axis2 supports hot deployment one can drop the service jar
+directly through the file system to the above mentioned services
+directory and it will also cause the service to be automatically
+installed without the container being restarted. </p>
+
+<p>To check the successful installation of a service <strong><em>available services link </em></strong>
+is provided. The services and the operations of successfully installed
+services will be displayed in the available services page.</p>
+<p align="center"><strong><img src="images/clip_image012.JPG"></strong></p>
+<p>If the service has deployment time error it will listed out those services as faulty services.
+And If you click on the link it will show your the deployment fault</p>
+<p align="center"><strong><img src="images/faultService.JPG"></strong></p>
+<p>Deployment time error message</P>
+<p align="center"><strong><img src="images/faultmsg.JPG"></strong></p>
+
+<p> </p>
+<p> </p>
+<p>Axis2 Administration is all about configuring axis2 at the run time and
+the configuration will be transient , and more descriptions are avilable in
+axis2 admin web module guide</p>
+</body>
+</html>