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 du...@apache.org on 2008/06/11 08:17:32 UTC
svn commit: r666539 - in /webservices/axis2/trunk/c: CREDITS INSTALL NEWS
Author: dushshantha
Date: Tue Jun 10 23:17:32 2008
New Revision: 666539
URL: http://svn.apache.org/viewvc?rev=666539&view=rev
Log:
Applied the patch for AMQP Doc
Modified:
webservices/axis2/trunk/c/CREDITS
webservices/axis2/trunk/c/INSTALL
webservices/axis2/trunk/c/NEWS
Modified: webservices/axis2/trunk/c/CREDITS
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/c/CREDITS?rev=666539&r1=666538&r2=666539&view=diff
==============================================================================
--- webservices/axis2/trunk/c/CREDITS (original)
+++ webservices/axis2/trunk/c/CREDITS Tue Jun 10 23:17:32 2008
@@ -1,8 +1,11 @@
-James Clark, author of Expat, for having provided very useful guidance on the proper way to design and implement a highly reusable C library.
+James Clark, author of Expat, for having provided very useful guidance on the
+proper way to design and implement a highly reusable C library.
Apache Project's
----------------
-Apache Axis2 [http://ws.apache.org/axis2] - Initial Architecture
-Apache Maven [http://maven.apache.org/] - Site generation.
-Apache APR [http://apr.apache.org/] - Versioning Guideline, Some codes in util
-Apache HTTPD [http://httpd.apache.org/] - mod_axis2
+Apache Axis2 [http://ws.apache.org/axis2] - Initial Architecture
+Apache Maven [http://maven.apache.org/] - Site generation
+Apache APR [http://apr.apache.org/] - Versioning Guideline,
+ Some codes in util
+Apache HTTPD [http://httpd.apache.org/] - mod_axis2
+Apache Qpid [http://cwiki.apache.org/qpid/index.html] - AMQP implementation
Modified: webservices/axis2/trunk/c/INSTALL
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/c/INSTALL?rev=666539&r1=666538&r2=666539&view=diff
==============================================================================
--- webservices/axis2/trunk/c/INSTALL (original)
+++ webservices/axis2/trunk/c/INSTALL Tue Jun 10 23:17:32 2008
@@ -1,168 +1,327 @@
Table of Contents
=================
+1. Getting Axis2/C Working on Linux
+
+ 1.1 Setting up Prerequisites
+ 1.1.1 Mandatory
+ 1.1.2 Optional
+ 1.2 Using Binary Release
+ 1.3 Using Source Release
+ 1.3.1 Basic Build
+ 1.3.2 Build with Options
+ (a) With libxml2
+ (b) With AMQP Transport
+ 1.3.3 Building Samples
+ 1.4 Configuration
+ 1.4.1 AMQP Transport
+ 1.5 Running Samples
+ 1.5.1 HTTP Transport
+ (a) Server
+ (b) Clients
+ 1.5.2 AMQP Transport
+ (a) Configuration
+ (b) Server
+ (c) Client
-1. Getting Axis2/C working with the binary release on Linux
-2. Getting Axis2/C working with the source release on Linux
-3. Getting Axis2/C working with the binary release on Windows (win32)
- 3.1 Requirements
- 3.2 Binaries in the release
- 3.3 Running the binaries
-4. Getting Axis2/C working with the source release on Windows (win32)
- 4.1 Requirements
- 4.2 Editing Configure.in file
- 4.3 Compiling the source
- 4.4 Running the binaries
-5. Installing Apache2 Web Server integration module (mod_axis2)
-
-
-1. Getting Axis2/C working with the binary release on Linux.
-============================================================
+2. Getting Axis2/C Working on Windows (Win32)
+
+ 2.1 Setting up Prerequisites
+ 2.1.1 Mandatory
+ 2.1.2 Optional
+ 2.2 Using Binary Release
+ 2.3 Using Source Release
+ 2.3.1 Editing Configure.in File
+ 2.3.2 Compiling the Source
+ 2.4 Running Samples
+ 2.4.1 HTTP transport
+ (a) Server
+ (b) Clients
-1. Extract the binary tar package to a directory.
+3. Installing Apache2 Web Server Integration Module (mod_axis2)
+
+ 3.1 Building mod_axis2 from Source
+ 3.1.1 On Linux
+ 3.1.2 On Windows (Win32)
+ 3.2 Deploying in Apache2 Web Server
-2. Set AXIS2C_HOME environment variable pointing to the location where you have
- extracted Axis2/C
- AXIS2C_HOME='/your_path_to_axis2c'
- export AXIS2C_HOME
+4. Installing IIS (Interner Information Server) Integration Module
+ (mod_axis2_IIS)
+
+ 4.1 Building mod_axis2_IIS from Source
+ 4.2 Deploying in the IIS
- NOTE: You will need to set AXIS2C_HOME only if you need to run Axis2/C
- samples or tests. The reason is that the samples and test codes use
- AXIS2C_HOME to get the path to Axis2/C. To write your own services or
- clients this is not a requirement.
+5. FAQ
-3. 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
+1. Getting Axis2/C Working on Linux
+===================================
-4. Run the sample clients in a new shell
- cd /your_path_to_axis2c/bin/samples
- ./echo
- This will invoke the echo service.
+ 1.1 Setting up Prerequisites
+ ----------------------------
- ./math
- This will invoke the math service.
+ 1.1.1 Mandatory
+ ---------------
+ (a) zlib - http://www.zlib.net/
+
+ 1.1.2 Optional
+ --------------
+ (a) libxml2 - http://www.xmlsoft.org/
+ (b) libiconv - http://www.gnu.org/software/libiconv/
+
+ (c) Apache Qpid - You need to have Qpid libraries installed on your machine
+ if you are going to use AMQP transport. It is imperative
+ that you compile and install Qpid from SVN source.
+ You can checkout Qpid SVN source from
+ https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid.
+
+ 1.2 Using Binary Release
+ ------------------------
+
+ (a) Extract the binary tar package to a directory.
+
+ (b) Set AXIS2C_HOME environment variable pointing to the location where you
+ have extracted Axis2/C.
+
+ $ AXIS2C_HOME='/your_path_to_axis2c'
+ $ export AXIS2C_HOME
+
+ NOTE : You will need to set AXIS2C_HOME only if you need to run Axis2/C
+ samples or tests. The reason is that the samples and test codes
+ use AXIS2C_HOME to get the path to Axis2/C. To write your own
+ services or clients this is not a requirement.
- To see the possible command line options for sample clients run them with
- '-h' option
+ 1.3 Using Source Release
+ ------------------------
- 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
+ 1.3.1 Basic Build
+ -----------------
+
+ (a) Extract the source tar package to a directory
+ (b) Set AXIS2C_HOME environment variable pointing to the location where you
+ want to install Axis2/C.
+
+ $ AXIS2C_HOME='/your_desired_path_to_axis2c_installation'
+ $ export AXIS2C_HOME
-2. Getting Axis2/C working with the source release on Linux.
-============================================================
+ NOTE : You will need to set AXIS2C_HOME only if you need to run Axis2/C
+ samples or tests. The reason is that the samples and test codes
+ use AXIS2C_HOME to get the path to Axis2/C. To write your own
+ services or clients this is not a requirement.
-1. Extract the source tar package to a directory
+ (c) Go to the directory where you extracted the source
+
+ $ cd /your_path_to_axis2c_source
-2. Set AXIS2C_HOME environment variable pointing to the location where you want
- to install Axis2/C.
- AXIS2C_HOME='/your_desired_path_to_axis2c_installation'
- export AXIS2C_HOME
+ (d) Build the source
+ This can be done by running the following command sequence in the
+ directory where you have extracted the source.
+
+ $ ./configure --prefix=${AXIS2C_HOME}
+ $ make
+ $ sudo make install
+
+ Please run './configure --help' in respective sub directories for more
+ information on these configure options.
+
+ NOTE : If you don't provide the --prefix configure option, it will by
+ default be installed into '/usr/local/axis2c' directory.
+
+ You could run 'make check' to test if everything is working fine. However,
+ note that the test/core/clientapi/test_clientapi program would fail unless
+ AXIS2C_HOME points to the installed location. (It's looking for Axis2/C
+ repository) This means you really should run 'make && make install',
+ then set 'AXIS2C_HOME=/path/to/install', and then 'make check'.
+ That's a little different than the usual 'make && make check && make
+ install' process.
+
+ 1.3.2 Build with Options
+ ------------------------
+
+ (a) With libxml2
+ ----------------
+
+ You may need to try Axis2/C with libxml2 xml parser. You can do it by
+ giving '--enable-libxml2=yes' as a configure option.
+
+ $ ./configure --enable-libxml2=yes [other configuration options]
+ $ make
+ $ sudo make install
+
+ (b) With AMQP Transport
+ -----------------------
- NOTE: You will need to set AXIS2C_HOME only if you need to run Axis2/C
- samples or tests. The reason is that the samples and test codes use
- AXIS2C_HOME to get the path to Axis2/C. To write your own services or
- clients this is not a requirement.
+ You may need to try Axis2/C with the AMQP transport. You can do it by
+ giving '--with-qpid=/path/to/qpid/home' as a configure option.
+
+ $ ./configure --with-qpid=/path/to/qpid/home [other configuration options]
+ $ make
+ $ sudo make install
-3. Go to the directory where you extracted the source
- cd /your_path_to_axis2c_source
+ 1.3.3 Building Samples
+ ----------------------
-4. Build the source
- This can be done by running the following command sequence in the directory
- where you have extracted the source.
+ If you need to get the samples working, you also need to build the samples.
+
+ To build the samples:
+
+ $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib/
+ $ cd samples
+ $ ./configure --prefix=${AXIS2C_HOME}
+ --with-axis2=${AXIS2C_HOME}/include/axis2-1.4.0
+ $ make
+ $ sudo make install
+
+ Please run './configure --help' in samples folder for more information on
+ configure options.
- ./configure --prefix=${AXIS2C_HOME}
- make
- sudo make install
+ NOTE : If you don't provide a --prefix configure option, samples will by
+ default be installed into '/usr/local/axis2c/samples' directory.
- Please run './configure --help' in respective sub folders for more
- information on these configure options.
+ 1.4 Configuration
+ -----------------
- NOTE: If you don't provide the --prefix configure option, it will by default
- be installed into '/usr/local/axis2c' directory.
+ 1.4.1 AMQP Transport
+ --------------------
+
+ You need to add the following entries into the axis2.xml.
- You could run 'make check' to test if everything is working fine. However,
- note that the test/core/clientapi/test_clientapi program would fail unless
- AXIS2C_HOME points to the installed location. (It's looking for Axis2/C
- repository) This means you really should run 'make && make install',
- then set 'AXIS2C_HOME=/path/to/install', and then 'make check'.
- That's a little different than the usual 'make && make check && make
- install' process.
+ <transportReceiver name="amqp" class="axis2_amqp_receiver">
+ <parameter name="qpid_broker_ip" locked="false">127.0.0.1</parameter>
+ <parameter name="qpid_broker_port" locked="false">5672</parameter>
+ </transportReceiver>
- You may need to try Axis2/C with Libxml2 xml parser. You can do it by giving
- '--enable-libxml2=yes' as a configure option.
-
- ./configure --enable-libxml2=yes [other configuration options]
- make
- sudo make install
+ <transportSender name="amqp" class="axis2_amqp_sender"/>
- If you need to get the samples working, you also need to build the samples.
-
- To build the samples:
+ 1.5 Running Samples
+ -------------------
- export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/axis2c/lib/
- cd samples
- ./configure --prefix=${AXIS2C_HOME} --with-axis2=${AXIS2C_HOME}/include/axis2-1.4.0
- make
- sudo make install
+ 1.5.1 HTTP Transport
+ --------------------
+
+ (a) Server
+ ----------
- Please run './configure --help' in samples folder for more information on
- configure options.
+ You have to first start the axis2_http_server as follows.
+
+ $ cd ${AXIS2C_HOME}/bin
+ $ ./axis2_http_server
+
+ You should see the message
+ Started Simple 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 1 : You may need to login as superuser to run the axis2_http_server.
+ NOTE 2 : If you run into shared lib problems, set the LD_LIBRARY_PATH as
+ follows.
+
+ $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib
- NOTE: If you don't provide a --prefix configure option, samples will by default
- be installed into '/usr/local/axis2c/samples' directory.
+ (b) Clients
+ -----------
+
+ When the axis2_http_server is up and running, you can run the sample
+ clients in a new shell as follows.
+
+ $ cd ${AXIS2C_HOME}/bin/samples
+ $ ./echo
+ This will invoke the echo service.
-5. Go to the folder where you installed Axis2/C.
+ $ ./math
+ This will invoke the math service.
-6. Start simple axis server
- cd ${AXIS2C_HOME}/bin
- ./axis2_http_server
+ To see the possible command line options for sample clients run them
+ with '-h' option
- 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 as
+ follows.
+ $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib
- NOTE: You may need to be login as superuser to run the simple axis server.
+ 1.5.2 AMQP Transport
+ --------------------
-8. Run the sample clients in a new shell
- cd ${AXIS2C_HOME}/bin/samples
- ./echo
- This will invoke the echo service.
+ (a) Server
+ ----------
- ./math
- This will invoke the math service.
+ Start the Qpid broker as follows.
+
+ $ cd ${QPID_HOME}/sbin
+ $ ./qpidd --data-dir ./
- To see the possible command line options for sample clients, run them with
- '-h' option.
+ Start the axis2_amqp_server as follows.
+
+ $ cd ${AXIS2C_HOME}/bin
+ $ ./axis2_amqp_server
+
+ You should see the message
+ Started Simple Axis2 AMQP Server...
+
+ This will connect to the Qpid broker listening on 127.0.0.1:5672.
+ To see the possible command line options run
+
+ $ ./axis2_amqp_server -h
+
+ NOTE 1 : You have the flexibility of starting the Qpid broker first and
+ then axis2_amqp_server or vise versa.
+ NOTE 2 : You may need to login as superuser to run the axis2_amqp_server.
+ NOTE 3 : If you run into shared lib problems, set the LD_LIBRARY_PATH as
+ follows.
+
+ $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib
+ (b) Clients
+ -----------
+
+ When the axis2_amqp_server is up and running, you can run the sample
+ clients in a new shell as follows.
+
+ $ cd ${AXIS2C_HOME}/bin/samples/amqp
+ $ ./echo_blocking
+ This will invoke the echo service.
-3. Getting Axis2/C working with the binary release on Windows.
-==============================================================
+ To see the possible command line options for sample clients run them
+ with '-h' option
-3.1 Requirements
-----------------
+ NOTE : If you run into shared lib problems, set the LD_LIBRARY_PATH as
+ follows.
- * The binaries shipped with this version are compiled with Microsoft Visual
- Studio compiler (cl)
+ $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib
+
- Note: You can download Microsoft VS Express2005 Edition from Microsoft
- website and install it to run these binaries
+2. Getting Axis2/C Working on Windows (Win32)
+=============================================
+
+ 2.1 Setting up Prerequisites
+ ----------------------------
+
+ 2.1.1 Mandatory
+ ---------------
+ (a) The binaries shipped with this version are compiled with
+ Microsoft Visual Studio compiler (cl). And also the makefile that is
+ shipped with this version needs Microsoft Visual Studio compiler (cl)
+ and nmake build tool.
+
+ NOTE : You can download Microsoft VS Express2005 Edition and
+ Platform SDK from Microsoft website. You need to add the path to
+ Platform SDK Include and Lib folders to the makefile in order
+ for you to compile the source.
- * You also need the following dlls
- - zlib1.dll [http://www.zlatkovic.com/pub/libxml - version >= zlib-1.2.3.win32]
+ (b) zlib [http://www.zlatkovic.com/pub/libxml
+ version >= zlib-1.2.3.win32]
- * You might optionally need the following dlls
- - libxml2.dll [http://www.zlatkovic.com/pub/libxml - version >= libxml2-2.6.20.win32]
- - iconv.dll [http://www.zlatkovic.com/pub/libxml - version >= iconv-1.9.1.win32]
+ 2.1.2 Optional
+ --------------
+ (a) libxml2 [http://www.zlatkovic.com/pub/libxml
+ version >= libxml2-2.6.20.win32]
+ (b) iconv [http://www.zlatkovic.com/pub/libxml
+ version >= iconv-1.9.1.win32]
-3.2 Binaries in the release
----------------------------
+ 2.2 Using Binary Release
+ ------------------------
Extract the binary distribution to a folder of your choice.
(example: C:\axis2c)
@@ -192,203 +351,181 @@
|
+- services - deployed services
- Copy the downloaded zlib1.dll to C:\axis2c\lib
- You might optionally require to copy the libxml2.dll and iconv.dll as well
- (Or you can have these dll's some other place and add the location to PATH
- environment variable)
-
-
-3.3 Running the binaries
-------------------------
-
- You need to set a couple of environment variables before you can run the
- server and samples.
-
- Set the variable AXIS2C_HOME to the deploy folder (C:\axis2c)
- Add the path to lib directory to the PATH variable (%AXIS2C_HOME%\lib)
-
- Now everything is set to run the server!
-
- C:\axis2c\bin>axis2_http_server.exe
-
- You should see the message:
- Started Simple Axis2 HTTP Server...
-
- By default the log is 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\bin\samples>echo.exe
-
+ Copy the downloaded iconv.dll and zlib1.dll to C:\axis2c\lib
+ You might optionally require to copy the libxml2.dll as well
+ (Or you can have these dll's in some other place and add the
+ location to PATH environment variable)
+
+ 2.3 Using Source Release
+ ------------------------
-4. Getting Axis2/C working with the source release on Windows.
-============================================================
+ 2.3.1 Editing Configure.in File
+ -------------------------------
-4.1 Requirements
-----------------
+ (a) The iconv and zlib locations are specified by ICONV_BIN_DIR and
+ ZLIB_BIN_DIR respectively in the configure.in file.
- * The makefile shipped with this version needs Microsoft Visual Studio
- compiler (cl) and nmake build tool
+ Example:
+ Default location for zlib is E:\zlib-1.2.3.win32 and
+ the folder structure should look like the following.
+
+ E:\zlib-1.2.3.win32
+ |
+ +- include
+ |
+ +- bin
+ |
+ +- lib
+
+ You need to have zlib1.dll in a library path.
+
+ (b) In order to use the libxml2 xml parser set 'ENABLE_LIBXML2 = 1'.
+ This will require you specify the path to libxml2.
+
+ 2.3.2 Compiling the Source
+ --------------------------
+
+ Extract the source distribution to a folder of your choice.
+ Example:
+ C:\axis2c
+
+ Open a DOS shell and type:
+
+ > cd %AXIS2C_HOME%\build\win32
+ > vcvars32.bat
+ > nmake install
+
+ NOTE : You may need to set the PATH environment variable to vcvars32.bat
+ if Windows complains that it cannot find this bat file.
+
+ That's it! This will build the system and create a directory named 'deploy'
+ under the 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
+
+ 2.4 Running Samples
+ -------------------
- NOTE: You can download Microsoft VS Express2005 Edition and Platform SDK from
- Microsoft website. You will need to add the path to Platform SDK Include
- and Lib folders to the makefile.
-
- * You also need
- - zlib [http://www.zlatkovic.com/pub/libxml - download the version >= zlib-1.2.3.win32]
-
- * You might optionally need the following dlls (Only if you build with libxml2 xml parser)
- - libxml2.dll [http://www.zlatkovic.com/pub/libxml - version >= libxml2-2.6.20.win32]
- - iconv [http://www.zlatkovic.com/pub/libxml - download the version >= iconv-1.9.1.win32]
-
-4.2 Editing configure.in file
------------------------------
-
- The default places for iconv and zlib are specified in configure.in.
-
- Example:
- Default location for zlib is C:\zlib
- You can either extract zlib to this folder. Folder structure should
- look like the following.
- C:\zlib
- |
- +- 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.
-
- In order to use the Libxml2 xml parser set 'ENABLE_LIBXML2 = 1'. This will
- require you specifying the path to libxml2.
-
-4.3 Compiling the source
-------------------------
-
- Extract the source distribution to a folder of your choice.
- (Example: C:\axis2c)
- Open a DOS shell and type:
- cd C:\axis2c\build\win32
- C:\axis2c\build\win32>vcvars32.bat
- to access .Net tools
- (Note: You may need to set the PATH environment
- variable to vcvars32.bat if Windows complains
- that it cannot find this bat)
- C:\axis2c\build\win32>nmake install
-
- That's it! This will build the system and create a directory named 'deploy'
- under the 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
-
-4.4 Running the binaries
-------------------------
+ You need to set a couple of environment variables before you can run the
+ server and samples.
- You need to set a couple of environment variables before you can run the
- server and samples.
-
- Set the variable AXIS2C_HOME to the deploy folder (C:\axis2c\build\deploy)
+ Set the variable AXIS2C_HOME to the deploy folder (C:\axis2c)
Add the path to lib directory to the PATH variable (%AXIS2C_HOME%\lib)
- Copy iconv.dll and zlib1.dll to the Axis2/C lib folder
- (%AXIS2C_HOME%\lib)
-
- You might optionally require to copy the libxml2.dll to the Axis2/C 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...
-
- By default, the log is 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)
+ Copy iconv.dll and zlib1.dll to the %AXIS2C_HOME%\lib folder.
- Now you can run any sample client deployed under %AXIS2C_HOME%\bin\samples\
- Example:
- C:\axis2c\build\deploy\bin\samples>echo.exe
+ You might optionally require to copy the libxml2.dll to
+ the %AXIS2C_HOME%\lib folder.
+ 2.4.1 HTTP transport
+ --------------------
+
+ (a) Server
+ ----------
-5. Installing Apache2 Web Server integration module (mod_axis2)
----------------------------------------------------------------
+ > cd %AXIS2C_HOME%\bin
+ > axis2_http_server.exe
-5.1 Building mod_axis2 from the source tree
+ You should see the message
+ Started Simple Axis2 HTTP Server...
-5.1.1 On the Linux Platform
+ By default the log is created under %AXIS2C_HOME%\logs folder with the
+ name axis2.log.
- Provide the Apache2 include file location as a configure option
- ./configure --with-apache2="<apache2 httpd include files location>" [other configure options]
+ NOTE : You may provide command line options to change the default behaviour.
+ Type 'axis2_http_server.exe -h' to learn about the usage
+
+ (b) Clients
+ -----------
- NOTE: Some apache2 distributions install APR (Apache Portable Run-time)
- include files in a separate location which is required to build mod_axis2.
- In that case use:
- ./configure --with-apache2="<apache2 directornclude files location>>"
- --with-apr="<apr include files location>" [other configure options]
+ Now you can run any sample client deployed under %AXIS2C_HOME%\bin\samples\
+
+ Example:
+ > cd %AXIS2C_HOME%\bin\samples
+ > echo.exe
- Then build the source tree
- make
- make install
- This will install mod_axis2.so into your "<your_path_to_axis2c>/lib"
-
-5. 1.4.0 On Win32 platform
-
- Provide the apache2 location in configure.in file in APACHE_INSTALL_DIR
- Example:
- APACHE_INSTALL_DIR = E:\Apache
+3. Installing Apache2 Web Server Integration Module (mod_axis2)
+===============================================================
+
+ 3.1 Building mod_axis2 from Source
+ ----------------------------------
+
+ 3.1.1 On Linux
+ --------------
+
+ Provide the Apache2 include file location as a configure option
+
+ $ ./configure --with-apache2="<apache2 httpd include files location>"
+ [other configure options]
+
+ NOTE : Some apache2 distributions install APR (Apache Portable Runtime)
+ include files in a separate location which is required to build
+ mod_axis2.
+
+ In that case use:
+ $ ./configure --with-apache2="<apache2 include files location>"
+ --with-apr="<apr include files location>"
+ [other configure options]
- After compiling the sources (as described in section 4.3) build the
- mod_axis2.dll by issuing the command 'nmake axis2_apache_module'.
- This will build mod_axis2.dll and copy it to %AXIS2C_HOME%\lib directory.
- Example:
- C:\axis2c\build\deploy\lib
+ Then build the source tree
+
+ $ make
+ $ make install
-5.2 Deploying in Apache2 Web Server
+ This will install mod_axis2.so into your "<your_path_to_axis2c>/lib"
- NOTE: To do the following tasks, you might need super user privileges in your
- machine.
+ 3.1.2 On Windows (Win32)
+ ------------------------
+
+ Provide the apache2 location in configure.in file in APACHE_INSTALL_DIR
+
+ Example:
+ APACHE_INSTALL_DIR = E:\Apache
+
+ After compiling the sources (as described in section 2.3) build the
+ mod_axis2.dll by issuing the command 'nmake axis2_apache_module'.
+ This will build mod_axis2.dll and copy it to %AXIS2C_HOME%\lib directory.
+
+ Example:
+ C:\axis2c\build\deploy\lib
+
+ 3.2 Deploying in Apache2 Web Server
+ -----------------------------------
- Copy the mod_axis2 (libmod_axis2.so.0.3.1 on Linux and mod_axis2.dll
- in Windows) to "<apache2 modules directory>" as mod_axis2.so
- Example:
- cp $AXIS2C_HOME/lib/libmod_axis2.so.0.3.1 /usr/lib/apache2/modules/mod_axis2.so
- in Linux or
+ NOTE : To do the following tasks, you might need super user privileges
+ on your machine.
- copy C:\axis2c\build\deploy\lib\mod_axis2.dll C:\Apache2\modules\mod_axis2.so
- in Windows
+ Copy the mod_axis2 (libmod_axis2.so.0.3.1 on Linux and mod_axis2.dll
+ on Windows) to "<apache2 modules directory>" as mod_axis2.so
+
+ Example:
+ cp $AXIS2C_HOME/lib/libmod_axis2.so.0.3.1
+ /usr/lib/apache2/modules/mod_axis2.so (on Linux)
+
+ copy C:\axis2c\build\deploy\lib\mod_axis2.dll
+ C:\Apache2\modules\mod_axis2.so (on Windows)
- Edit the Apache2's configuration file (generally httpd.conf) and add the
- following directives
+ Edit the Apache2's configuration file (generally httpd.conf) and add the
+ following directives
LoadModule axis2_module <apache2 modules directory>/mod_axis2.so
Axis2RepoPath <axis2 repository path>
@@ -399,20 +536,21 @@
SetHandler axis2_module
</Location>
- NOTE: Axis2 log file path should have write access to all users because by
- default Apache Web Server runs as nobody.
- NOTE: If you want to use a Shared Global Pool with Apache you have to give
- another entry called Axis2GlobalPoolSize.You have to give the size of
- the shared global pool in MB.If you doesn't set the value or if you
+ NOTE: Axis2 log file path should have write access to all users because by
+ default Apache Web Server runs as nobody.
+
+ If you want to use a Shared Global Pool with Apache you have to give
+ another entry called Axis2GlobalPoolSize. You have to give the size of
+ the shared global pool in MB. If you don't set the value or if you
set a negative value Apache module doesn't create shared global pool.
Axis2GlobalPoolSize <global pool size in MB>
- LOG_LEVEL can be one of following
- crit - Log critical errors only
+ LOG_LEVEL can be one of the followings
+ crit - Log critical errors only
error - Log errors critical errors
- warn - Log warnings and above
- info - Log info and above
+ warn - Log warnings and above
+ info - Log info and above
debug - Log debug and above (default)
trace - Log trace messages
@@ -424,38 +562,42 @@
- Read permission to the repository
- Write permission to the log file
- Restart apache2 and test whether mod_axis2 module is loaded by typing the URL
- http://localhost/axis2/services
+ Restart apache2 and test whether mod_axis2 module is loaded by typing the
+ URL http://localhost/axis2/services in your Web browser
-
-6. Installing IIS (Interner Information Server) integration module (mod_axis2_IIS)
-----------------------------------------------------------------------------------
-
-6.1 Building mod_axis2_IIS from the source tree
-
- After compiling the sources (as described in section 4.3) build the
+4. Installing IIS (Interner Information Server) Integration Module
+ (mod_axis2_IIS)
+==================================================================
+
+ 4.1 Building mod_axis2_IIS from Source
+ --------------------------------------
+
+ After compiling the source (as described in section 2.3) build the
mod_axis2.dll by issuing the command 'nmake axis2_IIS_module'.
This will build the mod_axis2_IIS.dll and copy it to %AXIS2C_HOME%\lib
directory.
- Example:
- C:\axis2c\build\deploy\lib
-
-6.2 Deploying in the IIS
+ Example:
+ C:\axis2c\build\deploy\lib
+
+ 4.2 Deploying in the IIS
+ ------------------------
+
Add the following key to the registery.
HKEY_LOCAL_MACHINE\SOFTWARE\Apache Axis2c\IIS ISAPI Redirector
Under this registry key add the following entries.
- Add a string value with the name axis2c_home and a value of the axis2c home
- path
- Example: c:\axis2c
- Add a string value with the name log_file and a value of absolute path of
- the log file
+ A String value with the name "axis2c_home". The value is the AXIS2C_HOME.
+ Example : c:\axis2c
+
+ A String value with the name "log_file". The value is the absolute path of
+ the log file.
Example: c:\axis2c\logs\axis2.log
- Add a string value with the name log_level. The value can be one of the
- following
+
+ A String value with the name "log_level". The value can be one of the
+ followings.
trace - Log trace messages
error - Log errors critical errors
info - Log info and above
@@ -464,7 +606,7 @@
warning - Log warnings
Using the IIS management console, add a new virtual directory to the
- IIS/PWS web site called "axis2" The physical path of this virtual
+ IIS/PWS web site called "axis2". The physical path of this virtual
directory should be the axis2\lib directory (Where the mod_axis2_IIS.dll
is in)
Assign excecute permissions to this virtual directory.
@@ -473,66 +615,63 @@
IIS/PWS web site. The name of the filter can be any meaningful name.
Restart IIS and test whether mod_axis2_IIS module is loaded by typing the
- URL http://localhost/axis2.
- Enjoy Axis2/C!
+ URL http://localhost/axis2 in your Web browser.
-FAQ
-===
+5. FAQ
+======
1. Although I was able to get simple axis server up, unable to run samples.
- This could happen because the AXIS2C_HOME environment variable is not
- set to the correct axis2 installation path.
-
+ This could happen because the AXIS2C_HOME environment variable is not
+ set to the correct axis2 installation path.
2. What are the other dependencies Axis2/C has?
-
- Basically if you are willing to use libxml2 as your parser, you need to
- have it installed on your system.
- libxml2 - http://xmlsoft.org/downloads.html
-3. I installed libxml2 installed in my system, but ./configure fails saying
- "libxml2 not found"
+ Basically if you are willing to use libxml2 as your parser, you need to
+ have it installed in your system.
+
+ You can get libxml2 from http://xmlsoft.org/downloads.html.
- Yes, you need to install libxml2-dev packages.
-
- 1. If you are using a debian based system
- apt-get install libxml2-dev
- 2. If you are using redhat/fedora based system.
- yum install libxml2-dev
- 3. If you compile libxml2 from source you will not get this error.
-
-4. Is there any recommended packages, that I need to instal in my system?
-
- 1. automake, autoconf, libtool, aclocal
- 2. libxml2 and libxml2-dev
- 5. pkg-config
+3. I have libxml2 installed in my system, but ./configure fails saying
+ "libxml2 not found"
+
+ Yes, you need to install libxml2-dev packages.
+
+ 1. If you are using a Debian based system run
+ $ apt-get install libxml2-dev
+
+ 2. If you are using a RedHat/Fedora based system run
+ $ yum install libxml2-dev
+
+ 3. If you install libxml2 from source you will not get this error
+
+4. Is there any recommended packages, that I need to install in my system?
+
+ 1. automake, autoconf, libtool, aclocal
+ 2. libxml2 and libxml2-dev
+ 3. pkg-config
5. I tried several methods, browse through axis-c-dev and axis-c-user mail
- archives but I was not able solve it.
-
- Then you can ask from Axis2/C users or Axis2/C developers about it by
- sending your question to
- user = axis-c-user@ws.apache.org
- developer = axis-c-dev@ws.apache.org
-
- You can get subscribe to
-
- axis-c-user list by sending request to
- <ax...@ws.apache.org>
-
- axis-c-dev list by sending request to
- <ax...@ws.apache.org>
-
- subject of the request should be "subscribe"
+ archives but I was not able to solve my problem.
+
+ Then you can ask from Axis2/C users or Axis2/C developers about it by
+ sending your question to
+
+ user = axis-c-user@ws.apache.org
+ developer = axis-c-dev@ws.apache.org
+ You can subscribe to
+
+ axis-c-user list by sending a request to
+ <ax...@ws.apache.org> with the subject "subscribe"
+
+ axis-c-dev list by sending request to
+ <ax...@ws.apache.org> with the subject "subscribe"
6. This FAQ is not enough...
-
- You can help us by reporting your suggestions, complaints, problems and bugs
-
+ You can help us by reporting your suggestions, complaints, problems and bugs
Thank you for using Axis2/C ...
Modified: webservices/axis2/trunk/c/NEWS
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/c/NEWS?rev=666539&r1=666538&r2=666539&view=diff
==============================================================================
--- webservices/axis2/trunk/c/NEWS (original)
+++ webservices/axis2/trunk/c/NEWS Tue Jun 10 23:17:32 2008
@@ -1,13 +1,18 @@
-Apache Axis2/C Team is pleased to announce the release of Apache Axis2/C version 1.4.0
-You can download this release from
+Apache Axis2/C Team is pleased to announce the release of Apache Axis2/C
+version 1.4.0.
-http://ws.apache.org/axis2/c/download.cgi
+You can download this release from http://ws.apache.org/axis2/c/download.cgi
Key Features
+============
- 1. Support for one-way messaging (In-Only) and request response messaging (In-Out)
- 2. Client APIs: Easy to use service client API and more advanced operation client API
- 3. Transports supported: HTTP
+ 1. Support for one-way messaging (In-Only) and
+ request response messaging (In-Out)
+
+ 2. Client APIs : Easy to use service client API and
+ more advanced operation client API
+
+ 3. Transports supported : HTTP
* Inbuilt HTTP server called simple axis server
* Apache2 httpd module called mod_axis2 for server side
* IIS module for server side
@@ -16,57 +21,60 @@
* Digest HTTP Authentication
* libcurl based client transport
- 4. Transports supported: HTTPS
+ 4. Transports supported : HTTPS
* HTTPS Transport implementation using OpenSSL
- 5. Transports supported: TCP
+ 5. Transports supported : TCP
* for both client and server side
- 6. Transport proxy support (HTTP)
+ 6. Transports supported : AMQP
+ * AMQP Transport implementation using Apache Qpid
+
+ 7. Transport proxy support (HTTP)
* Proxy Authentication (Basic/Digest)
- 7. Module architecture, mechanism to extend the SOAP processing model.
+ 8. Module architecture, mechanism to extend the SOAP processing model.
- 8. WS-Addressing support, both the submission (2004/08) and final (2005/08) versions,
- implemented as a module.
+ 9. WS-Addressing support, both the submission (2004/08) and
+ final (2005/08) versions, implemented as a module.
- 9. MTOM/XOP support.
+ 10. MTOM/XOP support.
- 10. AXIOM, an XML object model optimized for SOAP 1.1/1.2 messages;
+ 11. AXIOM, an XML object model optimized for SOAP 1.1/1.2 messages;
This has complete XML infoset support.
- 11. XML parser abstraction
+ 12. XML parser abstraction
* Libxml2 wrapper
* Guththila pull parser support
- 12. Both directory based and archive based deployment models for deploying
+ 13. Both directory based and archive based deployment models for deploying
services and modules
- 13. Description hierarchy providing access to static data of
- Axis2/C runtime (configuration, service groups, services, operations and messages)
+ 14. Description hierarchy providing access to static data of Axis2/C runtime
+ (configuration, service groups, services, operations and messages)
- 14. Context hierarchy providing access to dynamic
- Axis2/C runtime information (corresponding contexts to map to each level of
- description hierarchy)
+ 15. Context hierarchy providing access to dynamic
+ Axis2/C runtime information (corresponding contexts to map to
+ each level of description hierarchy)
- 15. Message receiver abstraction
+ 16. Message receiver abstraction
* Inbuilt raw XML message receiver
- 16. Code generation tool for stub and skeleton generation for a given
+ 17. Code generation tool for stub and skeleton generation for a given
WSDL (based on Java tool)
* Axis Data Binding (ADB) support
- 17. REST support (more POX like) using HTTP POST, GET, HEAD, PUT and DELETE
+ 18. REST support (more POX like) using HTTP POST, GET, HEAD, PUT and DELETE
* Support for RESTful Services
- 18. Comprehensive documentation
+ 19. Comprehensive documentation
* Axis2/C Manual
- 19. WS-Policy implementation called Neethi/C, with WS-SecurityPolicy extension
+ 20. WS-Policy implementation called Neethi/C, with WS-SecurityPolicy extension
-Major Changes Since Last Release.
---------------------------------
+Major Changes Since Last Release
+================================
1. Fixed library version numbering
2. Made Guththila as default XML parser
@@ -74,7 +82,9 @@
4. Memory leak fixes
We welcome your early feedback on this implementation.
-Thanks for your interest in Axis2/C
+
+Thanks for your interest in Axis2/C !!!
-- Apache Axis2/C Team --
+