Hi all,
I have updated the INSTALL and NEWS files and the installation guide for
0.94 release.
Patch is attached herewith.
Thank you,
Dumindu.
Index: xdocs/docs/installationguide.html
===================================================================
--- xdocs/docs/installationguide.html (revision 452316)
+++ xdocs/docs/installationguide.html (working copy)
@@ -6,13 +6,12 @@
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<title>Axis2-C Installation Guide</title>
- <meta name="generator" content="amaya 9.4, see http://www.w3.org/Amaya/"; />
+ <meta name="generator" content="amaya 9.51, see http://www.w3.org/Amaya/"; />
</head>
<body xml:lang="en">
<h1>Axis2/C Installation Guide</h1>
-
<p>This document will guide you on how to install Axis2/C and run the server
and client samples on Linux and Microsoft Windows operating systems.</p>
@@ -51,48 +50,50 @@
</li>
</ul>
</li>
- <li><a href="#installing-apache2">Installing Apache2 Web Server integration
module
- (mod_axis2)</a>
+ <li><a href="#installing-apache2">Installing Apache2 Web Server integration
+ module (mod_axis2)</a>
<ul>
- <li><a href="#building-apache2">Building mod_axis2 from source
tree</a></li>
- <li><a href="#deploying-apache2">Deploying in Apache2 Web Server</a></li>
+ <li><a href="#building-apache2">Building mod_axis2 from source
+ tree</a></li>
+ <li><a href="#deploying-apache2">Deploying in Apache2 Web
+ Server</a></li>
</ul>
</li>
</ul>
-<p><a></a></p>
+<a id="linux"></a>
+<h2>1. Installing and running on Linux</h2>
-<h2>Installing and running on Linux</h2>
-
<p>This can be done using binary or source distributions</p>
<p>To get both the binary and source distributions working, you need libxml2,
which can be downloaded from <a
href="http://xmlsoft.org/downloads.html";>here</a>.</p>
-<p>(NOTE: most Linux systems has libxml2 by default.)</p>
-<a></a>
+<p><b>NOTE:</b> Most Linux systems have libxml2 installed by default. On
+Windows you need to download and install libxml2.</p>
-<h3>1. Using binary release</h3>
+<a id="linux_binary"></a>
+<h3>1.1. Using binary release</h3>
<p>The following steps need to be taken to install and run Axis2/C using
binary distribution on Linux</p>
-
-<h4>1. Extract the binary tar package to a folder.</h4>
+<ol>
+<li>Extract the binary tar package to a folder.</li>
+<li>Set AXIS2C_HOME environment variable pointing to the location where you
+ have extracted Axis2C</li>
<ul>
- <li>Set AXIS2C_HOME environment variable pointing to the location where you
- have extracted Axis2C</li>
<li>AXIS2C_HOME='/your_path_to_axis2c'</li>
- <li>export AXIS2C_HOME
- <p>Note: You will need to set AXIS2C_HOME only if you need to run axis2c
- samples or tests. The reason is</p>
- <p>that the samples and tests use the AXIS2C_HOME envioronment variable
- to locate the repository path. To write your own</p>
- <p>services or clients this would not be neccessary.</p>
- </li>
+ <li>export AXIS2C_HOME</li>
+ <br />
+
+ <li><strong>NOTE:</strong> You will need to set AXIS2C_HOME only if you
+ need to run Axis2C samples or tests. The reason is that the samples and
+ test codes use AXIS2C_HOME to get the path to Axis2C. To write your own
+ services or clients this is not a requirement.</li>
</ul>
-<h4>2. Run the simple axis server:</h4>
+<li>Run the simple axis server:</li>
<ul>
<li>To start the simple axis server on default port 9090, run the following
commands.
@@ -102,8 +103,10 @@
</ul>
</li>
<li>To see the possible command line options run ./axis2_http_server -h</li>
- <li>NOTE: If you run into shared lib problems, try setting the
- LD_LIBRARY_PATH
+ <br />
+
+ <li><strong>NOTE:</strong> If you run into shared lib problems, try setting
+ the LD_LIBRARY_PATH
<ul>
<li>export
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib</li>
@@ -111,7 +114,7 @@
</li>
</ul>
-<h4>3. Run the sample clients in a new shell</h4>
+<li>Run the sample clients in a new shell</li>
<ul>
<li>cd /your_path_to_axis2c/bin/samples</li>
<li>to run client for echo service
@@ -126,15 +129,18 @@
</li>
<li>To see the possible command line options for sample clients run them
with '-h' option</li>
- <li>NOTE: If you run into shared lib problems, try setting the
- LD_LIBRARY_PATH
+ <br />
+
+ <li><strong>NOTE:</strong> If you run into shared lib problems, try setting
+ the LD_LIBRARY_PATH
<ul>
<li>export
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib</li>
</ul>
</li>
</ul>
-<a></a>
+</ol>
+<ai id="linux_source"></a>
<h3>2. Using source release</h3>
@@ -147,6 +153,12 @@
<ul>
<li>AXIS2C_HOME='/your_desired_path_to_axis2c_installation'</li>
<li>export AXIS2C_HOME</li>
+ <br />
+
+ <li><strong>NOTE:</strong> You will need to set AXIS2C_HOME only if you
+ need to run Axis2C samples or tests. The reason is that the samples
+ and test codes use AXIS2C_HOME to get the path to Axis2C. To write
+ your own services or clients this is not a requirement.</li>
</ul>
</li>
<li>Then go to the folder where you extracted the source
@@ -156,35 +168,46 @@
</li>
<li>Build the source
<ul>
- <li>This can be done using the following command sequence:
+ <li>This can be done using the following command sequence in the
+ directory where you have extracted the source:
<ul>
- <li>./configure</li>
+ <li>./configure --prefix=${AXIS2C_HOME}</li>
<li>make</li>
<li>make install</li>
</ul>
</li>
<li>use './configure --help' for possible command line options.</li>
- <li>NOTE: If you don't provide a --prefix configure option, it will by
- defaul install into /usr/local/axis2c folder.</li>
- <li>You may also need to set LD_LIBRARY_PATH to include the
- install locations.</li>
- <li> You may need to try axis2c with guththila xml parser. You
- can do it by giving --enable-guththila=yes</li>
- <ul>
- <li> ./configure --enable-guththila=yes [other configuration
options]</li>
- <li>make</li>
- <li> make install</li>
- </ul>
+ <li><strong>NOTE:</strong> If you don't provide a --prefix configure
+ option, it will by defaul be installed into /usr/local/axis2c
+ directory.</li>
+ <li>You may need to try axis2c with guththila xml parser. You can do it
+ by giving --enable-guththila=yes
+ <ul>
+ <li>./configure --enable-guththila=yes [other configuration
+ options]</li>
+ <li>make</li>
+ <li>make install</li>
+ </ul>
+ </li>
<li>If you need to get the samples working, you also need to build the
samples.
- <p>To build samples:</p>
+ <br />To build the samples:
<ul>
+ <li>export
+ LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/axis2c/lib/</li>
<li>cd samples</li>
<li>./configure --prefix=${AXIS2C_HOME}</li>
+ <li>--with-axis2_util=${AXIS2C_HOME}/include</li>
+ <li>--with-axiom=${AXIS2C_HOME}/include</li>
<li>make</li>
- <li>make install</li>
+ <li>sudo make install</li>
</ul>
</li>
+ <li>Please run "./configure --help" in samples folder for more
+ information on configure options.</li>
+ <li><strong>NOTE:</strong> If you don't provide a --prefix configure
+ option, samples will by default be installed into
+ "/usr/local/axis2c/samples" directory.</li>
</ul>
</li>
<li>Go to where you installed axis2c.</li>
@@ -193,17 +216,19 @@
<li>To start the simple axis server on port 9090 run the following
command lines
<ul>
- <li>cd axis2c/bin</li>
+ <li>cd ${AXIS2C_HOME}/bin</li>
<li>./axis2_http_server</li>
</ul>
</li>
<li>To see the possible command line options run ./axis2_http_server
-h</li>
+ <li> <strong>NOTE:</strong> You may need to be login as superuser to
+ run the simple axis server.</li>
</ul>
</li>
<li>Run the sample clients in a new shell using the following command lines
<ul>
- <li>cd bin/samples</li>
+ <li>cd ${AXIS2C_HOME}/bin/samples</li>
<li>to run client for echo service
<ul>
<li>./echo</li>
@@ -219,8 +244,8 @@
</ul>
</li>
</ol>
-<a></a>
+<a id="win"></a>
<h2>Installing and running on Microsoft Windows (win32)</h2>
<p>This too can be done using either binary or source distributions</p>
@@ -230,10 +255,10 @@
<p>(NOTE: most Linux systems has libxml2 by default. On Windows you need to
download and install libxml2)</p>
-<a></a>
+<a id="win_binary"></a>
<h3>1. Using binary release</h3>
-<a></a>
+<a id="bin_req"></a>
<h4>Requirements</h4>
<ul>
@@ -253,7 +278,7 @@
</ul>
</li>
</ul>
-<a></a>
+<a id="bin_binaries"></a>
<h4>Binaries in the release</h4>
<ul>
@@ -277,7 +302,7 @@
<li>Copy libxml2.dll, iconv.dll and zlib1.dll downloaded to
C:\axis2c\lib</li>
</ul>
-<a></a>
+<a id="bin_run"></a>
<h4>Running the binaries</h4>
<ul>
@@ -304,10 +329,10 @@
</ul>
</li>
</ul>
-<a></a>
+<a id="win_source"></a>
<h3>2. Using the source release.</h3>
-<a></a>
+<a id="src_req"></a>
<h4>Requirements</h4>
<ul>
@@ -328,7 +353,7 @@
</ul>
</li>
</ul>
-<a></a>
+<a id="edit"></a>
<h4>Editing configure.in file</h4>
<ul>
@@ -348,7 +373,7 @@
<li>You need to have zlib1.dll in a library path. You may copy this dll to
libxml2/lib.</li>
</ul>
-<a></a>
+<a id="src_compile"></a>
<h4>Compiling the source.</h4>
@@ -387,7 +412,7 @@
<li>logs - system and client logs are written to this folder</li>
</ul>
</ul>
-<a></a>
+<a id="src_run"></a>
<h4>Running the binaries</h4>
<ul>
@@ -418,9 +443,10 @@
</ul>
</li>
</ul>
-<a id="installing-apache2"/>
-<h3> 3. Installing Apache2 Web Server integration module (mod_axis2).</h3>
+<a id="installing-apache2"></a>
+<h3>3. Installing Apache2 Web Server integration module (mod_axis2).</h3>
+<a id="building-apache2"></a>
<h4>3.1 Building mod_axis2 from source tree</h4>
<h4>3.1.1 On Linux Platform</h4>
@@ -452,7 +478,7 @@
directory.<br />
eg: C:\axis2c\build\deploy\lib</li>
</ul>
-
+<a id="deploying-apache2"></a>
<h4>3.2 Deploying in Apache2 Web Server</h4>
<p><b>Note: To do the following tasks you might need super user privileges in
Index: INSTALL
===================================================================
--- INSTALL (revision 452316)
+++ INSTALL (working copy)
@@ -1,46 +1,54 @@
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 have libxml2 by default. On Windows you need to
download and install libxml2)
+To get both the binary and source distributions working, you need libxml2 from
+http://xmlsoft.org/downloads.html
+NOTE: Most Linux systems have libxml2 installed by default. On Windows you need
+ to download and install libxml2.
+
Table of Contents
=================
1. Getting Axis2C working with the binary release on Linux
2. Getting Axis2C working with the source release on Linux
3. Getting Axis2C working with the binary release on Windows (win32)
- 3.1 Requirements
- 3.2 Binaries in the release
- 3.3 Running the binaries
-4. Getting Axis2c 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
+ 3.1 Requirements
+ 3.2 Binaries in the release
+ 3.3 Running the binaries
+4. Getting Axis2C 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 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
+1. Extract the binary tar package to a directory.
+
+2. Set AXIS2C_HOME environment variable pointing to the location where you have
+ extracted Axis2C
AXIS2C_HOME='/your_path_to_axis2c'
export AXIS2C_HOME
- Note: You will need to set AXIS2C_HOME only if you need to run axis2c
samples or tests. The
- reason is that the samples and test codes use AXIS2C_HOME to get the path
to axis2c. To write
- your own services or clients this is not a requirement.
-2. Run the simple axis server:
+ NOTE: You will need to set AXIS2C_HOME only if you need to run Axis2C
samples
+ or tests. The reason is that the samples and test codes use
AXIS2C_HOME
+ to get the path to Axis2C. To write your own services or clients this
is
+ not a requirement.
+
+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
+ 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
+4. Run the sample clients in a new shell
cd /your_path_to_axis2c/bin/samples
./echo
This will invoke the echo service.
@@ -48,7 +56,8 @@
./math
This will invoke the math service.
- To see the possible command line options for sample clients run them with
'-h' option
+ 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
@@ -57,67 +66,81 @@
2. Getting Axis2C working with the source release on Linux.
==========================================================
-1. Extract the source tar package to a folder.
+1. Extract the source tar package to a directory
-2. Set AXIS2C_HOME environment variable pointing to the location where you
want to install Axis2C.
+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
- 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
+ NOTE: You will need to set AXIS2C_HOME only if you need to run Axis2C
samples
+ or tests. The reason is that the samples and test codes use
AXIS2C_HOME
+ to get the path to Axis2C. To write your own services or clients this
is
+ not a requirement.
-3. Then go to the folder where you extracted the source
+3. Go to the directory where you extracted the source
cd /your_path_to_axis2c_source
4. Build the source
- This can be done by running the 'configure; make; make install' command
sequence in the
- AXIS2C_HOME directory
+ This can be done by running the following command sequence in the directory
+ where you have extracted the source.
- ./configure
- make
- make install
-
- Please run './configure --help' in respective sub folders for more
information on
- these configure options.
+ ./configure --prefix=${AXIS2C_HOME}
+ make
+ sudo make install
- You may also need to set LD_LIBRARY_PATH to include the install locations.
+ Please run './configure --help' in respective sub folders for more
information
+ on these configure options.
- NOTE: If you don't provide a --prefix configure option, it will by default
install into
- ==== /usr/local/axis2c folder.
+ NOTE: If you don't provide the --prefix configure option, it will by default
+ be installed into "/usr/local/axis2c" directory.
+ You may need to try Axis2C with guththila xml parser. You can do it by
giving
+ "--enable-guththila=yes" as a configure option.
+
+ ./configure --enable-guththila=yes [other configuration options]
+ make
+ sudo make install
- You may need to try Axis2c with guththila xml parser. You can do it by
giving --enable-guththila=yes
- ./configure --enable-guththila=yes [other configuration options]
- make
- make install
-
If you need to get the samples working, you also need to build the samples.
- Please run './configure --help' in samples folder for more information on
- configure options.
+
To build the samples:
+
+ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/axis2c/lib/
cd samples
- ./configure --prefix=${AXIS2C_HOME}
+ ./configure --prefix=${AXIS2C_HOME}
--with-axis2_util=${AXIS2C_HOME}/include
+ --with-axiom=${AXIS2C_HOME}/include
make
- make install
+ sudo make install
-5. Go to the folder where you installed axis2c.
+ Please run "./configure --help" in samples folder for more information on
+ configure options.
+ NOTE: If you don't provide a --prefix configure option, samples will by
default
+ be installed into "/usr/local/axis2c/samples" directory.
+
+5. Go to the folder where you installed Axis2C.
+
6. Start simple axis server
- cd axis2c/bin
+ cd ${AXIS2C_HOME}/bin
./axis2_http_server
- This will start the simple axis server on port 9090. To see the possible
command line options run:
+ This will start the simple axis server on port 9090. To see the possible
command
+ line options run:
./axis2_http_server -h
+ NOTE: You may need to be login as superuser to run the simple axis server.
+
8. Run the sample clients in a new shell
- cd bin/samples
+ 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.
+ To see the possible command line options for sample clients, run them with
+ '-h' option.
3. Getting Axis2C working with the binary release on Windows.
@@ -126,30 +149,34 @@
3.1 Requirements
----------------
- * The binaries shipped with this version are compiled with Microsoft
Visual Studio compiler (cl)
- (Note: you can download Microsoft VS Express2005 Edition from Microsoft
website and install it to run these binaries)
+ * The binaries shipped with this version are compiled with Microsoft Visual
+ Studio compiler (cl)
+ Note: You can download Microsoft VS Express2005 Edition from Microsoft
+ website and install 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]
+ - libxml2.dll [http://www.xmlsoft.org - version >=
libxml2-2.6.20.win32]
+ - iconv.dll [http://www.xmlsoft.org - version >= iconv-1.9.1.win32]
+ - zlib1.dll [http://www.xmlsoft.org - version >= zlib-1.2.3.win32]
3.2 Binaries in the release
---------------------------
- Extract the binary distribution to a folder of your choice. (example:
C:\axis2c-M0.4)
+ Extract the binary distribution to a folder of your choice.
+ (example: C:\axis2c-0.94)
- The c:\axis2c-M0.4 folder structure is as follows.
+ The c:\axis2c-0.94 folder structure is as follows.
axis2c-0.94
|
- +- bin - server and other executables
+ +- bin - server and other executables
| |
| +- samples - samples go here
| |
| +...
|
- +- lib - library modules
+ +- lib - library modules
|
+- services - deployed services
|
@@ -160,12 +187,13 @@
+- logs - system and client logs are written to this folder
- Copy the downloaded libxml2.dll, iconv.dll and zlib1.dll to
C:\axis2c-M0.4\lib
+ Copy the downloaded libxml2.dll, iconv.dll and zlib1.dll to
C:\axis2c-0.94\lib
3.3 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-0.94)
Add the path to lib directory to the PATH variable (%AXIS2C_HOME%\lib)
@@ -177,12 +205,15 @@
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)
+ 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-M0.4\bin\samples>echo.exe
+ C:\axis2c-0.94\bin\samples>echo.exe
4. Getting Axis2C working with the source release on Windows.
@@ -191,14 +222,17 @@
4.1 Requirements
----------------
- * The makefile 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 will
- need to add the path to Platform SDK Include and Lib folders to the
makefile)
+ * The makefile 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 will need to add the path to Platform SDK
Include
+ and Lib folders to the 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]
+ - 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]
4.2 Editing configure.in file
-----------------------------
@@ -207,16 +241,17 @@
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
+ You can either extract libxml2 to this folder. Folder structure should
+ look like the following.
+ C:\libxml2
|
- +- include
+ +- include
|
- +- bin
+ +- bin
|
- +- lib
+ +- lib
- Or extract to whatever place of your choice and edit the configure.in
accordingly.
+ 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.
@@ -226,25 +261,27 @@
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
environment
- PATH variable to vcvars32.bat
if Windows
- complains that it cannot find
this bat)
+ 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.
+ 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
+ +- bin - server and other executables
| |
| +- samples - samples go here
| |
| +...
|
- +- lib - library modules
+ +- lib - library modules
|
+- services - deployed services
|
@@ -257,12 +294,14 @@
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)
Add the path to lib directory to the PATH variable (%AXIS2C_HOME%\lib)
- Copy libxml2.dll, iconv.dll and zlib1.dll to the axis2c lib folder
(%AXIS2C_HOME%\lib)
+ Copy libxml2.dll, iconv.dll, and zlib1.dll to the Axis2C lib folder
+ (%AXIS2C_HOME%\lib)
Now everything is set to run the server!
@@ -271,8 +310,10 @@
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)
+ 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:
@@ -289,9 +330,11 @@
Provide the Apache2 include file location as a configure option
./configure --with-apache2="<apache2 directory>" [other configure
options]
- 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 directory>" --with-apr="<apr
include files location>" [other configure options]
+ 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 directory>"
+ --with-apr="<apr include files location>" [other configure options]
Then build the source tree
make
@@ -305,22 +348,29 @@
Example:
APACHE_INSTALL_DIR = E:\Apache
- After compiling the sources (as described in section 4.3) build the
mod_axis2.dll by issuing the command "nmake axis2_apache_module".
+ 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 the mod_axis2.dll and copy it to %AXIS2C_HOME%\lib
directory.
Example:
C:\axis2c\build\deploy\lib
5.2 Deploying in Apache2 Web Server
- NOTE: To do the following tasks, you might need super user privileges in
your machine.
+ NOTE: To do the following tasks, you might need super user privileges in
your
+ machine.
- Copy the mod_axis2 (libmod_axis2.so.0.0.0 on Linux and mod_axis2.dll in
Windows) to "<apache2 modules directory>" as mod_axis2.so
+ Copy the mod_axis2 (libmod_axis2.so.0.0.0 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.0.0
/usr/lib/apache2/modules/mod_axis2.so in Linux or
- copy C:\axis2c\build\deploy\lib\mod_axis2.dll
C:\Apache2\modules\mod_axis2.so in Windows
+ cp $AXIS2C_HOME/lib/libmod_axis2.so.0.0.0
/usr/lib/apache2/modules/mod_axis2.so
+ in Linux or
- Edit the Apache2's configuration file (generally httpd.conf) and add the
following directives
+ copy C:\axis2c\build\deploy\lib\mod_axis2.dll
C:\Apache2\modules\mod_axis2.so
+ in Windows
+ Edit the Apache2's configuration file (generally httpd.conf) and add the
+ following directives
+
LoadModule axis2_module <apache2 modules directory>/mod_axis2.so
<Location /axis2>
SetHandler axis2_module
@@ -329,7 +379,8 @@
Axis2LogLevel LOG_LEVEL
</Location>
- NOTE: Axis2 log file path should have write access to all users because by
default Apache Web Server runs as nobody.
+ NOTE: Axis2 log file path should have write access to all users because by
+ default Apache Web Server runs as nobody.
LOG_LEVEL can be one of following
AXIS2_LOG_LEVEL_CRITICAL - Log critical errors only
@@ -339,7 +390,8 @@
AXIS2_LOG_LEVEL_DEBUG - Log debug and above (default)
AXIS2_LOG_LEVEL_TRACE - Log trace messages
- NOTE: Use forward slashes "/" for path separators in <apache2 modules
directory>, <axis2 repository path> and <axis2 log file path>
+ NOTE: Use forward slashes "/" for path separators in <apache2 modules
directory>,
+ <axis2 repository path> and <axis2 log file path>
Make sure that the apache2 user has the correct permissions to above paths
- Read permission to the repository
@@ -357,63 +409,66 @@
FAQ
=======
-1. Although I was able to get simple axis server up, unable to run samples ?
+1. Although I was able to get simple axis server up, unable to run samples.
- This could happen because of wrong location of AXIS2C_HOME
+ This could happen because the AXIS2C_HOME environment variable is not
+ set to the correct axis2 installation path.
-2. What are the other dependencies Axis2c has ?
+2. What are the other dependencies Axis2C has?
- Basically if you are willing to use libxml2 as your parser, you need
to have it installed on your system.
-and rampart (security module of axis2c) has dependency on openssl.
+ Basically if you are willing to use libxml2 as your parser, you need to
+ have it installed on your system. and rampart (security module of
Axis2C)
+ has dependency on openssl.
libxml2 - http://xmlsoft.org/downloads.html
-3. I installed libxml2 installed in my system, but ./configure fails saying
"libxml2 not found"
+3. I installed 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 debian based system
- apt-get install libxml2-dev
- 2. If you are using redhat based system.
- yum install libxml2-dev
- 3. If you compile libxml2 from source this you will not get
this error.
+
+ 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. I installed openssl in my system but , I'm getting an error while
configuring rampart ?
+4. I installed openssl in my system but, I'm getting an error while configuring
+ rampart?
- You might need to get installed "libssl-dev"
+ You might need to get "libssl-dev" package installed.
-5. Is there any recommended packages ,that I need to installed in my system ?
+5. Is there any recommended packages, that I need to instal in my system?
- 1. automake, autoconf , libtool, aclocal
- 2. libxml2 and libxml2-dev
- 3. openssl
- 4. libssl-dev
- 5. pkg-config
-
-6. I tried several methods, browse through axis-c-dev and axis-c-user mail
archives but I' was unable solve it ?
+ 1. automake, autoconf, libtool, aclocal
+ 2. libxml2 and libxml2-dev
+ 5. pkg-config
+
+6. 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 axis2c users or Axis2c developers about it by
sending your question to
- user = [email protected]
- developer = [email protected]
+ Then you can ask from Axis2C users or Axis2C developers about it by
+ sending your question to
+ user = [email protected]
+ developer = [email protected]
- You can get subscribe to
+ You can get subscribe to
- axis-c-user list by sending request to "[EMAIL PROTECTED]"
+ axis-c-user list by sending request to
+ <[EMAIL PROTECTED]>
- axis-c-dev list by sending request to "[EMAIL PROTECTED]"
+ axis-c-dev list by sending request to
+ <[EMAIL PROTECTED]>
- subject of the request should be "subscribe"
+ subject of the request should be "subscribe"
-7. This FAQ is not enough ?
+7. 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 Axis2c ...
-
-
-
+Thank you for using Axis2C ...
Index: NEWS
===================================================================
--- NEWS (revision 452316)
+++ NEWS (working copy)
@@ -23,11 +23,11 @@
15. Code generation tool for stub and skeleton generation for a given WSDL
(based on Java tool)
o Axis Data Binding (ADB) support
16. Security module with UsernameToken support
- 17. REST support (HTTP GET case) - New
- 18. Dynamic invocation support (based on XML schema and WSDL
implementations) - New
- 19. Guththila pull parser support
- 20. WSDL2C code generation tool- with schema code generation (experimental)
- 21. TCP Monitor - C implementation (experimental)
+ 17. REST support (HTTP GET case)
+ 18. Dynamic invocation support (based on XML schema and WSDL implementations)
+ 19. Guththila pull parser support - New
+ 20. WSDL2C code generation tool- with schema code generation (experimental)
- New
+ 21. TCP Monitor - C implementation (experimental) - New
Major Changes Since Last Release
1. Guththila pull parser support
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
