INSTALL - axis-axis2-c-core - Git at Google

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