axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dami...@apache.org
Subject svn commit: r378180 - /webservices/axis2/trunk/c/INSTALL
Date Thu, 16 Feb 2006 06:13:52 GMT
Author: damitha
Date: Wed Feb 15 22:13:49 2006
New Revision: 378180

URL: http://svn.apache.org/viewcvs?rev=378180&view=rev
Log:
added windows src and bin installation guide

Modified:
    webservices/axis2/trunk/c/INSTALL

Modified: webservices/axis2/trunk/c/INSTALL
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/c/INSTALL?rev=378180&r1=378179&r2=378180&view=diff
==============================================================================
--- webservices/axis2/trunk/c/INSTALL (original)
+++ webservices/axis2/trunk/c/INSTALL Wed Feb 15 22:13:49 2006
@@ -1,80 +1,206 @@
-The release comes in two forms, source and binary. 
-
-To get both the binary and source distribution, you need libxml2 from http://xmlsoft.org/downloads.html
-(NOTE: most Linux systems has libxml2 by default. On Windows you need to download and install
libxml2)
-
-Getting Axis2C working with the binary release on Linux.
-========================================================
-1. Extract the binary tar package to a folder. 
-   Set AXIS2C_HOME environment variable pointing to the location where you have extracted
Axis2C
-        AXIS2C_HOME='/your_path_to_axis2c'
-        export AXIS2C_HOME
-2. Run the simple axis server:
-        cd /your_path_to_axis2c/bin
-        ./axis2_http_server
-This will start the simple axis server on port 9090. To see the possible command line options
run
-        ./axis2_http_server -h
-NOTE: If you run into shared lib problems, set the LD_LIBRARY_PATH
-    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
-3. Run the sample clients in a new shell
-        cd /your_path_to_axis2c/bin/samples
-        ./echo
-This will invoke the echo service.
-        ./math
-This will invoke the math service.
-To see the possible command line options for sample clients run them with '-h' option
-NOTE: If you run into shared lib problems, set the LD_LIBRARY_PATH
-    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
-
-Getting Axis2C working with the source release on Linux.
-========================================================
-1. Extract the source tar package to a folder. 
-2. Set AXIS2C_HOME environment variable pointing to the location where you want to install
Axis2C.
-        AXIS2C_HOME='/your_desired_path_to_axis2c_installation'
-        export AXIS2C_HOME
-3. Then go to the folder where you extracted the source
-        cd /your_path_to_axis2c_source
-4. Set parser location
-You need to set the following two environment variables to point to libxml2. 
-        LIBXML2_INCLUDE
-        LIBXML2_LIB
-If you are using the default installation of libxml2, usually those are
-LIBXML2_LIB=/usr/lib
-LIBXML2_INCLUDE=/usr/include/libxml2
-
-5. Build the source
-This can be done using the following command sequence:
-        ./configure
-        make
-        make install
-use './configure --help' for options.
-NOTE: you may wish to use './configure --prefix=$AXIS2C_HOME' to ensure AXIS2C_HOME and 
-intall forlder are the same
-
-If you need to get the samples working, you also need to give the configure option
-    --enable-samples=yes
-
-6. go to AXIS2C_HOME
-        cd $AXIS2C_HOME
-
-7. Start simple axis server
-        cd $AXIS2C_HOME/bin
-        ./axis2_http_server
-This will start the simple axis server on port 9090. To see the posible command line options
run:
-        ./axis2_http_server -h
-8. Run the sample clients in a new shell
-        cd $AXIS2C_HOME/bin/samples
-        ./echo
-This will invoke the echo service.
-        ./math
-This will invoke the math service.
-To see the possible command line options for sample clients run them with '-h' option
-
-
-Getting Axis2C working with the binary release on Windows.
-========================================================
-
-Getting Axis2C working with the source release on Windows.
-========================================================
-
-Hope you would enjoy this first working version of Axis2C soap engine :)
+The release comes in two forms, source and binary. 
+
+To get both the binary and source distribution, you need libxml2 from http://xmlsoft.org/downloads.html
+(NOTE: most Linux systems has libxml2 by default. On Windows you need to download and install
libxml2)
+
+Getting Axis2C working with the binary release on Linux.
+========================================================
+1. Extract the binary tar package to a folder. 
+   Set AXIS2C_HOME environment variable pointing to the location where you have extracted
Axis2C
+        AXIS2C_HOME='/your_path_to_axis2c'
+        export AXIS2C_HOME
+2. Run the simple axis server:
+        cd /your_path_to_axis2c/bin
+        ./axis2_http_server
+This will start the simple axis server on port 9090. To see the possible command line options
run
+        ./axis2_http_server -h
+NOTE: If you run into shared lib problems, set the LD_LIBRARY_PATH
+    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
+3. Run the sample clients in a new shell
+        cd /your_path_to_axis2c/bin/samples
+        ./echo
+This will invoke the echo service.
+        ./math
+This will invoke the math service.
+To see the possible command line options for sample clients run them with '-h' option
+NOTE: If you run into shared lib problems, set the LD_LIBRARY_PATH
+    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
+
+Getting Axis2C working with the source release on Linux.
+========================================================
+1. Extract the source tar package to a folder. 
+2. Set AXIS2C_HOME environment variable pointing to the location where you want to install
Axis2C.
+        AXIS2C_HOME='/your_desired_path_to_axis2c_installation'
+        export AXIS2C_HOME
+3. Then go to the folder where you extracted the source
+        cd /your_path_to_axis2c_source
+4. Set parser location
+You need to set the following two environment variables to point to libxml2. 
+        LIBXML2_INCLUDE
+        LIBXML2_LIB
+If you are using the default installation of libxml2, usually those are
+LIBXML2_LIB=/usr/lib
+LIBXML2_INCLUDE=/usr/include/libxml2
+
+5. Build the source
+This can be done using the following command sequence:
+        ./configure
+        make
+        make install
+use './configure --help' for options.
+NOTE: you may wish to use './configure --prefix=$AXIS2C_HOME' to ensure AXIS2C_HOME and 
+intall forlder are the same
+
+If you need to get the samples working, you also need to give the configure option
+    --enable-samples=yes
+
+6. go to AXIS2C_HOME
+        cd $AXIS2C_HOME
+
+7. Start simple axis server
+        cd $AXIS2C_HOME/bin
+        ./axis2_http_server
+This will start the simple axis server on port 9090. To see the posible command line options
run:
+        ./axis2_http_server -h
+8. Run the sample clients in a new shell
+        cd $AXIS2C_HOME/bin/samples
+        ./echo
+This will invoke the echo service.
+        ./math
+This will invoke the math service.
+To see the possible command line options for sample clients run them with '-h' option
+
+
+Getting Axis2C working with the binary release on Windows.
+========================================================
+
+Requirements
+------------
+
+* the binaries shipped with this version is compiled with Microsoft visual studio compiler
(cl) 
+(Note: you can download microsoft VSExpress2005 editon from microsoft website and intall
it to run these binaries)
+
+* You also need the following dlls
+	- libxml2.dll [http://www.xmlsoft.org - download the version >=  libxml2-2.6.20.win32]
+	- iconv.dll [http://www.xmlsoft.org - download the version >= iconv-1.9.1.win32]
+	- zlib1.dll [http://www.xmlsoft.org - download the version >= zlib-1.2.3.win32]
+
+Binaries
+--------
+
+Extract the binary distribution to a folder of your choice. (example: C:\axis2c-M0.4)
+
+The c:\axis2c-M0.4 folder structure is as follows.
+
+     axis2c-M0.4
+	|- bin        - server and other executables
+       	|- samples - samples go here
+        	|	
+ 	|- lib	      - library modules
+ 	|- services   - deployed services 
+	|- modules    - deployed modules 
+	|- include    - all include files of axis2 
+	|- logs       - system and client logs are written to this folder
+
+Copy libxml2.dll, iconv.dll and zlib1.dll downloaded to C:\axis2c-M0.4\lib
+
+Running
+-------
+You need to set couple of environment variables before you can run the server and samples.
+
+Set the varibale AXIS2C_HOME to the deploy folder (C:\axis2c-M0.4)
+Add the path to lib directory to PATH variable (%AXIS2C_HOME%\lib)
+
+Now everything is set to run the server!
+
+C:\axis2c-M0.4\bin>axis2_http_server.exe 
+
+You should see the message
+Started Simple Axis2 HTTP Server...
+
+The log is by default created under %AXIS2C_HOME%\logs folder with the name axis2.log.
+(Note: you may provide command line options to change the default behaviour. Type "axis2_http_server.exe
-h" to learn about  the usage)
+
+Now you can run any sample client deployed under %AXIS2C_HOME%\bin\samples\
+Example:
+C:\axis2c-M0.4\bin\samples>echo.exe
+
+
+
+Getting Axis2C working with the source release on Windows.
+========================================================
+
+Requirements
+------------
+
+* the makefile shipped with this version needs Microsoft visual studio compiler (cl) and
nmake build tool 
+(Note: you can download microsoft VSExpress2005 editon and Platform SDK from microsoft website.
You will need to add the path  to Platform SDK Include and Lib folders to makefile)
+
+* You also need 
+	- libxml2 [http://www.xmlsoft.org - download the version >=  libxml2-2.6.20.win32]
+	- iconv [http://www.xmlsoft.org - download the version >= iconv-1.9.1.win32]
+	- zlib [http://www.xmlsoft.org - download the version >= zlib-1.2.3.win32]
+
+Configure.in
+------------
+The default places for libxml2 and iconv are speceficed in configure.in. 
+
+Example:
+Default location for libxml2 is C:\libxml2
+	You can either extract libxml2 to this folder. Folder structure should look like the following.
+	C:\libxml2
+		|- include
+		|- bin
+		|- lib
+	Or extract to whatever place of your choice and edit the configure.in accordingly.
+
+You need to have zlib1.dll in a library path. You may copy this dll to libxml2/lib.
+	
+
+Compiling the source
+--------------------
+Extract the source distribution to a folder of your choice. (Example: C:\axis2c)
+Open a DOS shell
+cd C:\axis2c\build\win32
+C:\axis2c\build\win32>vcvars32.bat to access .Net tools (Note: You may need to set the
environment PATH variable to  vcvars32.bat if windows complaints that it cannot find this
bat)
+C:\axis2c\build\win32>nmake install
+
+
+Thats it! This will build the system and create a directory named deploy under build directory.
+The deploy folder structure is as follows.
+
+     deploy
+	|- bin        - server and other executables
+       	|   |- samples - samples go here
+        	|	
+ 	|- lib	      - library modules
+ 	|- services   - deployed services 
+	|- modules    - deployed modules 
+	|- include    - all include files of axis2 
+	|- logs       - system and client logs are written to this folder
+
+
+Running
+-------
+You need to set couple of environment variables before you can run the server and samples.
+
+Set the varibale AXIS2C_HOME to the deploy folder (C:\axis2c\build\deploy)
+Add the path to lib directory to PATH variable (%AXIS2C_HOME%\lib)
+
+Copy libxml2.dll, iconv.dll and zlib1.dll to axis2c lib folder (%AXIS2C_HOME%\lib)
+
+Now everything is set to run the server!
+
+C:\axis2c\build\deploy\bin>axis2_http_server.exe 
+
+You should see the message
+Started Simple Axis2 HTTP Server...
+
+The log is by default created under %AXIS2C_HOME%\logs folder with the name axis2.log.
+(Note: you may provide command line options to change the default behaviour. Type "axis2_http_server.exe
-h" to learn about  the usage)
+
+Now you can run any sample client deployed under %AXIS2C_HOME%\bin\samples\
+Example:
+C:\axis2c\build\deploy\bin\samples>echo.exe
+
+Hope you would enjoy this first working version of Axis2C soap engine :)



Mime
View raw message