This document guides you on how to install Axis2/C, and run the server and client samples on Linux and Microsoft Windows operating systems.
This release comes in two forms, source and binary. This document covers both forms.
Please send your feedback to the developer mailing list: axis-c-dev@ws.apache.org (Subscription details are available on the Axis2 site.) Please remember to prefix the subject with [Axis2].
This can be done using binary or source distributions. (Download the two distributions)
To get both the binary and source distributions working, you need Libxml2.
Note: Most Linux systems have Libxml2 installed by default. On MS Windows, you need to download and install Libxml2.
The following steps have to be followed to install and run the Axis2/C binary distribution on Linux :
AXIS2C_HOME='/your_path_to_axis2c'
export AXIS2C_HOME
Note: You will need to set the AXIS2C_HOME only if you need to run the Axis2/C samples. The reason is that the samples use AXIS2C_HOME to get the path to the Axis2/C repository. This is not required to write your own services or clients.
cd /your_path_to_axis2c/bin
./axis2_http_server
./axis2_http_server -h
Note: If you run into shared library problems, try setting the LD_LIBRARY_PATH to include the lib folder containing the Axis2/C libs.
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
export LD_LIBRARY_PATH
cd /your_path_to_axis2c/bin/samples
./echo
./math
Note: If you run into shared library problems, try setting the LD_LIBRARY_PATH
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib
export LD_LIBRARY_PATH
The following steps have to be followed to install and run Axis2/C using the source distribution on Linux :
AXIS2C_HOME='/your_desired_path_to_axis2c_installation'
export AXIS2C_HOME
Note: You will have to set AXIS2C_HOME only if you want to run the Axis2/C samples. The reason is that the samples use AXIS2C_HOME to get the path to the Axis2/C repository. This is not required to write your own services or clients.
cd /your_path_to_axis2c_source
./configure
make
make install
./configure --help
for possible command line options.--prefix
configure
option, the default installation would be in the /usr/local/axis2c
directory.--enable-guththila=yes
option when configuring.
./configure --enable-guththila=yes
[other configuration
options]make
make install
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path_you_installed_axis2c/lib/
export LD_LIBRARY_PATH
cd samples
./configure --prefix=${AXIS2C_HOME}
--with-axis2=${AXIS2C_HOME}/include/axis2-1.2
make
make install
./configure --help
in the samples folder for more
information on the configure options.--prefix
configure
option, by default, the samples will be installed into the
"/usr/local/axis2c/bin/samples" directory.cd /path_you_installed_axis2c/bin
./axis2_http_server
./axis2_http_server
-h
cd /path_you_installed_axis2c/bin/samples
./echo
./math
This too can be done using binary or source distributions. (Download the two distributions.)
For both binary and source distributions, you have to download Libxml2, if you are not using Guththila parser which comes with the distribution.
(Note: you can download the Microsoft VSExpress2005 edition from the Microsoft Web site and install it to run these binaries.)
The above folders contain the following files:
C:\axis2c\bin\>axis2_http_server.exe
axis2_http_server.exe -h
to learn
about the usage)(Note: You can download the Microsoft VSExpress2005 edition and Platform SDK from the Microsoft Web site. You will need to add the path to the Platform SDK Include and Lib folders to the makefile)
Please edit the <source_distribution>\build\win32\configure.in file to include the following information.
The paths for the following required external libraries are specified in configure.in. Please note that you need to specify the path to the extracted folder.
The default paths for these external libraries are already specified in configure.in file.
Example: If zlib is installed into C:\zlib, edit the
configure.in file accordingly.
You can either extract zlib to this folder, in which case the folder
structure for C:\zlib should look like the following:
Else, extract it to a location of your choice and edit the configure.in
file accordingly.
If you need the parser to use Guththila XML parser, set the
ENABLE_GUTHTHILA option to 1 in configure.in
file.
Example: ENABLE_GUTHTHILA = 1
Other options available:
If you want to enable SSL client support, set ENABLE_SSL to 1 and set the path where OpenSSL is installed to OPENSSL_BIN_DIR.
If you want to enable libcurl based client transport, set ENABLE_LIBCURL to 1 and set the path where libcurl is installed to LIBCURL_BIN_DIR.
The following steps will take you through the source compilation.
cd C:\axis2c\build\win32
(Note: You may have to set the PATH environment variable to vcvars32.bat if MS Windows gives an error indicating that it cannot find this batch file. This file is located in <your MS Visual Studio install Directory>\VC\bin directory.)
The above folders contain the following files:
Please note that nmake install
does not build the apache or the IIS module. Refer to Axis2/C manual to see how to install these modules.