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 :) |