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 ma...@apache.org on 2008/06/18 14:17:37 UTC
svn commit: r669144 [4/4] - in
/webservices/axis2/branches/c/post_1_4_mtom/c: ./ axiom/src/parser/libxml2/
include/ src/core/clientapi/ src/core/transport/http/common/
src/core/transport/http/sender/ src/core/transport/http/server/IIS/
src/core/transpo...
Modified: webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/faq.html
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/faq.html?rev=669144&r1=669143&r2=669144&view=diff
==============================================================================
--- webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/faq.html (original)
+++ webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/faq.html Wed Jun 18 05:17:36 2008
@@ -1,96 +1,192 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-<head>
-<title>Apache Axis2/C - FAQ</title>
+<html><head><title>Apache Axis2/C - FAQ</title>
+
+</head>
+
+<body>
<h1>Apache Axis2/C Frequently Asked Questions</h1>
+<p>Mentioned below are a list of Frequently Asked Questions
+appearing on Axis2/C <a href="http://ws.apache.org/axis2/c/mail-lists.html">mailing
+lists</a>, and Forums.</p>
+<p>For questions not appearing below, or for any further
+clarifications please do not hesitate to contact the Apache Axis2/C
+user mailing list: <a href="mailto:axis-c-user@ws.apache.org">axis-c-user@ws.apache.org</a>
+(Subscription details are available on the <a href="http://ws.apache.org/axis2/c/mail-lists.html">Axis2
+site</a>.) Please
+remember to prefix the subject with [Axis2].</p>
+<p style="margin-bottom: 0in;"><br />
+</p>
+<a name="0_contents"></a>
+<h2>Contents</h2>
+<ol>
+<li><a href="#1_introduction">Introduction</a>
+<ol>
+<li><a href="#faq_1_1">What is Axis2/C?</a></li>
+<li><a href="#faq_1_2">Licensing</a></li>
+<li><a href="#faq_1_3">How can I obtain
+Axis2/C?</a></li>
+<li><a href="#faq_1_4">How can I get involved?</a></li>
+</ol>
+</li>
+<li><a href="#2_support">Support</a>
+<ol>
+<li><a href="#faq_2_1">Does Axis2/C support
+code generation?</a></li>
+<li><a href="#faq_2_2">Does Axis2/C support
+SSL?</a></li>
+<li><a href="#faq_2_3">Does Axis2/C support
+compression?</a></li>
+<li><a href="#faq_2_4">Does Axis2/C support
+SOAP Session management?</a></li>
+<li><a href="#faq_2_5">Can I use Axis2/C with
+a proxy?</a></li>
+</ol>
+</li>
+<li><a href="#3_how_to">How to?</a>
+<ol>
+<li><a href="#faq_3_1">How can I enable the
+Guththila parser?</a></li>
+<li><a href="#faq_3_2">How do I turn off MTOM
+globally?</a></li>
+<li><a href="#faq_3_3">How can I use Axis2/C
+with C++?</a></li>
+<li><a href="#faq_3_4">How could I secure SOAP
+messages?</a></li>
+</ol>
+</li>
+<li><a href="#4_why_do">Why do?</a>
+<ol>
+<li><a href="#faq_4_1">Why do I get an
+"Unresolved external symbol" error?</a></li>
+<li><a href="#faq_4_2">Why can't I run the
+samples?</a></li>
+<li><a href="#faq_4_3">libxml2 is installed
+but I get "libxml2 not found"?</a></li>
+</ol>
+</li>
+</ol>
+<p style="margin-bottom: 0in;"><br />
+</p>
+
+<h2>1. Introduction</h2>
+<p></p>
-<p>Mentioned below are a list of Frequently Asked Questions appearing on Axis2/C
- <a href="http://ws.apache.org/axis2/c/mail-lists.html">mailing lists</a>, and Forums.</p><p>For questions not appearing below,
- or for any further clarifications please do not hesitate to contact the Apache Axis2/C
- user mailing list: <a href="mailto:axis-c-user@ws.apache.org">axis-c-user@ws.apache.org</a>
-
-(Subscription details are available on the <a href="http://ws.apache.org/axis2/c/mail-lists.html">Axis2 site</a>.) Please
-remember to prefix the subject with [Axis2].</p><p style="margin-bottom: 0in"><br></br></p>
-
-<a name="0_contents"></a><h2>Contents</h2><ol>
- <li><a href="#1_introduction">Introduction</a><ol>
- <li><a href="#faq_1_1">What is Axis2/C?</a></li>
- <li><a href="#faq_1_2">Licensing</a></li>
- <li><a href="#faq_1_3">How can I obtain Axis2/C?</a></li>
- <li><a href="#faq_1_4">How can I get involved?</a></li>
- </ol></li>
- <li><a href="#2_support">Support</a><ol>
- <li><a href="#faq_2_1">Does Axis2/C support code generation?</a></li>
- <li><a href="#faq_2_2">Does Axis2/C support SSL?</a></li>
- <li><a href="#faq_2_3">Does Axis2/C support compression?</a></li>
- <li><a href="#faq_2_4">Does Axis2/C support SOAP Session management?</a></li>
- <li><a href="#faq_2_5">Can I use Axis2/C with a proxy?</a></li>
- </ol></li>
- <li><a href="#3_how_to">How to?</a><ol>
- <li><a href="#faq_3_1">How can I enable the Guththila parser?</a></li>
- <li><a href="#faq_3_2">How do I turn off MTOM globally?</a></li>
- <li><a href="#faq_3_3">How can I use Axis2/C with C++?</a></li>
- <li><a href="#faq_3_4">How could I secure SOAP messages?</a></li>
- </ol></li>
- <li><a href="#4_why_do">Why do?</a><ol>
- <li><a href="#faq_4_1">Why do I get an "Unresolved external symbol" error?</a></li>
- <li><a href="#faq_4_2">Why can't I run the samples?</a></li>
- <li><a href="#faq_4_3">libxml2 is installed but I get "libxml2 not found"?</a></li>
- </ol></li>
-</ol><p style="margin-bottom: 0in"><br></br></p>
-
-<a id="1_introduction"></a><h2>1. Introduction</h2><p></p>
-<a id="faq_1_1"></a><h3>1.1 What is Axis2/C?</h3>
-<p>Apache Axis2/C is a web services engine implemented in the C programming language based around the Axis2 architecture. Axis2/C can be used to provide and consume web services. It has been implemented with portablity and the ability to embed and could readily be used as a web services enabler for other software.</p>
-<a id="faq_1_2"></a><h3>1.2 Licensing</h3>
-<p>Apache Axis2/C is released under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>, a copy of the License is found in the LICENSE file found in your distribution. Apache Axis2/C also depends on several other projects of which licensing information are also included in the LICENSE file.</p>
-<a id="faq_1_3"></a><h3>1.3 How can I obtain Axis2/C?</h3>
-<p>Apache Axis2/C can be freely downloaded at the <a href="http://ws.apache.org/axis2/c/download.cgi">Axis2/C Download Page</a> or at any other mirror. Please note that Axis2/C source and binary packages are tailor made to suit specific classes of operating systems. Please make sure to choose the one that best fits your requirement as well as your operating system.</p>
-<a id="faq_1_4"></a><h3>1.4 How can I get involved?</h3>
-<p>Apache Axis2/C is a result of a highly involved list of apache committers, developers, as well as a keen group of users. For more information on our team, and how to get involved, please visit our <a href="http://ws.apache.org/axis2/c/team-list.html">Team Page</a>.</p>
-<p style="margin-bottom: 0in"><br></br></p>
-
-<a id="2_support"></a><h2>2. Support</h2><p></p>
-<a id="faq_2_1"></a><h3>2.1 Does Axis2/C support code generation?</h3>
-<p>Yes, Axis2/C supports code generation using the WSDL2C tool. Information on how to use this tool can be found in our <a href="http://ws.apache.org/axis2/c/docs/axis2c_manual.html#wsdl2c">documentation</a>.</p>
-<a id="faq_2_2"></a><h3>2.2 Does Axis2/C support SSL?</h3>
-<p>Yes, Axis2/C supports SSL enabled communication. More information can be found in our <a href="http://ws.apache.org/axis2/c/docs/axis2c_manual.html#ssl_client">documentation</a>.</p>
-<a id="faq_2_3"></a><h3>2.3 Does Axis2/C support compression?</h3>
-<p>Axis2/C itself does not support compression. If you are using mod_axis2 and the Apache HTTP server, you can also mod_deflate for compression. Also, you can enable compression by using libcurl as the http sender on the client side.</p>
-<a id="faq_2_4"></a><h3>2.4 Does Axis2/C support SOAP Session management?</h3>
+<h3>1.1 What is Axis2/C?</h3>
+<p>Apache Axis2/C is a web services engine implemented in the C
+programming language based around the Axis2 architecture. Axis2/C can
+be used to provide and consume web services. It has been implemented
+with portablity and the ability to embed and could readily be used as a
+web services enabler for other software.</p>
+
+<h3>1.2 Licensing</h3>
+<p>Apache Axis2/C is released under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache 2.0
+License</a>, a copy of the License is found in the LICENSE file
+found in your distribution. Apache Axis2/C also depends on several
+other projects of which licensing information are also included in the
+LICENSE file.</p>
+
+<h3>1.3 How can I obtain Axis2/C?</h3>
+<p>Apache Axis2/C can be freely downloaded at the <a href="http://ws.apache.org/axis2/c/download.cgi">Axis2/C
+Download Page</a> or at any other mirror. Please note that
+Axis2/C source and binary packages are tailor made to suit specific
+classes of operating systems. Please make sure to choose the one that
+best fits your requirement as well as your operating system.</p>
+
+<h3>1.4 How can I get involved?</h3>
+<p>Apache Axis2/C is a result of a highly involved list of apache
+committers, developers, as well as a keen group of users. For more
+information on our team, and how to get involved, please visit our <a href="http://ws.apache.org/axis2/c/team-list.html">Team Page</a>.</p>
+<p style="margin-bottom: 0in;"><br />
+</p>
+
+<h2>2. Support</h2>
+<p></p>
+
+<h3>2.1 Does Axis2/C support code generation?</h3>
+<p>Yes, Axis2/C supports code generation using the WSDL2C tool.
+Information on how to use this tool can be found in our <a href="http://ws.apache.org/axis2/c/docs/axis2c_manual.html#wsdl2c">documentation</a>.</p>
+
+<h3>2.2 Does Axis2/C support SSL?</h3>
+<p>Yes, Axis2/C supports SSL enabled communication. More
+information can be found in our <a href="http://ws.apache.org/axis2/c/docs/axis2c_manual.html#ssl_client">documentation</a>.</p>
+
+<h3>2.3 Does Axis2/C support compression?</h3>
+<p>Axis2/C itself does not support compression. If you are using
+mod_axis2 and the Apache HTTP server, you can also mod_deflate for
+compression. Also, you can enable compression by using libcurl as the
+http sender on the client side.</p>
+
+<h3>2.4 Does Axis2/C support SOAP Session management?</h3>
<p>No, there is no support for SOAP Sessions in Axis2/C.</p>
-<a id="faq_2_5"></a><h3>2.5 Can I use Axis2/C with a proxy?</h3>
-<p>Yes. This requires a few changes to the axis2.xml file. Information about this can be found in our <a href="http://ws.apache.org/axis2/c/docs/axis2c_manual.html#proxy">documentation</a>.</p>
-<p style="margin-bottom: 0in"><br></br></p>
-
-<a id="3_how_to"></a><h2>3. How to?</h2><p></p>
-<a id="faq_3_1"></a><h3>3.1 How can I enable the Guththila parser?</h3>
-<p>In Windows you have to put the <code>ENABLE_GUTHTHILA = 1</code> in the <code>build/win32/configure.in</code> file. In Linux you have to specify the configuration option <code>--enable-guththila=yes</code>. In a Microsoft Visual Studion Project (VC Project) this is little bit difficult. You have to add the guththila project to the existing Axis2/C solution. Then in the axis2_parser project, we have to remove the libxml wrapper files and add the guththila_wrapper files. Also in the axis2_parser project we have to change the include files and linker input files (libs) to corresponding guththila files (<code>guththila.lib</code> and <code>guththila/include</code>).</p>
-<a id="faq_3_2"></a><h3>3.2 How do I turn off MTOM globally?</h3>
-<p>MTOM can be disabled by commenting out the following line from your axis2.xml.
-(<code><parameter name="enableMTOM" locked="false">true</parameter></code>)</p>
-<a id="faq_3_3"></a><h3>3.3 How can I use Axis2/C with C++?</h3>
-<p>Just add the following code to your C source files and then use a C++ compiler.
-<pre> #ifdef __cplusplus
- extern "C"{
- #endif
- /* YOUR C CODE HERE */
- #ifdef __cplusplus
- }
- #endif
-</pre>
-</p>
-<a id="faq_3_4"></a><h3>3.4 How could I secure SOAP messages?</h3>
-<p>To secure SOAP messages, you need to engage <a href="http://ws.apache.org/rampart/c/">Apache Rampart/C</a> as a module, which can be downloaded from <a href="http://ws.apache.org/rampart/c/download.cgi">here</a>. Please refer the <a href="http://ws.apache.org/rampart/c/docs/installationguide.html">installation guide</a> and <a href="http://ws.apache.org/rampart/c/docs/configurations.html">configuration guide</a> for more details.</p>
-<p style="margin-bottom: 0in"><br></br></p>
-
-<a id="4_why_do"></a><h2>4. Why do?</h2><p></p>
-<a id="faq_4_1"></a><h3>4.1 Why do I get an "Unresolved external symbol" error?</h3>
-<p>Make sure that your <code>AXIS2C_HOME/lib</code> directory is added to your <code>PATH</code> Environment Variable.</p>
-<a id="faq_4_2"></a><h3>4.2 Why can't I run the samples?</h3>
-<p>This is usually because the <code>AXIS2C_HOME</code> Environment Variable is not set to the correct path. Make sure that it is set to your Axis2/C installation path.</p>
-<a id="faq_4_3"></a><h3>4.3 libxml2 is installed but I get "libxml2 not found"?</h3>
-<p>Make sure that you have installed the libxml2-dev packages.</p>
-<p style="margin-bottom: 0in"><br></br></p>
-<div class="clear"><hr></hr></div></body></html>
+<h3>2.5 Can I use Axis2/C with a proxy?</h3>
+<p>Yes. This requires a few changes to the axis2.xml file.
+Information about this can be found in our <a href="http://ws.apache.org/axis2/c/docs/axis2c_manual.html#proxy">documentation</a>.</p>
+<p style="margin-bottom: 0in;"><br />
+</p>
+
+<h2>3. How to?</h2>
+<p></p>
+
+<h3>3.1 How can I enable the Guththila parser?</h3>
+<p>In Windows you have to put the <code>ENABLE_GUTHTHILA =
+1</code> in the <code>build/win32/configure.in</code>
+file. In Linux you have to specify the configuration option <code>--enable-guththila=yes</code>.
+In a Microsoft Visual Studion Project (VC Project) this is little bit
+difficult. You have to add the guththila project to the existing
+Axis2/C solution. Then in the axis2_parser project, we have to remove
+the libxml wrapper files and add the guththila_wrapper files. Also in
+the axis2_parser project we have to change the include files and linker
+input files (libs) to corresponding guththila files (<code>guththila.lib</code>
+and <code>guththila/include</code>).</p>
+
+<h3>3.2 How do I turn off MTOM globally?</h3>
+<p>MTOM can be disabled by commenting out the following line from
+your axis2.xml.
+(<code><parameter name="enableMTOM"
+locked="false">true</parameter></code>)</p>
+
+<h3>3.3 How can I use Axis2/C with C++?</h3>
+<p>Just add the following code to your C source files and then
+use a C++ compiler.
+</p>
+<pre> #ifdef __cplusplus <br /> extern "C"{<br /> #endif<br /> /* YOUR C CODE HERE */<br /> #ifdef __cplusplus<br /> }<br /> #endif<br /></pre>
+
+<h3>3.4 How could I secure SOAP messages?</h3>
+<p>To secure SOAP messages, you need to engage <a href="http://ws.apache.org/rampart/c/">Apache Rampart/C</a>
+as a module, which can be downloaded from <a href="http://ws.apache.org/rampart/c/download.cgi">here</a>.
+Please refer the <a href="http://ws.apache.org/rampart/c/docs/installationguide.html">installation
+guide</a> and <a href="http://ws.apache.org/rampart/c/docs/configurations.html">configuration
+guide</a> for more details.</p>
+<p style="margin-bottom: 0in;"><br />
+</p>
+
+<h2>4. Why do?</h2>
+<p></p>
+
+<h3>4.1 Why do I get an "Unresolved external symbol" error?</h3>
+<p>Make sure that your <code>AXIS2C_HOME/lib</code>
+directory is added to your <code>PATH</code> Environment
+Variable.</p>
+
+<h3>4.2 Why can't I run the samples?</h3>
+<p>This is usually because the <code>AXIS2C_HOME</code>
+Environment Variable is not set to the correct path. Make sure that it
+is set to your Axis2/C installation path.</p>
+
+<h3>4.3 libxml2 is installed but I get "libxml2 not found"?</h3>
+<p>Make sure that you have installed the libxml2-dev packages.</p>
+<p style="margin-bottom: 0in;">1. If you are using a
+Debian based system run<br /> $ apt-get install libxml2-dev<br />
+</p>
+<p style="margin-bottom: 0in;">2. If you are
+using a RedHat/Fedora based system run<br />
+ $ yum install
+libxml2-dev<br />
+</p><p style="margin-bottom: 0in;">3. If you install libxml2 from source
+you will not get this error<br />
+<br />
+</p>
+<div class="clear">
+<hr /></div>
+</body></html>
Modified: webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/index.html
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/index.html?rev=669144&r1=669143&r2=669144&view=diff
==============================================================================
--- webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/index.html (original)
+++ webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/index.html Wed Jun 18 05:17:36 2008
@@ -9,4 +9,5 @@
<li><a href="architecture_notes.html">C Specific Architecture Notes</a></li>
<li><a href="om_tutorial.html">OM Tutorial</a></li>
<li><a href="../coding_conventions.html">Coding Conventions in Axis2/C</a></li>
+ <li><a href="../api/html/index.html">API Documentation</a></li>
</ul></div></div></div></div><div class="clear"><hr></hr></div></body></html>
Modified: webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/installationguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/installationguide.html?rev=669144&r1=669143&r2=669144&view=diff
==============================================================================
--- webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/installationguide.html (original)
+++ webservices/axis2/branches/c/post_1_4_mtom/c/xdocs/docs/installationguide.html Wed Jun 18 05:17:36 2008
@@ -1,707 +1,712 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache Axis2/C - Installation Guide</title><h2>Apache Axis2/C Installation Guide</h2><p>This document guides you on how to install Axis2/C, and run the server and
-
-client samples on Linux and Microsoft Windows operating systems.</p><p>This release comes in two forms, source and binary. This document covers
-
-both forms.</p><p>Please send your feedback to the developer mailing list: <a href="mailto:axis-c-dev@ws.apache.org">axis-c-dev@ws.apache.org</a>
-
-(Subscription details are available on the <a href="http://ws.apache.org/axis2/c/mail-lists.html" class="externalLink" title="External Link">Axis2 site</a>.) Please
-
-remember to prefix the subject with [Axis2].</p><p style="margin-bottom: 0in"><br></br>
-</p></div><div class="section"><a name="Contents"></a><h2>Contents</h2><ul>
-
- <li><a href="#linux">Installing and Running on Linux</a>
-
- <ul>
-
- <li><a href="#linux_binary">Using the Binary Release</a></li>
-
- <li><a href="#linux_source">Using the Source Release</a></li>
-
- </ul>
-
- </li>
-
- <li><a href="#win">Installing and Running on Microsoft Windows (win32)</a>
-
- <ul>
-
- <li><a href="#win_binary">Using the Binary Release</a></li>
-
- <li><a href="#win_source">Using the Source Release</a></li>
-
- </ul>
-
- </li>
-
-</ul><p style="margin-bottom: 0in"><br></br>
-</p><p><a id="linux"></a></p></div><div class="section"><a name="1__Installing_and_Running_on_Linux"></a><h2>1. Installing and Running on Linux</h2><p>This can be done using binary or source distributions. (<a href="http://ws.apache.org/axis2/c/download.cgi" class="externalLink" title="External Link">Download</a> the two
-
-distributions)</p><p>To get both the binary and source distributions working, you need <a href="http://xmlsoft.org/downloads.html" class="externalLink" title="External Link">Libxml2</a>.</p><p><b>Note:</b> Most Linux systems have Libxml2 installed by default. On MS
-
-Windows, you need to download and install Libxml2.</p><p><a id="linux_binary"></a></p><div class="subsection"><a name="1_1__Installing_the_Binary_Distribution"></a><h3>1.1. Installing the Binary Distribution</h3><p>The following steps have to be followed to install and run the Axis2/C
-
-binary distribution on Linux : </p><ol>
-
- <li>Extract the binary tar package to a folder.</li>
-
- <li>Set the AXIS2C_HOME environment variable pointing to the location where
-
- you have extracted Axis2/C
-
- <ul>
-
- <li><code>AXIS2C_HOME='/your_path_to_axis2c'</code></li>
-
- <li><code>export AXIS2C_HOME</code></li>
-
- <p><strong>Note:</strong> 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. </p>
-
- </ul>
-
- </li>
-
- <li>Run the simple axis server:
-
- <ul>
-
- <li>To start the simple axis server on the default port 9090, run the
-
- following commands.
-
- <ul>
-
- <li><code>cd /your_path_to_axis2c/bin</code></li>
-
- <li><code>./axis2_http_server</code></li>
-
- </ul>
-
- </li>
-
- <li>To see the possible command line options run <code>./axis2_http_server -h</code>
-
- <p><strong>Note:</strong> If you run into shared library problems,
-
- try setting the LD_LIBRARY_PATH to include the lib folder containing
-
- the Axis2/C libs.</p>
-
- <ul>
-
- <li><code>LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib</code></li>
-
- <li><code>export LD_LIBRARY_PATH</code></li>
-
- </ul>
-
- </li>
-
- </ul>
-
- </li>
-
- <li>Run the sample clients in a new shell
-
- <ul>
-
- <li><code>cd /your_path_to_axis2c/bin/samples</code></li>
-
- <li>To run the client for echo service
-
- <ul>
-
- <li><code>./echo</code></li>
-
- </ul>
-
- </li>
-
- <li>To run the client for math service
-
- <ul>
-
- <li><code>./math</code></li>
-
- </ul>
-
- </li>
-
- <li>To see the possible command line options for the sample clients,
-
- run them with the '-h' option</li>
-
- <p><strong>Note:</strong> If you run into shared library problems, try
-
- setting the LD_LIBRARY_PATH</p>
-
- <ul>
-
- <li><code>LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_path_to_axis2c/lib</code></li>
-
- <li><code>export LD_LIBRARY_PATH</code></li>
-
- </ul>
-
- </ul>
-
- </li>
-
-</ol><p><a id="linux_source"></a></p></div><div class="subsection"><a name="1_2__Installing_the_Source_Distribution"></a><h3>1.2. Installing the Source Distribution</h3><p>The following steps have to be followed to install and run Axis2/C using
-
-the source distribution on Linux :</p><ol>
-
- <li>Extract the source tar package to a folder.</li>
-
- <li>Set the AXIS2C_HOME environment variable pointing to the location where
-
- you want to install Axis2/C
-
- <ul>
-
- <li><code>AXIS2C_HOME='/your_desired_path_to_axis2c_installation'</code></li>
-
- <li><code>export AXIS2C_HOME</code></li>
-
- <p><strong>Note:</strong> 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.</p>
-
- </ul>
-
- </li>
-
- <li>Then go to the folder where you extracted the source.
-
- <ul>
-
- <li><code>cd /your_path_to_axis2c_source</code></li>
-
- </ul>
-
- </li>
-
- <li>Build the source
-
- <ul>
-
- <li>This can be done using the following command sequence, in the
-
- directory where you have extracted the source:
-
- <ul>
-
- <li><code>./configure</code></li>
-
- <li><code>make</code></li>
-
- <li><code>make install</code></li>
-
- </ul>
-
- </li>
-
- <li>Use <code>./configure --help</code> for possible command line options.</li>
-
- <li><strong>Note:</strong> If you do not provide a <code>--prefix</code> configure
-
- option, the default installation would be in the /usr/local/axis2c
-
- directory.</li>
-
- <li>You may have to try Axis2/C with Guththila XML parser. You can do
-
- that by providing the <code>--enable-guththila=yes</code> option when configuring.
-
- <ul>
-
- <li><code>./configure --enable-guththila=yes</code> [other configuration
-
- options]</li>
-
- <li><code>make</code></li>
-
- <li><code>make install</code></li>
-
- </ul>
-
- </li>
-
- <li>If you want to get the samples working, you have to build the
-
- samples. <br></br>
-
- To build the samples:
-
- <ul>
-
- <li><code>LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path_you_installed_axis2c/lib/</code></li>
-
- <li><code>export LD_LIBRARY_PATH</code></li>
-
- <li><code>cd samples</code></li>
- <li><code>./configure --prefix=${AXIS2C_HOME}
- --with-axis2=${AXIS2C_HOME}/include/axis2-1.2</code></li>
-
- <li><code>make</code></li>
-
- <li><code>make install</code></li>
-
- </ul>
-
- </li>
-
- <li>Please run <code>./configure --help</code> in the samples folder for more
-
- information on the configure options.</li>
-
- <li><strong>Note:</strong> If you do not provide a <code>--prefix</code> configure
-
- option, by default, the samples will be installed into the
-
- "/usr/local/axis2c/bin/samples" directory.</li>
-
- </ul>
-
- </li>
-
- <li>Go to where you installed Axis2/C.</li>
-
- <li>Start the simple axis server.
-
- <ul>
-
- <li>To start the simple axis server on port 9090, run the following
-
- command lines.
-
- <ul>
-
- <li><code>cd /path_you_installed_axis2c/bin</code></li>
-
- <li><code>./axis2_http_server</code></li>
-
- </ul>
-
- </li>
-
- <li>To see the possible command line options, run <code>./axis2_http_server
-
- -h</code></li>
-
- <li><strong>Note:</strong> You may have to be logged in as a superuser
-
- to run the simple axis server if you installed Axis2/C as a super
-
- user.</li>
-
- </ul>
-
- </li>
-
- <li>Run the sample clients in a new shell using the following command lines.
-
- <ul>
-
- <li><code>cd /path_you_installed_axis2c/bin/samples</code></li>
-
- <li>To run the client for the echo service
-
- <ul>
-
- <li><code>./echo</code></li>
-
- </ul>
-
- </li>
-
- <li>To run the client for the math service
-
- <ul>
-
- <li><code>./math</code></li>
-
- </ul>
-
- </li>
-
- <li>To see the possible command line options for the sample clients,
-
- run them with the '-h' option</li>
-
- </ul>
-
- </li>
-
-</ol><p style="margin-bottom: 0in"><br></br>
-</p><p><a id="win"></a></p></div></div><div class="section"><a name="2__Installing_and_Running_on_Microsoft_Windows"></a><h2>2. Installing and Running on Microsoft Windows</h2><p>This too can be done using binary or source distributions. (<a href="http://ws.apache.org/axis2/c/download.cgi" class="externalLink" title="External Link">Download</a> the two
-
-distributions.) </p><p>For both binary and source distributions, you have to download <a href="http://www.zlatkovic.com/pub/libxml/" class="externalLink" title="External Link">Libxml2</a>, if you are not using Guththila parser which comes with the distribution.</p><p><a id="win_binary"></a></p><div class="subsection"><a name="2_1__Installing_the_Binary_Distribution"></a><h3>2.1. Installing the Binary Distribution</h3></div><div class="subsection"><a name="2_1_1__Requirements"></a><h3>2.1.1. Requirements</h3><ul>
-
- <li>The binaries shipped with this version are compiled with the Microsoft
-
- Visual Studio compiler (cl)</li>
-
-
-
- <p>(<strong>Note</strong>: you can <a href="http://msdn.microsoft.com/vstudio/express/downloads/" class="externalLink" title="External Link">download the
-
- Microsoft VSExpress2005 edition</a> from the Microsoft Web site and install
-
- it to run these binaries.)</p>
-
- <li>You also need the following DLLs:
-
- <ul>
-
- <li>iconv.dll [http://www.zlatkovic.com/pub/libxml/ - download the
-
- version >= iconv-1.9.1.win32]</li>
-
- <li>zlib1.dll [http://www.zlatkovic.com/pub/libxml/ - download the version >=
-
- zlib-1.2.3.win32]</li>
-
- </ul>
-
- </li>
-
- <li>You might optionally need the following DLLs:
-
- <ul>
-
- <li>libxml2.dll [http://www.zlatkovic.com/pub/libxml/ - download the version >=
-
- libxml2-2.6.27.win32] (optional - required only if you are not using Guththila parser)</li>
-
- </ul>
-
- </li>
-
-
-</ul><p><a id="bin_binaries"></a></p></div><div class="subsection"><a name="2_1_2__Binaries_in_the_Release"></a><h3>2.1.2. Binaries in the Release</h3><ul>
-
- <li>Extract the binary distribution to a folder of your choice. (example:
-
- C:\axis2c)</li>
-
- <li>The C:\axis2c folder structure is as follows:</li>
-
-
-
- <p><img alt="Figure: c:\axis2c Folder Structure" src="images/binary_folder_structure.jpg"></img></p>
-
-
-
- <p><em>The above folders contain the following files:</em></p>
-
- <ul>
-
- <li>bin - server and other executables</li>
-
- <li>bin\samples - client samples </li>
-
- <li>lib - library modules</li>
-
- <li>services - deployed services</li>
-
- <li>modules - deployed modules</li>
-
- <li>include - all Include files of Axis2/C</li>
-
- <li>logs - system and client logs are written to this folder</li>
-
- </ul>
-
- <li>Copy iconv.dll, and zlib1.dll downloaded to
-
- C:\axis2c\lib</li>
-
- <li>You might optionally require to copy the libxml2.dll as well</li>
-
-</ul><p><a id="bin_run"></a></p></div><div class="subsection"><a name="2_1_3__Running_the_Binaries"></a><h3>2.1.3. Running the Binaries</h3><ul>
-
- <li>First, you need to set a couple of environment variables before you can
-
- run the server and samples.
-
- <ul>
-
- <li>Set the variable AXIS2C_HOME to the deploy folder (C:\axis2c)</li>
-
- <li>Add the path to the lib directory to the PATH variable
-
- (%AXIS2C_HOME%\lib)</li>
-
- </ul>
-
- </li>
-
- <li>Now everything is set to run the server.
-
- <p>C:\axis2c\bin\>axis2_http_server.exe</p>
-
- </li>
-
- <li>If the server is running successfully, you will see the message
-
- "Started Simple Axis2 HTTP Server..."</li>
-
- <li>By default, the log is created in the %AXIS2C_HOME%\logs folder with
-
- the name axis2.log.</li>
-
- <li>(<strong>Note</strong>: You can provide command line options to change
-
- the default behavior. Use the command <code>axis2_http_server.exe -h</code> to learn
-
- about the usage)</li>
-
- <li>Now you can run any sample client located in %AXIS2C_HOME%\bin\samples\
-
- <ul>
-
- <li>Example: C:\axis2c\bin\samples\> echo.exe</li>
-
- </ul>
-
- </li>
-
-</ul><p><a id="win_source"></a></p></div><div class="subsection"><a name="2_2__Installing_the_Source_Distribution"></a><h3>2.2. Installing the Source Distribution</h3></div><div class="subsection"><a name="2_2_1__Requirements"></a><h3>2.2.1. Requirements</h3><ul>
-
- <li>The makefile shipped with this version needs Microsoft Visual Studio
-
- Compiler (cl) and the NMake build tool.</li>
-
-
-
- <p>(Note: You can <a href="http://msdn.microsoft.com/vstudio/express/downloads/" class="externalLink" title="External Link">download the
-
- Microsoft VSExpress2005 edition and Platform SDK</a> from the Microsoft Web
-
- site. You will need to add the path to the Platform SDK Include and Lib
-
- folders to the makefile)</p>
-
- <li>You also need the following DLLs:
-
- <ul>
-
- <li>iconv.dll [http://www.zlatkovic.com/pub/libxml/ - download the
-
- version >= iconv-1.9.1.win32]</li>
-
- <li>zlib1.dll [http://www.zlatkovic.com/pub/libxml/ - download the version >=
-
- zlib-1.2.3.win32]</li>
-
- </ul>
-
- </li>
-
- <li>You might optionally need the following DLLs:
-
- <ul>
-
- <li>libxml2.dll [http://www.zlatkovic.com/pub/libxml/ - download the version >=
-
- libxml2-2.6.27.win32] (optional - required only if you are not using Guththila parser)</li>
-
- </ul>
-
- </li>
-
-</ul><p><a id="edit"></a></p></div><div class="subsection"><a name="2_2_2__Editing_the_configure_in_File"></a><h3>2.2.2. Editing the configure.in File</h3><p>Please edit the <source_distribution>\build\win32\configure.in file
-
-to include the following information.</p><p>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.<br></br>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html><head><title>Apache Axis2/C - Installation Guide</title>
+</head>
+<body>
+<h2>Apache Axis2/C Installation Guide</h2>
+<p>This document guides you on how to install Axis2/C, and run
+the server and
+client samples on Linux and Microsoft Windows operating systems.</p>
+<p>This release comes in two forms, source and binary and you can
+download them from <a href="http://ws.apache.org/axis2/c/download.cgi" class="externalLink">here</a>. This
+document covers
+both forms.</p>
+<p>Please send your feedback to the developer mailing list: <a href="mailto:axis-c-dev@ws.apache.org">axis-c-dev@ws.apache.org</a>
+(Subscription details are available on the <a href="http://ws.apache.org/axis2/c/mail-lists.html" class="externalLink" title="External Link">Axis2 site</a>.)
+Please
+remember to prefix the subject with [Axis2].</p>
+<div class="section"><a name="Contents"></a>
+<h2>Contents</h2>
<ul>
-
-<li>iconv [ICONV_BIN_DIR]<br></br></li>
-
-<li>zlib [ZLIB_BIN_DIR]<br></br></li>
-
-<li>libxml2 (required if you are not using Guththila) [LIBXML2_BIN_DIR]<br></br></li>
-
+1. <a href="#1">Getting Axis2/C Working on Linux</a>
+<br />
+<ul>
+1.1 <a href="#1.1">Setting up Prerequisites</a>
+<ul>
+1.1.1 <a href="#1.1.1">Mandatory</a> <br />
+1.1.2 <a href="#1.1.2">Optional</a> <br />
</ul>
-
-</p><p>The default paths for these external libraries are already specified in configure.in file.<br></br>
-
- Example: If zlib is installed into C:\zlib, edit the
-
-configure.in file accordingly.<br></br>
-
-<br></br>
-
-You can either extract zlib to this folder, in which case the folder
-
-structure for C:\zlib should look like the following:</p><p><img alt="Figure: C:\zlib Folder Structure" src="images/folder_structure_zlib.jpg"></img><br></br>
-
- Else, extract it to a location of your choice and edit the configure.in
-
- file accordingly.<br></br>
-
- <br></br>
-
- If you need the parser to use Guththila XML parser, set the
-
- ENABLE_GUTHTHILA option to 1 in configure.in
-
- file.<br></br>
-
- Example: <code>ENABLE_GUTHTHILA = 1</code><br></br>
-
- <br></br>
-
-<b>Other options available:</b><br></br>
-
-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.<br></br>
-
-<br></br>
-
-If you want to enable <a href="http://curl.haxx.se/" class="externalLink" title="External Link">libcurl</a> based client transport, set ENABLE_LIBCURL to 1 and set the path where libcurl is installed to LIBCURL_BIN_DIR.<br></br>
-
-</p><p><a id="src_compile"></a></p></div><div class="subsection"><a name="2_2_3__Compiling_the_Source"></a><h3>2.2.3. Compiling the Source</h3><p>The following steps will take you through the source compilation.</p><ul>
-
- <li>Extract the source distribution to a folder of your choice. (Example:
-
- C:\axis2c)</li>
-
- <li>Edit the configure.in file as explained in the section 2.2.3</li>
-
- <li>Open a DOS shell</li>
-
- <li><code>cd C:\axis2c\build\win32</code></li>
-
- <li>to access .Net tools, run
-
- <ul>
-
- <li>C:\axis2c\build\win32> vcvars32.bat</li>
-
- </ul>
-
- <p>(<strong>Note</strong>: 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.)</p>
-
- </li>
-
- <li>To build the system and create the binary files in a directory named
-
- deploy under the build directory,
-
- <ul>
-
- <li>C:\axis2c\build\win32>nmake install</li>
-
- </ul>
-
- </li>
-
- <li>The deploy folder structure is as follows:</li>
-
-
-
- <p><img alt="Figure: deploy Folder Structure" src="images/folder_structure.jpg"></img></p>
-
-
-
- <p><em>The above folders contain the following files:</em></p>
-
- <ul>
-
- <li>bin - server and other executable</li>
-
- <li>bin\samples - client samples</li>
-
- <li>lib - library modules</li>
-
- <li>services - deployed services</li>
-
- <li>modules - deployed modules</li>
-
- <li>include - all include files of Axis2 C</li>
-
- <li>logs - system and client logs are written to this folder</li>
-
- </ul>
-
-</ul><p>Please note that <code>nmake install</code> does not build the apache or the IIS module. Refer to <a href="axis2c_manual.html">Axis2/C manual</a> to see how to install these modules.</p><p>
-
-
-
-<a id="src_run"></a>
-
-
-
-</p></div><div class="subsection"><a name="2_2_4__Running_the_Binaries"></a><h3>2.2.4. Running the Binaries</h3><ul>
-
- <li>You need to set a couple of environment variables before you can run
-
- the server and samples.
-
- <ul>
-
- <li>Set the variable AXIS2C_HOME to the deploy folder
-
- (C:\axis2c\build\deploy)</li>
-
- <li>Add the path to the lib directory to the PATH variable
-
- (%AXIS2C_HOME%\lib)</li>
-
- <li>Copy iconv.dll and zlib1.dll to Axis2/C lib folder
-
- (%AXIS2C_HOME%\lib)</li>
-
- <li>You might optionally require to copy the libxml2.dll as well</li>
-
- </ul>
-
- </li>
-
- <li>Now run the server - C:\axis2c\build\deploy\bin>
-
- axis2_http_server.exe</li>
-
- <li>If the server is running successfully, you will see the message
-
- "Started Simple Axis2 HTTP Server..."</li>
-
- <li>By default, the log is created under the %AXIS2C_HOME%\logs folder with
-
- the name axis2.log.</li>
-
- <li>(<strong>Note</strong>: You can provide command line options to change
-
- the default behavior. Use the command "axis2_http_server.exe -h" to learn
-
- about the usage)</li>
-
- <li>Now you can run any sample client deployed under
-
- %AXIS2C_HOME%\bin\samples\
-
- <ul>
-
- <li>Example: C:\axis2c\build\deploy\bin\samples> echo.exe</li>
-
- </ul>
-
- </li>
-
-</ul></div></div></div></div><div class="clear"><hr></hr></div></body></html>
+1.2 <a href="#1.2">Using Binary Release</a> <br />
+1.3 <a href="#1.3">Using Source Release</a> <br />
+<ul>
+1.3.1 <a href="#1.3.1">Basic Build</a> <br />
+1.3.2 <a href="#1.3.2">Build with Options</a> <br />
+<ul>
+(a) <a href="#1.3.2.a">With Guththila</a> <br />
+(b) <a href="#1.3.2.b">With libxml2</a><br />
+(c) <a href="#1.3.2.c">With AMQP Transport</a><br />
+</ul>
+1.3.3 <a href="#1.3.3">Building Samples</a> <br />
+</ul>
+1.4 <a href="#1.4">Configuration</a> <br />
+<ul>
+1.4.1 <a href="#1.4.1">AMQP Transport</a> <br />
+</ul>
+1.5 <a href="#1.5">Running Samples</a> <br />
+<ul>
+1.5.1 <a href="#1.5.1">HTTP Transport</a> <br />
+<ul>
+(a) <a href="#1.5.1.a">Server</a> <br />
+(b) <a href="#1.5.1.b">Clients</a> <br />
+</ul>
+1.5.2 <a href="#1.5.2">AMQP Transport</a> <br />
+<ul>
+(a) <a href="#1.5.2.a">Server</a> <br />
+(b) <a href="#1.5.2.b">Client</a> <br />
+</ul>
+</ul>
+</ul>
+<br />
+2. <a href="#2">Getting Axis2/C Working on Windows (Win32)</a><br />
+<ul>
+2.1 <a href="#2.1">Setting up Prerequisites</a><br />
+<ul>
+2.1.1 <a href="#2.1.1">Mandatory</a><br />
+2.1.2 <a href="#2.1.2">Optional</a><br />
+</ul>
+2.2 <a href="#2.2">Using Binary Release</a><br />
+2.3 <a href="#2.3">Using Source Release</a><br />
+<ul>
+2.3.1 <a href="#2.3.1">Setting Build Options</a><br />
+<ul>
+(a) <a href="#2.3.1.a">Setting zlib Location</a><br />
+(b) <a href="#2.3.1.b">Enable Guththila</a><br />
+(c) <a href="#2.3.1.c">Enable libxml2</a><br />
+(d) <a href="#2.3.1.d">Enable SSL Support</a><br />
+(e) <a href="#2.3.1.e">Enable libcurl</a><br />
+</ul>
+2.3.2 <a href="#2.3.2">Compiling the Source</a><br />
+</ul>
+2.4 <a href="#2.4">Running Samples</a><br />
+<ul>
+2.4.1 <a href="#2.4.1">HTTP transport</a><br />
+<ul>
+(a) <a href="#2.4.1.a">Server</a><br />
+(b) <a href="#2.4.1.b">Clients</a><br />
+</ul>
+</ul>
+</ul>
+<br />
+3. <a href="#3">Installing Apache2 Web Server Integration
+Module (mod_axis2)</a><br />
+<ul>
+3.1 <a href="#3.1">Building mod_axis2 from Source</a><br />
+<ul>
+3.1.1 <a href="#3.1.1">On Linux</a><br />
+3.1.2 <a href="#3.1.2">On Windows (Win32)</a><br />
+</ul>
+3.2 <a href="#3.2">Deploying in Apache2 Web Server</a><br />
+</ul>
+<br />
+4. <a href="#4">Installing IIS (Interner Information
+Server) Integration Module (mod_axis2_IIS)</a><br />
+<ul>
+4.1 <a href="#4.1">Building mod_axis2_IIS from Source</a><br />
+4.2 <a href="#4.2">Deploying in the IIS</a><br />
+</ul>
+</ul>
+</div>
+<br />
+<div class="section"><a name="1"></a>
+<h2>1. Getting Axis2/C Working on Linux</h2>
+<div class="subsection"><a name="1.1"></a>
+<h3>1.1 Setting up Prerequisites</h3>
+<div class="subsection"><a name="1.1.1"></a>
+<h4>1.1.1 Mandatory</h4>
+<p>(a) zlib - <a class="externalLink" href="http://www.zlib.net/">http://www.zlib.net/</a></p>
+</div>
+<div class="subsection"><a name="1.1.2"></a>
+<h4>1.1.2 Optional</h4>
+<p>(a) libxml2 - <a class="externalLink" href="http://www.xmlsoft.org/">http://www.xmlsoft.org/</a>
+<br />
+(b) libiconv - <a class="externalLink" href="http://www.gnu.org/software/libiconv/">http://www.gnu.org/software/libiconv/</a>
+<br />
+(c) Apache Qpid - </p>
+<ul>
+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.<br />
+You can checkout Qpid SVN source from <a class="externalLink" href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid">https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid</a>.
+</ul>
+</div>
+</div>
+<div class="subsection"><a name="1.2"></a>
+<h3>1.2 Using Binary Release</h3>
+<p>
+(a) Extract the binary tar package to a directory.<br />
+<br />
+(b) Set AXIS2C_HOME environment variable pointing to the location where
+you have extracted Axis2/C.<br />
+<br />
+<code>$ AXIS2C_HOME='/your_path_to_axis2c'</code><br />
+<code>$ export AXIS2C_HOME</code><br />
+<br />
+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.<br />
+</p>
+</div>
+<div class="subsection"><a name="1.3"></a>
+<h3>1.3 Using Source Release</h3>
+<div class="subsection"><a name="1.3.1"></a>
+<h4>1.3.1 Basic Build</h4>
+(a) Extract the source tar package to a directory<br />
+<br />
+(b) Set AXIS2C_HOME environment variable pointing to the location where
+you want to install Axis2/C.<br />
+<br />
+<code>$ AXIS2C_HOME='/your_desired_path_to_axis2c_installation'</code><br />
+<code>$ export AXIS2C_HOME</code><br />
+<br />
+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.<br />
+<br />
+(c) Go to the directory where you extracted the source<br />
+<br />
+<code>$ cd /your_path_to_axis2c_source</code><br />
+<br />
+(d) Build the source<br />
+This can be done by running the following command sequence in the
+directory where you have extracted the source.<br />
+<br />
+<code>$ ./configure --prefix=${AXIS2C_HOME}</code><br />
+<code>$ make</code><br />
+<code>$ make install</code><br />
+<br />
+Please run './configure --help' in respective sub directories for more
+information on these configure options. <br />
+<br />
+NOTE : If you don't provide the --prefix configure option, it will by
+default be installed into '/usr/local/axis2c' directory.<br />
+<br />
+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.<br />
+</div>
+<div class="subsection"><a name="1.3.2"></a>
+<h4>1.3.2 Build with Options</h4>
+<div class="subsection"><a name="1.3.2.a"></a>
+<h4>(a) With Guththila</h4>
+You may need to try Axis2/C with Guththila XML parser. You can do it by
+giving '--enable-guththila=yes' as a configure option.<br />
+<br />
+<code>$ ./configure --enable-guththila=yes [other configuration
+options]</code><br />
+<code>$ make</code><br />
+<code>$ make install</code><br />
+</div>
+<div class="subsection"><a name="1.3.2.b"></a>
+<h4>(b) With libxml2</h4>
+You may need to try Axis2/C with libxml2 XML parser. You can do it by
+giving '--enable-libxml2=yes' as a configure option.<br />
+<br />
+<code>$ ./configure --enable-libxml2=yes [other configuration
+options]</code><br />
+<code>$ make</code><br />
+<code>$ make install</code><br />
+</div>
+<div class="subsection"><a name="1.3.2.c"></a>
+<h4>(c) With AMQP Transport</h4>
+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.<br />
+<br />
+<code>$ ./configure --with-qpid=/path/to/qpid/home [other
+configuration options]</code><br />
+<code>$ make</code><br />
+<code>$ make install</code><br />
+</div>
+</div>
+<div class="subsection"><a name="1.3.3"></a>
+<h4>1.3.3 Building Samples</h4>
+If you need to get the samples working, you also need to build the
+samples.<br />
+<br />
+To build the samples:<br />
+<br />
+<code>$ export
+LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib/</code><br />
+<code>$ cd samples</code><br />
+<code>$ ./configure --prefix=${AXIS2C_HOME}
+--with-axis2=${AXIS2C_HOME}/include/axis2-1.4.0</code><br />
+<code>$ make</code><br />
+<code>$ make install</code><br />
+<br />
+Please run './configure --help' in samples folder for more information
+on configure options.<br />
+<br />
+NOTE : If you don't provide a --prefix configure option, samples will
+by default be installed into '/usr/local/axis2c/samples' directory.<br />
+</div>
+</div>
+<div class="subsection"><a name="1.4"></a>
+<h3>1.4 Configuration</h3>
+<div class="subsection"><a name="1.4.1"></a>
+<h4>1.4.1 AMQP Transport</h4>
+You need to add the following entries into the axis2.xml.<br />
+<br />
+<code><transportReceiver name="amqp"
+class="axis2_amqp_receiver"> <br />
+ <parameter name="qpid_broker_ip"
+locked="false">127.0.0.1</parameter><br />
+ <parameter name="qpid_broker_port"
+locked="false">5672</parameter><br />
+</transportReceiver><br />
+<br />
+<transportSender name="amqp" class="axis2_amqp_sender"/></code>
+</div>
+</div>
+<div class="subsection"><a name="1.5"></a>
+<h3>1.5 Running Samples</h3>
+<div class="subsection"><a name="1.5.1"></a>
+<h4>1.5.1 HTTP Transport</h4>
+<div class="subsection"><a name="1.5.1.a"></a>
+<h4>(a) Server</h4>
+You have to first start the axis2_http_server as follows.<br />
+<br />
+<code>$ cd ${AXIS2C_HOME}/bin</code><br />
+<code>$ ./axis2_http_server</code><br />
+<br />
+You should see the message<br />
+ Started
+Simple Axis2 HTTP
+Server...<br />
+<br />
+This will start the simple axis server on port 9090. To see the
+possible command line options run<br />
+<br />
+<code>$ ./axis2_http_server -h</code><br />
+<br />
+NOTE 1 : You may need to login as superuser to run the
+axis2_http_server.<br />
+NOTE 2 : If you run into shared lib problems, set the LD_LIBRARY_PATH
+as follows.<br />
+ <code>$
+export
+LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib</code><br />
+</div>
+<div class="subsection"><a name="1.5.1.b"></a>
+<h4>(b) Clients</h4>
+When the axis2_http_server is up and running, you can run the sample
+clients in a new shell as follows.<br />
+<br />
+<code>$ cd ${AXIS2C_HOME}/bin/samples</code><br />
+<code>$ ./echo</code><br />
+<br />
+This will invoke the echo service.<br />
+<br />
+<code>$ ./math</code><br />
+<br />
+This will invoke the math service.<br />
+<br />
+To see the possible command line options for sample clients run them
+with '-h' option<br />
+<br />
+NOTE : If you run into shared lib problems, set the LD_LIBRARY_PATH as
+follows.<br />
+ <code>$
+export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib</code>
+</div>
+</div>
+<div class="subsection"><a name="1.5.2"></a>
+<h4>1.5.2 AMQP Transport</h4>
+<div class="subsection"><a name="1.5.2.a"></a>
+<h4>(a) Server</h4>
+Start the Qpid broker as follows.<br />
+<br />
+<code>$ cd ${QPID_HOME}/sbin</code><br />
+<code>$ ./qpidd --data-dir ./</code><br />
+<br />
+Start the axis2_amqp_server as follows.<br />
+<br />
+<code>$ cd ${AXIS2C_HOME}/bin</code><br />
+<code>$ ./axis2_amqp_server</code><br />
+<br />
+You should see the message<br />
+ Started
+Simple Axis2 AMQP Server...<br />
+<br />
+This will connect to the Qpid broker listening on 127.0.0.1:5672. To
+see the possible command line options run<br />
+<br />
+<code>$ ./axis2_amqp_server -h</code><br />
+<br />
+NOTE 1 : You have the flexibility of starting the Qpid broker first and
+then axis2_amqp_server or vise versa.<br />
+NOTE 2 : You may need to login as superuser to run the
+axis2_amqp_server.<br />
+NOTE 3 : If you run into shared lib problems, set the LD_LIBRARY_PATH
+as follows.<br />
+ <code>$
+export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib</code>
+</div>
+<div class="subsection"><a name="1.5.2.b"></a>
+<h4>(b) Clients</h4>
+When the axis2_amqp_server is up and running, you can run the sample
+clients in a new shell as follows.<br />
+<br />
+<code>$ cd ${AXIS2C_HOME}/bin/samples/amqp</code><br />
+<code>$ ./echo_blocking</code><br />
+<br />
+This will invoke the echo service.<br />
+<br />
+To see the possible command line options for sample clients run them
+with '-h' option<br />
+<br />
+NOTE : If you run into shared lib problems, set the LD_LIBRARY_PATH as
+follows.<br />
+ <code>$
+export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIS2C_HOME}/lib</code>
+</div>
+</div>
+</div>
+<div class="section"><a name="2"></a>
+<h2>2. Getting Axis2/C Working on Windows (Win32)</h2>
+<div class="subsection"><a name="2.1"></a>
+<h3>2.1 Setting up Prerequisites</h3>
+<div class="subsection"><a name="2.1.1"></a>
+<h4>2.1.1 Mandatory</h4>
+(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. <br />
+<br />
+NOTE : You can <a class="externalLink" href="http://msdn.microsoft.com/vstudio/express/downloads/">download</a>
+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.<br />
+<br />
+(b) zlib [<a class="externalLink" href="http://www.zlatkovic.com/pub/libxml">http://www.zlatkovic.com/pub/libxml</a>
+version >= zlib-1.2.3.win32]
+</div>
+<div class="subsection"><a name="2.1.2"></a>
+<h4>2.1.2 Optional</h4>
+(a) libxml2 [<a class="externalLink" href="http://www.zlatkovic.com/pub/libxml">http://www.zlatkovic.com/pub/libxml</a>
+version >= libxml2-2.6.20.win32]<br />
+(b) iconv [<a class="externalLink" href="http://www.zlatkovic.com/pub/libxml">http://www.zlatkovic.com/pub/libxml</a>
+version >= iconv-1.9.1.win32]<br />
+</div>
+</div>
+<div class="subsection"><a name="2.2"></a>
+<h3>2.2 Using Binary Release</h3>
+Extract the binary distribution to a folder of your choice.(example:
+C:\axis2c)<br />
+The C:\axis2c folder structure is as follows:<br />
+<p><img alt="Figure: c:\axis2c Folder Structure" src="images/binary_folder_structure.jpg" /></p>
+<p><em>The above folders contain the following files:</em></p>
+<ul>
+<li>bin - server and other executables</li>
+<li>bin\samples - client samples </li>
+<li>lib - library modules</li>
+<li>services - deployed services</li>
+<li>modules - deployed modules</li>
+<li>include - all Include files of Axis2/C</li>
+<li>logs - system and client logs are written to this folder</li>
+</ul>
+Copy the downloaded zlib1.dll to C:\axis2c\lib.You might
+optionally require to copy the iconv.dll and libxml2.dll as well.<br />
+(Or you can have these dll's in some other place and add that location
+to PATH environment variable)
+</div>
+<div class="subsection"><a name="2.3"></a>
+<h3>2.3 Using Source Release</h3>
+<div class="subsection"><a name="2.3.1"></a>
+<h4>2.3.1 Setting Build Options</h4>
+<p>Please edit the
+<source_distribution>\build\win32\configure.in file
+to set the following build options.</p>
+<div class="subsection"><a name="2.3.1.a"></a>
+<h4>(a) Setting zlib Location</h4>
+Set the ZLIB_BIN_DIR to the location where zlib is installed to<br />
+<br />
+Default location for zlib is E:\zlib-1.2.3.win32 and the folder
+structure should look like the following<br />
+<br />
+<img alt="Figure: C:\zlib Folder Structure" src="images/folder_structure_zlib.jpg" />
+<br />
+You can either extract zlib to this folder or extract it to a location
+of your choice and edit the configure.in file accordingly.<br />
+<br />
+NOTE : You need to have zlib1.dll in the library path.<br />
+</div>
+<div class="subsection"><a name="2.3.1.b"></a>
+<h4>(b) Enable Guththila</h4>
+<li>Set the ENABLE_GUTHTHILA option to 1</li>
+</div>
+<div class="subsection"><a name="2.3.1.c"></a>
+<h4>(c) Enable libxml2</h4>
+<li>Set the ENABLE_LIBXML2 option to 1</li>
+<li>Set the LIBXML2_BIN_DIR to the location where libxml2 is
+installed to</li>
+<li>Set the ICONV_BIN_DIR to the location where iconv is
+installed to</li>
+</div>
+<div class="subsection"><a name="2.3.1.d"></a>
+<h4>(d) Enable SSL Support</h4>
+<li>Set ENABLE_SSL option to 1</li>
+<li>Set OPENSSL_BIN_DIR to the location where OpenSSL is
+installed to</li>
+</div>
+<div class="subsection"><a name="2.3.1.e"></a>
+<h4>(e) Enable libcurl</h4>
+<li>Set ENABLE_LIBCURL to 1</li>
+<li>Set LIBCURL_BIN_DIR to the location where libcurl is
+installed to</li>
+</div>
+<div class="subsection"><a name="2.3.2"></a>
+<h4>2.3.2 Compiling the Source</h4>
+<p>The following steps will take you through the source
+compilation.</p>
+<ul>
+<li>Extract the source distribution to a folder of your choice.
+(Example: C:\axis2c)</li>
+<li>Edit the configure.in file as explained in the section 2.3.1</li>
+<li>Open a DOS shell</li>
+<li><code>cd C:\axis2c\build\win32</code></li>
+<li>to access .Net tools, run
+<ul>
+<li><code>C:\axis2c\build\win32> vcvars32.bat</code></li>
+</ul>
+<p><strong>Note</strong>: 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.</p>
+</li>
+<li>To build the system and create the binary files in a
+directory named deploy under the build directory,
+<ul>
+<li><code>C:\axis2c\build\win32>nmake install</code></li>
+</ul>
+</li>
+<li>The deploy folder structure is as follows:</li>
+<p><img alt="Figure: deploy Folder Structure" src="images/folder_structure.jpg" /></p>
+<p><em>The above folders contain the following files:</em></p>
+<ul>
+<li>bin - server and other executable</li>
+<li>bin\samples - client samples</li>
+<li>lib - library modules</li>
+<li>services - deployed services</li>
+<li>modules - deployed modules</li>
+<li>include - all include files of Axis2 C</li>
+<li>logs - system and client logs are written to this folder</li>
+</ul>
+</ul>
+</div>
+</div>
+<div class="subsection"><a name="2.4"></a>
+<h3>2.4 Running Samples</h3>
+You need to set a couple of environment variables before you can run
+the server and samples.<br />
+<br />
+Set the variable AXIS2C_HOME to the deploy folder (C:\axis2c)<br />
+Add the path to lib directory to the PATH variable (%AXIS2C_HOME%\lib)<br />
+<br />
+Copy iconv.dll and zlib1.dll to the %AXIS2C_HOME%\lib folder.<br />
+<br />
+You might optionally require to copy the libxml2.dll to the
+%AXIS2C_HOME%\lib folder.<br />
+<div class="subsection"><a name="2.4.1"></a>
+<h4>2.4.1 HTTP transport</h4>
+<div class="subsection"><a name="2.4.1.a"></a>
+<h4>(a) Server</h4>
+<code>> cd %AXIS2C_HOME%\bin</code><br />
+<code>> axis2_http_server.exe </code><br />
+<br />
+You should see the message<br />
+ Started
+Simple Axis2 HTTP Server...<br />
+<br />
+By default the log is created under %AXIS2C_HOME%\logs folder with the
+name axis2.log.<br />
+<br />
+NOTE : You may provide command line options to change the default
+behaviour. Type 'axis2_http_server.exe -h' to learn about the usage
+</div>
+<div class="subsection"><a name="2.4.1.b"></a>
+<h4>(b) Clients</h4>
+Now you can run any sample client deployed under
+%AXIS2C_HOME%\bin\samples\<br />
+<br />
+Example:<br />
+<ul>
+<code>> cd %AXIS2C_HOME%\bin\samples</code><br />
+<code>> echo.exe</code>
+</ul>
+</div>
+</div>
+</div>
+</div>
+<div class="section"><a name="3"></a>
+<h2>3. Installing Apache2 Web Server Integration Module
+(mod_axis2)</h2>
+<div class="subsection"><a name="3.1"></a>
+<h3>3.1 Building mod_axis2 from Source</h3>
+<div class="subsection"><a name="3.1.1"></a>
+<h4>3.1.1 On Linux</h4>
+Provide the Apache2 include file location as a configure option<br />
+<br />
+<code>$ ./configure --with-apache2="<apache2 httpd include
+files location>" [other
+configure options]</code><br />
+<br />
+NOTE : Some apache2 distributions install APR (Apache Portable Runtime)
+include files in a separate location which is required to build
+mod_axis2.<br />
+<br />
+In that case use:<br />
+<code>$ ./configure --with-apache2="<apache2 include files
+location>" --with-apr="<apr include files
+location>" [other configure options]</code><br />
+<br />
+Then build the source tree<br />
+<code>$ make</code><br />
+<code>$ make install</code><br />
+<br />
+This will install mod_axis2.so into your
+"<your_path_to_axis2c>/lib"
+</div>
+<div class="subsection"><a name="3.1.2"></a>
+<h4>3.1.2 On Windows (Win32)</h4>
+Provide the apache2 location in configure.in file in APACHE_BIN_DIR<br />
+<br />
+Example:<br />
+APACHE_BIN_DIR = E:\Apache22<br />
+<br />
+After compiling the sources (as described in section 2.3) build the
+mod_axis2.dll by issuing the command 'nmake axis2_apache_module'.<br />
+This will build mod_axis2.dll and copy it to %AXIS2C_HOME%\lib
+directory.<br />
+<br />
+Example:<br />
+C:\axis2c\build\deploy\lib </div>
+</div>
+<div class="subsection"><a name="3.2"></a>
+<h3>3.2 Deploying in Apache2 Web Server</h3>
+NOTE : To do the following tasks, you might need super user privileges
+on your machine.<br />
+<br />
+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 <br />
+<br />
+Example:<br />
+<code>cp $AXIS2C_HOME/lib/libmod_axis2.so.0.3.1
+/usr/lib/apache2/modules/mod_axis2.so </code>(on Linux)<br />
+<code>copy C:\axis2c\build\deploy\lib\mod_axis2.dll
+C:\Apache2\modules\mod_axis2.so </code>(on Windows)<br />
+<br />
+Edit the Apache2's configuration file (generally httpd.conf) and add
+the following directives<br />
+<br />
+LoadModule axis2_module <apache2 modules
+directory>/mod_axis2.so<br />
+Axis2RepoPath <axis2 repository path><br />
+Axis2LogFile <axis2 log file path><br />
+Axis2MaxLogFileSize <maximum size of log file><br />
+Axis2LogLevel LOG_LEVEL<br />
+<Location /axis2><br />
+SetHandler axis2_module<br />
+</Location><br />
+<br />
+NOTE:
+<ul>
+Axis2 log file path should have write access to all users because
+by default Apache Web Server runs as nobody.<br />
+<br />
+If you want to use a Shared Global Pool with Apache you have to give
+another entry called Axis2GlobalPoolSize. <br />
+You have to give the size of the shared global pool in MB. <br />
+If you don't set the value or if you set a negative value Apache module
+doesn't create shared global pool.<br />
+<br />
+Axis2GlobalPoolSize <global pool size in mb> <br />
+</ul>
+<br />
+LOG_LEVEL can be one of the followings<br />
+<ul>
+<li>crit - Log critical errors only</li>
+<li>error - Log errors critical errors</li>
+<li>warn - Log warnings and above</li>
+<li>info - Log info and above</li>
+<li>debug - Log debug and above (default)</li>
+<li>trace - Log trace messages</li>
+</ul>
+<br />
+NOTE: Use forward slashes "/" for path separators in <apache2
+modules directory>, <axis2 repository path> and
+<axis2 log file path><br />
+<br />
+Make sure that the apache2 user has the correct permissions to above
+paths<br />
+- Read permission to the repository<br />
+- Write permission to the log file<br />
+<br />
+Restart apache2 and test whether mod_axis2 module is loaded by typing
+the URL <a href="http://localhost/axis2/services" class="externalLink">http://localhost/axis2/services</a>
+in your Web browser
+</div>
+</div>
+<div class="section"><a name="4"></a>
+<h2>4. Installing IIS (Interner Information Server) Integration
+Module (mod_axis2_IIS)</h2>
+<div class="subsection"><a name="4.1"></a>
+<h3>4.1 Building mod_axis2_IIS from Source</h3>
+After compiling the source (as described in section 2.3) build the
+mod_axis2.dll by issuing the command 'nmake axis2_IIS_module'.<br />
+This will build the mod_axis2_IIS.dll and copy it to %AXIS2C_HOME%\lib
+directory.<br />
+<br />
+Example:<br />
+C:\axis2c\build\deploy\lib </div>
+<div class="subsection"><a name="4.2"></a>
+<h3>4.2 Deploying in the IIS</h3>
+Add the following key to the registery.<br />
+<br />
+HKEY_LOCAL_MACHINE\SOFTWARE\Apache Axis2c\IIS ISAPI Redirector<br />
+<br />
+Under this registry key add the following entries.<br />
+<br />
+A String value with the name "axis2c_home". The value is the
+AXIS2C_HOME.<br />
+Example : c:\axis2c<br />
+<br />
+A String value with the name "log_file". The value is the absolute path
+of the log file.<br />
+Example: c:\axis2c\logs\axis2.log<br />
+<br />
+A String value with the name "log_level". The value can be one of the
+followings.<br />
+<ul>
+<li>trace - Log trace messages</li>
+<li>error - Log errors critical errors</li>
+<li>info - Log info and above</li>
+<li>critical - Log critical errors only </li>
+<li>debug - Log debug and above (default)</li>
+<li>warning - Log warnings</li>
+</ul>
+Using the IIS management console, add a new virtual directory to the
+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)<br />
+Assign excecute permissions to this virtual directory.<br />
+<br />
+Using the IIS management console, add mod_axis2_IIS.dll as a filter to
+the IIS/PWS web site. <br />
+The name of the filter can be any meaningful name. <br />
+<br />
+Restart IIS and test whether mod_axis2_IIS module is loaded by typing
+the URL <a href="http://localhost/axis2" class="externalLink">http://localhost/axis2</a>
+in your Web browser.
+</div>
+</div>
+</div></div></body></html>