rangika 2004/12/19 22:14:48
Modified: targets/axis/cpp lininstall-guide.pdf lininstall-guide.html
index.pdf index.html documentation.html
Log:
Modifed the Lin Install guide by explaining that the expat parser is not
supported in 1.4 Final. Also modified the documentation.html & index.html
Revision Changes Path
1.29 +379 -77 ws-site/targets/axis/cpp/lininstall-guide.pdf
<<Binary file>>
1.33 +56 -7 ws-site/targets/axis/cpp/lininstall-guide.html
Index: lininstall-guide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cpp/lininstall-guide.html,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- lininstall-guide.html 17 Dec 2004 10:34:27 -0000 1.32
+++ lininstall-guide.html 20 Dec 2004 06:14:48 -0000 1.33
@@ -299,35 +299,57 @@
</li>
</ul>
<p>
+<strong>Note:</strong>The Expat XML Parser module is not currently
maintained and also contains some bugs. So it is removed from the 1.4 release.
Please ignore any references to the Expat parser in the documentation. The
documentation will be updated regarding this later.</p>
+<p>
<a name="Introduction"></a>
</p>
+<div class="h3">
<h3>Introduction</h3>
+</div>
<p>This guide will help you to start with Axis C++. This guide will explain
the minimum steps needed to build and run Axis C++, and warn you about the
common pitfalls.</p>
<p>
<a name="What"></a>
</p>
+<div class="h3">
<h3>What You Need</h3>
+</div>
<p>You need a few helper libraries for parsing XML, WSDL processing and
introspection. You need to have the following in order to run Axis C++
engine.</p>
<p> <a
href="http://httpd.apache.org/download.cgi";>Apache web server</a> (2.0.x or
1.3.x) - You need to have Apache built with module so support, hence you
need to have the source of Apache web server.<br>
<br> Axis C++ uses Apache web server to host services.<br>
</p>
<br>
-<p> <a
href="http://sourceforge.net/projects/expat/";>Expat (1.95.7)</a> and/or <a
href="http://archive.apache.org/dist/xml/xerces-c/Xerces-C_2_2_0/";>Xerces C++
(2.2.0)</a> XML parser(s)<br>
-<br> Axis C++ needs an XML parser to parse SOAP messages and WSDD files. It
has a parser abstraction layer that helps users to select/switch between
parsers. However only one parser library could be used at a time. Currently
only Xerces parsers are supported by Axis C++. Earlier Expat parser was also in
use, but due to lack of maintainance it is now under graveyard.(graveyard is
the place where obsolete modules were put into rest. If somebody wants to
resurrect them go to the graveyard in $AXISCPP_HOME/graveyard)<br>
+<p> <a
href="http://sourceforge.net/projects/expat/";>Expat (1.95.7)</a>
(<strong>Note:</strong>The Expat XML Parser module is not currently maintained
and also contains some bugs. For more information refer the contents
section.)<br>
+<br> and/or<br>
+<br>
+<a href="http://archive.apache.org/dist/xml/xerces-c/Xerces-C_2_2_0/";>Xerces
C++ (2.2.0)</a> XML parser(s)<br>
+<br> Axis C++ needs an XML parser to parse SOAP messages and WSDD files. It
has a parser abstraction layer that helps users to select/switch between
parsers. However only one parser library could be used at a time. Currently
Xerces parser is supported by Axis C++.<br>
</p>
<br>
<p>
<a name="Install"></a>
</p>
+<div class="h3">
<h3>Installing Axis C++</h3>
+</div>
+<div class="h4">
<h4>1. Install Apache Web Server</h4>
+</div>
<p>In case you have already installed Apache , make sure that 'so modules'
are enabled.<br> This is because Axis C++ server engine is implemented as a 'so
module'. (For Apache 1.3.x use --enable-module=so; for Apache 2.0.x use
--enable-so when configuring. See Apache web server documentation for more
details)</p>
+<div class="h4">
<h4>2. Install Expat (1.95.7) and/or Xerces C++ (2.2.0)</h4>
+</div>
+<p>
+<strong>Note:</strong>The Expat XML Parser module is not currently
maintained and also contains some bugs. For more information refer the contents
section.</p>
<p>Select an XML parser depending on your parser preferences. See the
respective parser's documentation for installation instructions.</p>
+<br>
+<div class="h4">
<h4>3. Download Axis C++</h4>
+</div>
<p>
<a href="http://ws.apache.org/axis/cpp/download.html";>Download Axis C++</a>
source or binary distribution and extract the package.</p>
+<div class="h4">
<h4>4. Define the Environment Variables.</h4>
+</div>
<p>
<strong>AXISCPP_HOME="Path to Axis C++ source or binary extracted
folder"</strong>
<br> e.g. <strong>AXISCPP_HOME="/my/home/axiscpp"</strong>
@@ -340,9 +362,11 @@
<br>
<strong>export AXISCPP_HOME AXISCPP_DEPLOY LD_LIBRARY_PATH</strong>
</p>
+<div class="h4">
<h4>5. Build Axis C++</h4>
+</div>
<p>
-<strong>Note:</strong> If you have downloaded Axis C++ binaries, you can
skip this step<br>
+<strong>Note:</strong> The following steps are for Axis C++ source
downloads.<br>
<br>
<strong>cd $AXISCPP_HOME</strong>
<br>
@@ -354,11 +378,17 @@
<strong>make install</strong>
<br>
<br> The above set of instructions assume you have Apache 2.0.x web server
and Xerces C++ parser.<br>For more information on build options run
<strong><em>./configure --help</em></strong>.<br>
-<br>The libs created in build process are placed in $AXISCPP_DEPLOY/lib.
(Provided that you used $AXISCPP_DEPLOY as --prefix option for configuring).
Note that you need permission to install to the specified directory given in
prefix option.<br> <br>You need global access rights to the Axis C++
deploy folder to make sure that Axis C++ works properly.<br>
+<br>The libs created in build process are placed in $AXISCPP_DEPLOY/lib.
(Provided that you used $AXISCPP_DEPLOY as --prefix option for configuring).
Note that you need permission to install to the specified directory given in
prefix option.<br> <br>
+</p>
+<p>
+<strong>Note:</strong> The following steps are common to both source and
binary downloads.<br>
+<br> You need global access rights to the Axis C++ deploy folder to make
sure that Axis C++ works properly.<br>
<br>
<em>chmod -R 777 $AXISCPP_DEPLOY</em>
</p>
+<div class="h4">
<h4>6. Configure Apache Module</h4>
+</div>
<p>
<strong>Note:</strong> to execute the following steps, you may need to have
<strong>super user rights</strong> on your machine.<br>
<br> Now you need to edit <strong>httpd.conf</strong> file in <path to
Apache web server installation>/conf and add the following lines at the
bottom of that file (assuming you are using Apache 2.0.x):<br>
@@ -374,9 +404,13 @@
<br>For Apache1.3.x LoadModule line should read as:<br>
<strong>LoadModule axis_module libexec/libaxiscpp_mod.so</strong>
</p>
+<div class="h4">
<h4>7. Configure Server Deployment Descriptor File</h4>
+</div>
<p>Now you need the server deployment descriptor (server.wsdd) to deploy
server samples you built.<br> There is a sample deployment descriptor called
server.wsdd_linux in $AXISCPP_DEPLOY/etc to help to deploy samples.<br> Edit
this file to match your system settings (because the server.wsdd_linux file
assumes that you have installed the binaries in /usr/local/axiscpp_deploy, you
may need to change the folder names) and copy it to server.wsdd.<br>server.wsdd
file is an XML file, and the contents are self descriptive.</p>
+<div class="h4">
<h4>8. Set Engine Wide Settings in Configuration File</h4>
+</div>
<p>Axis C++ uses a configuration file to let the user specify preferences
such as log file locations, transport and parser libs to be used and location
of deployment descriptor files.<br> A sample configuration file named
axiscpp.conf_linux is installed in $AXISCPP_DEPLOY/etc folder. Edit this file
to match your systems settings (because the axiscpp.conf_linux file assumes
that you have installed the binaries in /usr/local/axiscpp_deploy, you may need
to change the folder names) and copy it to axiscpp.conf<br>
<br> Configuration file has the following <strong>Syntax:</strong>
</p>
@@ -390,7 +424,9 @@
XMLParser:/usr/local/axiscpp_deploy/lib/libaxis_xercesc.so
Transport_http:/usr/local/axiscpp_deploy/lib/libaxis2_transport.so
</pre>
+<div class="h4">
<h4>9. Deploying with Apache Web Server</h4>
+</div>
<p>Now we need to copy Apache module (libaxiscpp_mod2.so for Apache 2.0.x
and libaxiscpp_mod.so for Apache 1.3.x) to the correct places and start Apache
web server. The steps to follow are:</p>
<ol>
<li>Copy libaxiscpp_mod2.so to /<your Apache 2.0.x home>/modules (or
copy libaxiscpp_mod.so to /<your Apache 1.3.x home>/libexec)</li>
@@ -405,12 +441,19 @@
<p>To deploy with Apache 1.3.x</p>
<strong>sh deploy_apache.sh</strong>
<br>
-<p>Note that these scripts rename libaxis_xercesc.so (the default parser
library) to libaxis_xmlparser.so.<br>
-<br> if you need to use a different parser or want to switch parsers time to
time, you need to edit the script and comment out the line:<br>
+<p>
+<strong>Note:</strong> please rename libaxis_xercesc.so (the default parser
library) to libaxis_xmlparser.so.<br>
+<br> if you need to use a different parser or want to switch parsers time to
time, you need to edit the script and comment out the line:<br>
+<br>
+</p>
+<p>
+<strong>Note:</strong>The Expat XML Parser module is not currently
maintained and also contains some bugs. For more information refer the contents
section.</p>
<strong>cp -f ${AXISCPP_DEPLOY}/lib/libaxis_xercesc.so
${AXISCPP_DEPLOY}/lib/libaxis_xmlparser.so</strong>
<br>
-<br>and make sure that you have specified the name of the parser lib
correctly in your config file ${AXISCPP_DEPLOY}/etc/axiscpp.conf.</p>
+<br>
+<div class="h4">
<h4>10. See Axis C++ in action</h4>
+</div>
<p>Now the installation is complete. You can verify that the server side is
working by accessing the URL <a
href="http://localhost/axis";>http://localhost/axis</a> using your web browser.
You should get the Axis C++ welcome page and this page will show you a list of
deployed services as specified by the $AXISCPP_DEPLOY/conf/server.wsdd file.</p>
<br>
<p>Now you can run a client sample and see if it works.</p>
@@ -418,7 +461,9 @@
<br>
<strong>./base</strong>
<p>To help you run several samples at once there is a script named
<strong>run_interoptests.sh</strong> in $AXISCPP_DEPLOY/bin folder. You can try
running that as well.</p>
+<div class="h4">
<h4>11. Simple axis server installation</h4>
+</div>
<p>1. Build the source distribution as mentioned above.</p>
<p>2. Make sure that you have set the <strong>AXISCPP_DEPLOY</strong>
environment variable to point to your deployment folder as mentioned above</p>
<p>3.Copy <strong>$AXISCPP_DEPLOY/etc/axiscpp.conf_linux</strong> to
<strong>$AXISCPP_DEPLOY/etc/axiscpp.conf</strong>
@@ -443,6 +488,10 @@
<strong>./base http://localhost:9090/axis/base</strong>
</p>
<p>Similarly you could run the other samples.</p>
+<p>Similarly you could run the other samples.</p>
+<a href="lininstall-guide.pdf"><img alt="PDF"
src="../skin/images/pdfdoc.gif"><br> PDF</a>
+<br>
+<br>
<div id="pdf" align="right">
<a href="lininstall-guide.pdf"><img alt="PDF"
src="../skin/images/pdfdoc.gif" class="skin"><br>
PDF</a>
1.21 +37 -37 ws-site/targets/axis/cpp/index.pdf
<<Binary file>>
1.26 +14 -7 ws-site/targets/axis/cpp/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cpp/index.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- index.html 17 Dec 2004 10:34:26 -0000 1.25
+++ index.html 20 Dec 2004 06:14:48 -0000 1.26
@@ -7,7 +7,7 @@
<link rel="stylesheet" href="../skin/mysite.css" type="text/css">
<link rel="stylesheet" href="../skin/site.css" type="text/css">
<link media="print" rel="stylesheet" href="../skin/print.css"
type="text/css">
-<title>Axis C++ 1.4 Alpha is Available!</title>
+<title>Axis C++ 1.4 Final is Available!</title>
</head>
<body bgcolor="white" class="composite">
<!--================= start Banner ==================-->
@@ -214,7 +214,7 @@
<span class="menuLabel">Translation</span>
<div class="menuItem">
-<a href="http://ws.apache.org/axis/jp/";>Japanese</a>
+<a href="http://ws.apache.org/axis/jp/";>Japanese (Unofficial)</a>
</div>
</div>
@@ -275,24 +275,25 @@
<div id="bodycol">
<div class="app">
<div align="center">
-<h1>Axis C++ 1.4 Alpha is Available!</h1>
+<h1>Axis C++ 1.4 Final is Available!</h1>
</div>
<div class="h3">
<div class="h3">
-<h3>Axis C++ 1.4 Alpha</h3>
+<h3>Axis C++ 1.4 Final</h3>
</div>
<p>
<a href="download.html">Download Axis C++</a>
</p>
<br>
<div class="h3">
-<h3>Key features of Axis C++ 1.4 Alpha</h3>
+<h3>Key features of Axis C++ 1.4 Final</h3>
</div>
<br>
<br>
<p>
<strong>SSL Implementation</strong>
-</p>
+<br>
+<br>An Axis C++ SSL secure client can access web services hosted on a secure
web service.<br>The SSL implementation for the client in Axis C++ uses the
openssl opensource library.</p>
<br>
<br>
<p>
@@ -419,7 +420,13 @@
<br>Once a Handler gets access to the SOAP body it is the duty of the
Handler to reset the new SOAP body through the SoapDeSerializer's
"setNewSoapBody" method.<br>
<br>
</p>
-<p>Added a transport that supports IPV6.<br>
+<p>
+<strong>Added a transport that supports IPV6.</strong>
+<br>
+<br> This supports IPV6 protocol.The standard API for IPV6 is used in the
IPV6 transport implementation. This transport is capable of working with both
IPV6 and IPV4.</p>
+<p>
+<strong>Keep Alive support for transport</strong>
+<br>
<br>
</p>
<br>
1.19 +1 -1 ws-site/targets/axis/cpp/documentation.html
Index: documentation.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cpp/documentation.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- documentation.html 17 Dec 2004 10:34:26 -0000 1.18
+++ documentation.html 20 Dec 2004 06:14:48 -0000 1.19
@@ -282,7 +282,7 @@
<h3>Documentation</h3>
</div>
<br>
-<a href="index.html">Apache Axis C++ 1.4 Alpha</a>
+<a href="index.html">Apache Axis C++ 1.4 Final</a>
<div class="h4">
<h4>Installation Guides</h4>
</div>
