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 ch...@apache.org on 2006/11/13 11:09:15 UTC
svn commit: r474226 -
/webservices/axis2/branches/java/1_1/release-docs/readme-files/installation-std-bin.txt
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://<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
-
-
+
+ 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://<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.{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 <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
+
+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