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 th...@apache.org on 2006/11/12 22:44:25 UTC
svn commit: r474052 -
/webservices/axis2/branches/java/1_1/release-docs/readme-files/installation-std-bin.txt
Author: thilina
Date: Sun Nov 12 13:44:24 2006
New Revision: 474052
URL: http://svn.apache.org/viewvc?view=rev&rev=474052
Log:
adding the installation guide for the std-bin
Modified:
webservices/axis2/branches/java/1_1/release-docs/readme-files/installation-std-bin.txt
Modified: webservices/axis2/branches/java/1_1/release-docs/readme-files/installation-std-bin.txt
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/java/1_1/release-docs/readme-files/installation-std-bin.txt?view=diff&rev=474052&r1=474051&r2=474052
==============================================================================
--- webservices/axis2/branches/java/1_1/release-docs/readme-files/installation-std-bin.txt (original)
+++ webservices/axis2/branches/java/1_1/release-docs/readme-files/installation-std-bin.txt Sun Nov 12 13:44:24 2006
@@ -1,6 +1,118 @@
-======================================================
-Apache Axis2 @axisVersion@ build (@TODAY@)
-Documentation Release
-
-http://ws.apache.org/axis2
-------------------------------------------------------
\ No newline at end of file
+
+ Axis2 Binary Distribution Installation Guide
+ ============================================
+
+1. Download and Install the Apache Axis2 Binary Distribution
+
+ Download and install a Java Development Kit (JDK) release (version 1.4 or
+ later) from http://java.sun.com/j2se/. Install the JDK according to the
+ instructions included with the release.Set an environment variable JAVA_HOME
+ to the pathname of the directory into which you installed the JDK release.
+
+ Download and unpack the Axis2 Standard Binary Distribution into a convenient
+ location so that the distribution resides in its own directory. Set an
+ environment variables AXIS2_HOME to the pathname of the extracted directory
+ of Axis2 (Eg: /opt/axis2-1.1).
+
+
+2. Starting up Axis2 Standalone Server
+
+ Standalone Axis2 server can be started by executing the following commands:
+ $AXIS2_HOME\bin\axis2server.bat (Windows)
+ $AXIS2_HOME/bin/axis2server.sh (Unix)
+
+ After startup, the default web services included with Axis2 will be available
+ by visiting:
+ http://localhost:8080/axis2/services/
+
+
+3. Building the Axis2 Web Application (axis2.war) Using Standard Binary
+Distribution
+
+ Download and install Apache Ant (version 1.6.5 or later) from http://
+ ant.apache.org. Install the Apache Ant according to the instructions included
+ with the Ant release.
+
+ Locate the ant build file (build.xml) inside the webapp directory which
+ resides in your Axis2 home directory (i.e:- $AXIS_HOME/webapp)". Run the Ant
+ build by executing "ant create.war" inside the $AXIS2_HOME/webapps folder.
+ You can find the generated axis2.war inside the $AXIS2_HOME/dist directory.
+ All the services and modules that are present in the AXIS2_HOME/repository
+ will be packed in to the created axis2.war together with the Axis2
+ configuration file found at $AXIS2_HOME/conf/axis2.xml.
+
+ 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.) Once the
+ WAR is successfully installed, test it by pointing the web browser to the
+ http://<host :port>/axis2. It should produce the the Axis2 Web Application
+ Home Page.
+
+ 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.
+
+ Read http://ws.apache.org/axis2/1_1/installationguide.html#servlet_container
+ for more information.
+
+
+4. Getting Familiar with the Axis2 Convenient Scripts
+
+ It is advised to add the $AXIS2_HOME/bin to the PATH, so that you'll be able
+ to run the following scripts from any where.
+
+ * axis2.{bat|sh}
+
+ You can use this script to run web service clients written using Axis2. This
+ script calls the "java" command after adding the classpath for Axis2
+ dependent libraries (*.jar files present in your AXIS2_HOME/lib), setting
+ the Axis2 repository location (AXIS2_HOME/repository) and setting the Axis2
+ configuration file location(AXIS2_HOME/conf/axis2.xml) for you. With this
+ you can be relieved from setting all the above Axis2 specific parameters.
+
+ Usage : axis2.{sh.bat} [-options] class [args...]
+ Eg: $axis2.sh -classpath myservice-client.jar sample.foo.Client
+
+ All the options supported by "java" are supported here (Eg: -classpath, -
+ D<name>=<value>, ...).
+
+
+ * axis2server.{sh|bat}
+
+ This script will start an standalone Axis2 server using the AXIS2_HOME/
+ repository directory as the Axis2 repository and the AXIS2_HOME/conf/
+ axis2.xml as the Axis2 configuration file. This will start all the
+ transport listeners listed in the AXIS2_HOME/conf/axis2.xml.
+
+ For an example, if you want to deploy a service using standalone Axis2
+ server,then copy your service archive to the AXIS2_HOME/repository/services
+ directory. After that go to the "Transport Ins" section of the AXIS2_HOME/
+ conf/axis2.xml and configure the tranport receivers (simpleHttpServer in
+ port 8080 is listed by default). Then invoke this script.
+
+
+ * wsdl2java.{bat|sh}
+
+ This script generates java code according to a given WSDL file to handle Web
+ service invocations (Client side Stubs). This script also has the ability to
+ generate service skeletons according to the given wsdl.
+
+ Usage: WSDL2Java.{sh|bat} [OPTION]... -uri <Location of WSDL>
+ Eg: WSDL2Java.sh -uri ../wsdl/Axis2Sample.wsdl
+
+ A more detailed reference about this script can be found http://
+ ws.apache.org/axis2/1_1/reference.html.
+
+
+ * java2wsdl.{bat|sh}
+
+ This script generates the appropriate WSDL file for a given java class.
+ Usage: Java2WSDL.{sh|bat} [OPTION]... -cn <fully qualified class name>
+ Eg: Java2WSDL.sh -cn ../samples/test/searchTool.Search
+
+ A more detailed reference about this script can be found in http://
+ ws.apache.org/axis2/1_1/reference.html
+
+
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org