Return-Path: Delivered-To: apmail-ws-axis-dev-archive@www.apache.org Received: (qmail 24171 invoked from network); 13 Nov 2006 10:09:47 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 13 Nov 2006 10:09:47 -0000 Received: (qmail 47674 invoked by uid 500); 13 Nov 2006 10:09:56 -0000 Delivered-To: apmail-ws-axis-dev-archive@ws.apache.org Received: (qmail 47594 invoked by uid 500); 13 Nov 2006 10:09:56 -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 47583 invoked by uid 500); 13 Nov 2006 10:09:56 -0000 Delivered-To: apmail-ws-axis2-cvs@ws.apache.org Received: (qmail 47580 invoked by uid 99); 13 Nov 2006 10:09:56 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 13 Nov 2006 02:09:56 -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 [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 13 Nov 2006 02:09:44 -0800 Received: by eris.apache.org (Postfix, from userid 65534) id 1C4561A9846; Mon, 13 Nov 2006 02:09:15 -0800 (PST) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r474226 - /webservices/axis2/branches/java/1_1/release-docs/readme-files/installation-std-bin.txt Date: Mon, 13 Nov 2006 10:09:15 -0000 To: axis2-cvs@ws.apache.org From: chatra@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20061113100915.1C4561A9846@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: chatra Date: Mon Nov 13 02:09:14 2006 New Revision: 474226 URL: http://svn.apache.org/viewvc?view=rev&rev=474226 Log: completed review 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=474226&r1=474225&r2=474226 ============================================================================== --- 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 Mon Nov 13 02:09:14 2006 @@ -1,118 +1,124 @@ - - 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:///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=, ...). - - - * 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 - 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 - 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 - - + + Axis2 Standard 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:///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=, ...). + + + * axis2server.{bat|sh} + + 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 + 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 + 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 + +Complete Installation Guide +=========================== +A complete Installation Guide on Apache Axis2 is available at +http://ws.apache.org/axis2/1_1/installationguide.html or at +Axis2_HOME/xdocs/1_1/installationguide.html in the extracted Axis2 Docs Distribution. + + --------------------------------------------------------------------- To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org For additional commands, e-mail: axis-cvs-help@ws.apache.org