axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rang...@apache.org
Subject cvs commit: ws-axis/c/docs linuser-guide.pdf linuser-guide.html lininstall-guide.pdf lininstall-guide.html
Date Thu, 16 Dec 2004 05:21:13 GMT
rangika     2004/12/15 21:21:13

  Modified:    c/docs   linuser-guide.html lininstall-guide.pdf
                        lininstall-guide.html
  Added:       c/docs   linuser-guide.pdf
  Log:
  Added SSL Client details to Lin User Guide and added a note saying that currently expat parser is not maintained.
  
  Revision  Changes    Path
  1.5       +127 -26   ws-axis/c/docs/linuser-guide.html
  
  Index: linuser-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-axis/c/docs/linuser-guide.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- linuser-guide.html	20 Oct 2004 03:37:39 -0000	1.4
  +++ linuser-guide.html	16 Dec 2004 05:21:13 -0000	1.5
  @@ -33,7 +33,7 @@
   <a href="#Server">ServerSide Skeleton and Wrappers generated by WSDL2ws Tool.</a>
   </dd>
   <dd>
  -<a href="#Deploying">Deploying Services</a>
  +<a href="#Deploying">Building and Deploying the Service</a>
   </dd>
   <dd>
   <a href="#Client">Client side Stubs Generated by the wsdl2ws Tool</a>
  @@ -46,6 +46,9 @@
   </dd>
   <dd>
   <a href="#handlers">Handlers</a>
  +</dd>
  +<dd>
  +<a href="#ssl">SSL Client</a>
   <br>
   </dd>
   <dd>
  @@ -55,23 +58,23 @@
   <br>
   </dd>
   <dt>
  -<a href="#Download1">Download Binary</a>
  +<a href="#Download">Download Binary</a>
   </dt>
   <dd>
  -<a href="#Server1">ServerSide Skeleton and Wrappers generated by WSDL2ws Tool.</a>
  +<a href="#Server">ServerSide Skeleton and Wrappers generated by WSDL2ws Tool.</a>
   </dd>
   <dd>
  -<a href="#Deploying1">Deploying Services</a>
  +<a href="#Deploying">Building and Deploying Service</a>
   </dd>
   <dd>
  -<a href="#Client1">Client side Stubs Generated by the wsdl2ws Tool</a>
  +<a href="#Client">Client side Stubs Generated by the wsdl2ws Tool</a>
   </dd>
   <dd>
  -<a href="#bss">Building Server Side for provided Samples</a>
  +<a href="#sps">Building Server Side for provided Samples</a>
   <br>
   </dd>
   <dd>
  -<a href="#bcs">Building Client Side for provided Samples</a>
  +<a href="#scls">Building Client Side for provided Samples</a>
   </dd>
   <dd>
   <br>
  @@ -99,7 +102,7 @@
   <a name="What"></a>
   </p>
   <div class="h3">
  -<h3>What's you can find in axis c++</h3>
  +<h3>What's in this release?</h3>
   </div>
   <p>- Soap engine with both client and server support</p>
   <p>- Support for both SOAP 1.1 and SOAP 1.2</p>
  @@ -131,7 +134,7 @@
   <p>- Stability , Component oriented Deployment</p>
   <p>- Transport Framework</p>
   <p>- WSDL support</p>
  -<p>AxisC++ supports the Web Service Description Language, version 1.1, which allows you to easily build stubs to access remote services, and also to automatically export machine-readable descriptions of your deployed services from Axis. We hope you enjoy using Axis c++. Please note that this is an open-source effort - if you feel the code could use some new features or fixes, please get involved and lend a hand! The Axis developer community welcomes your participation. Let us know what you think! Please send feedback about the package to <a href="mailto:axis-user@xml.apache.org">axis-user@xml.apache.org</a>
  +<p>AxisC++ 1.1 supports the Web Service Description Language, version 1.1, which allows you to easily build stubs to access remote services, and also to automatically export machine-readable descriptions of your deployed services from Axis. We hope you enjoy using Axis c++ 1.1. Please note that this is an open-source effort - if you feel the code could use some new features or fixes, please get involved and lend a hand! The Axis developer community welcomes your participation. Let us know what you think! Please send feedback about the package to <a href="mailto:axis-user@xml.apache.org">axis-user@xml.apache.org</a>
   </p>
   <p>
   <a name="What1"></a>
  @@ -141,7 +144,8 @@
   <h3>Installing Axis and Using this Guide</h3>
   </div>
   <p>See the Axis Installation Guide for instructions on installing Axis C++</p>
  -<p>Before running the examples in this guide, you'll need to make sure that your environment variables and other configurations are set correctly as described in Installation guide. In addition you need</p>
  +<p>Before running the examples in this guide, you'll need to make sure that your environment variables and other configurations are set correctly as described in Installation guide. In addition you need </p>
  +
   <p>- j2SDK1.4</p>
   <p>installed and configured.</p>
   <p>
  @@ -194,8 +198,8 @@
   <p> There are two options to create the wsdl2ws.jar tool<br> <br>
   <b> 1st Option is using ANT (This is more reliable) </b> <br> <br>
   In your PATH environment variable add path to &lt;antinstall dir&gt/bin. <br> 
  -<strong>$ cd $AXISCPP_HOME/src/wsdl/</strong> <br>
  -<strong> $ ant </strong> 
  +<strong>$ cd $AXISCPP_HOME/src/wsdl/</strong> 
  +$ ant 
   </p>
   <p> <b>2nd Option (Some users have experienced difficulties in using this option)</b> </p>
   <p><strong>$ cd $AXISCPP_HOME/src/wsdl/</strong>
  @@ -215,7 +219,7 @@
   <p>
   <strong>$cp -f wsdl2ws.jar $AXISCPP_HOME/lib/axis</strong>
   </p>
  -<p>add this jar as the first entry into the classpath as well. It is very important to put this before the entries to axis jars in your class path.(In the binary distribution you don't need to create this jar. It is already in $AXISCPP_DEPLOY/lib/axis)</p>
  +<p>add this jar as the first entry into the classpath as well.(In the binary distribution you don't need to create this jar. It is already in $AXISCPP_HOME/lib/axis)</p>
   <p>
   <a name="Server"></a>
   </p>
  @@ -246,19 +250,20 @@
   </p>
   <p>Note: If you give <strong>-o. /GenClassesServer</strong> then the server create a folder named GenClassServer and put the source there. Otherwise the source is put in the current folder where the tool is run.</p>
   <p>
  -
  -<a name="Building and deploying"></a>
  +<a name="Deploying"></a>
   </p>
   <div class="h3">
  -<h3>Building and deploying the service</h3>
  +<h3>Building and Deploying the Service</h3>
   </div>
  -<p>To build the service library</p> <br>
  -<strong> g++ -shared -I$AXISCPP_HOME/include -olibmyservice.so *.cpp </strong><br>
  -<p> libmyservice.so is the name you give to your service library. You can give any name you wish.
  -But remeber to prefix with lib and suffix with .so</p>
  -Copy this service library into $AXICPP_DEPLOY/lib
  +<p> To build the service library </p>
  +
  +<p> <strong> g++ -shared -I$AXISCPP_HOME/include -olibmyservice.so *.cpp </strong> </p>
  +
  +<p>  libmyservice.so is the name you give to your service library. You can give any name you wish. But remeber to prefix with lib and suffix with .so </p>
   
  -<p>Modify the <strong>$AXISCPP_DEPLOY/etc/</strong><strong>server.wsdd</strong> .&nbsp; (You have a sample server.wsdd file entry given below appropriately filled for this service).</p>
  +<p> Copy this service library into $AXICPP_DEPLOY/lib  </p>
  +
  +<p>Modify the <strong>$AXIS_HOME/conf/</strong><strong>server.wsdd</strong> .&nbsp; (You have a sample server.wsdd file entry given below appropriately filled for this service).</p>
   <p>
   <strong>&lt;?xml version="1.0" encoding="UTF-8"?&gt;</strong>
   <br> 
  @@ -275,7 +280,7 @@
   <p>
   <strong>&lt;/deployment&gt;</strong>
   </p>
  -<p>Restart the Apache server</p>
  +<p>Start the Apache server</p>
   <p>
   <strong>$ /usr/local/apache/bin/apachectl start</strong>
   </p>
  @@ -316,7 +321,9 @@
   <br> 
   <strong>&nbsp;&nbsp;Calculator c;</strong>
   <br> 
  -<strong>&nbsp;&nbsp;intOut = c.add(20, 40);</strong>
  +<strong>&nbsp;&nbsp;int intOut;</strong>
  +<br> 
  +<strong>&nbsp;&nbsp;c.add(20, 40, intOut);</strong>
   <br> 
   <strong>&nbsp;&nbsp;printf("result is = %d\n", intOut);</strong>
   <br> 
  @@ -325,13 +332,16 @@
   <strong>&nbsp;}</strong>
   </p>
   <p>Then build by<br> 
  -<strong>cd $AXISCPP_HOME/samples/client/simple</strong>
  +<strong>cd $AXISCPP_HOME/samples/client</strong>
   <br>
   </p>
   <p>
  -<strong>g++ -I$AXISCPP_HOME/include -L$AXISCPP_DEPLOY/lib -laxiscpp_client -ldl -oclient *.cpp</strong>
  +<strong>sh build.sh</strong>
   <br>Then to run the calculator sample</p>
   <p>
  +<strong>$ cd AXISCPP_HOME/samples/simple</strong>
  +</p>
  +<p>
   <strong>./calculator &lt;server&gt; &lt;port&gt; &nbsp;&lt;command&gt; &nbsp;&lt;param1&gt; &nbsp;&lt;param2&gt;</strong>
   <br>
   <br> Example:<br>
  @@ -347,6 +357,81 @@
   <br>
   </p>
   <div class="h3">
  +<h3>Building Serverside of &nbsp;provided Samples</h3>
  +</div>
  +<p>Basically this will include all the Interoptest Samples and calculator sample.</p>
  +<br>
  +<p>
  +<strong>cd $AXISCPP_HOME/samples/server</strong>
  +</p>
  +<p>
  +<strong>$ sh autogen.sh</strong>
  +</p>
  +<p>
  +<strong>$ sh runconfig</strong>
  +</p>
  +<p>
  +<strong>$ make</strong>
  +</p>
  +<p>
  +<strong>$ make install<br>
  +</strong>
  +</p>
  +<p>
  +<strong>OR<br>
  +</strong>
  +</p>
  +<p>
  +<strong>$ sh build.sh&nbsp;<br>
  +</strong>
  +</p>
  +<p>Once you type the above command all the samples will be deployed in $AXIS_HOME/webservices folder.<br>you also have sample $AXIS_HOME/conf/server.wsdd_linux file which you should rename to server.wsdd,<br>which contain all the neccessary entries for these sevices.<br>
  +<br>
  +</p>
  +<strong>Restart Apache</strong>
  +<br>
  +<p>
  +<a name="scls"></a>
  +</p>
  +<br>
  +<div class="h3">
  +<h3>Building Client Side of the provided samples</h3>
  +</div>
  +<p>
  +<strong>cd $AXISCPP_HOME/samples/client</strong>
  +</p>
  +<p>
  +<strong>$ sh autogen.sh</strong>
  +</p>
  +<p>
  +<strong>$ sh runconfig</strong>
  +</p>
  +<p>
  +<strong>$ make</strong>
  +</p>
  +<p>
  +<strong>$ make install<br>
  +</strong>
  +</p>
  +<p>
  +<strong>OR<br>
  +</strong>
  +</p>
  +<strong>$ sh build.sh</strong>
  +<br>
  +<br>
  +<p>sample executables will be created in your current folder.<br>to run samples one by one</p>
  +<p>
  +<strong><strong>$ ./base localhost 80 &nbsp;</strong></strong>
  +</p>
  +<p>
  +<strong><strong>
  +<br>
  +</strong></strong>
  +</p>
  +<p>to run all the samples at once<br>sh run_interoptests.sh (Note: local host and port 80 is assumed)</p>
  +<p>
  +<strong></strong>
   </p>
   <br>
   <p>
  @@ -485,9 +570,25 @@
   <strong><strong><strong>cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout -d &lt;your local folder&gt; ws-axis/c"</strong></strong></strong>
   </p>
   <br>
  +
  +<p><a name="ssl"></a> </p>
  +<h3>SSL Client </h3>
  +<p>To build the ssl channel library configure with <br>
  +configure --with-axis2-ssl=PATH <br> <br>
  +Add the following entry to the axiscpp.conf  <br> <br>
  +<b>Channel_ssl:/usr/local/axiscpp_deploy/lib/libaxis2_ssl_channel.so </b> <br> <br>
  +<b>Note:</b>If you don't add the above entry, lib will be taken from LD_LIBRARY_PATH <br> </p>
  +<p>Then send your request with https://... <br> <br>
  +Axis2Transport loads the ssl channel library when it is https and sends your
  +request through ssh tunnelling. <br> <br>
  +Currently I use openssl libraries for ssh tunnelling. <br> <br>
  +The API to write a new ssl channel library(using a library other than openssl) is in <b>src/transport/SSLChannel.hpp </b> <br> <br>
  +All openssl ssl related implementations are  in <b>src/transport/axis2/ssl folder</b> 
  +
   <br>
   <div id="pdf" align="right">
   <a href="linuser-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
             PDF</a>
  +</p>
   </body>
   </html>
  
  
  
  1.3       +179 -162  ws-axis/c/docs/lininstall-guide.pdf
  
  	<<Binary file>>
  
  
  1.7       +236 -464  ws-axis/c/docs/lininstall-guide.html
  
  Index: lininstall-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-axis/c/docs/lininstall-guide.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- lininstall-guide.html	22 Oct 2004 11:48:58 -0000	1.6
  +++ lininstall-guide.html	16 Dec 2004 05:21:13 -0000	1.7
  @@ -1,287 +1,16 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   <html>
   <head>
  -<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  -<!--*** This is a generated file.  Do not edit.  ***-->
  -<link rel="stylesheet" href="../skin/tigris.css" type="text/css">
  -<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++ Linux Installation Guide</title>
  +  <meta http-equiv="Content-Type" content="text/html">
  +  <title>Axis C++ Linux Installation Guide</title>
   </head>
  -<body bgcolor="white" class="composite">
  -<!--================= start Banner ==================-->
  -<div id="banner">
  -<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
  -<tbody>
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td align="left">
  -<div class="groupLogo">
  -<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../images/project-logo.jpg"></a>
  -</div>
  -</td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td align="right">
  -<div class="projectLogo">
  -<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../images/axis.jpg"></a>
  -</div>
  -</td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2" align="right" class="search">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
  -</tr>
  -<tr>
  -<td colspan="3"><img height="8" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="GO" type="submit">
  -<br>
  -                          Search WS</td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
  -</tr>
  -<tr>
  -<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
  -</tr>
  -<tr>
  -<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= end Search ==================-->
  -</tr>
  -</tbody>
  -</table>
  -</div>
  -<!--================= end Banner ==================-->
  -<!--================= start Main ==================-->
  -<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
  -<tbody>
  -<!--================= start Status ==================-->
  -<tr class="status">
  -<td>
  -<!--================= start BreadCrumb ==================--><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a>
  -<!--================= end BreadCrumb ==================--></td><td id="tabs">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<span class="selectedTab"><a class="base-selected" href="../index.html">WebServices-Axis</a></span>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td>
  -</tr>
  -</tbody>
  -</table>
  -<!--================= end Status ==================-->
  -<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
  -<tbody>
  -<tr valign="top">
  -<!--================= start Menu ==================-->
  -<td id="leftcol">
  -<div id="navcolumn">
  -<div class="menuBar">
  -<div class="menu">
  -<span class="menuLabel">Axis</span>
  - 
  -<div class="menuItem">
  -<a href="../index.html">Introduction</a>
  -</div>
  - 
  -<div class="menuItem">
  -<a href="../news.html">News</a>
  -</div>
   
  - 
  -<div class="menuItem">
  -<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a>
  -</div>
  - 
  -<div class="menu">
  -<span class="menuLabel">Get Involved</span>
  -  
  -<div class="menuItem">
  -<a href="../overview.html">Overview</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../cvs.html">CVS Repository</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../mail.html">Mailing Lists</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../ref.html">Reference Library</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../bugs.html">Bugs</a>
  -</div>
  - 
  -</div>
  - 
  -<div class="menu">
  -<span class="menuLabel">Axis (Java)</span>
  -  
  -<div class="menuItem">
  -<a href="../java/index.html">Documentation</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/install.html">Installation</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/user-guide.html">User's Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/developers-guide.html">Developer's Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/integration-guide.html">Integration Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/architecture-guide.html">Architecture Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/reference.html">Reference Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/reading.html">Reading Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/requirements.html">Requirements</a>
  -</div>
  - 
  -</div>
  - 
  -<div class="menu">
  -<span class="menuLabel">Axis (C++)</span>
  -  
  -<div class="menuItem">
  -<a href="../cpp/index.html">Latest Axis C++ Release!</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../cpp/documentation.html">Documentation</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../cpp/download.html">Download</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisCPPProjectPages">Wiki Pages</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../cpp/who.html">Who we are</a>
  -</div>
  -  
  -</div>
  -
  -<div class="menu">
  -<span class="menuLabel">Downloads</span>
  -  
  -<div class="menuItem">
  -<a href="../releases.html">Releases</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../interim.html">Interim Drops</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a>
  -</div>
  -
  -</div>
  -
  -<div class="menu">
  -<span class="menuLabel">Translation</span>
  -  
  -<div class="menuItem">
  -<a href="http://ws.apache.org/~toshi/jp-site/axis/index.html">Japanese (Unofficial)</a>
  -</div>
  -
  -</div>
  -
  -<div class="menu">
  -<span class="menuLabel">Related Projects</span>
  -  
  -<div class="menuItem">
  -<a href="http://ws.apache.org/wsif/">WSIF</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://www.uddi4j.org/">UDDI4J</a>
  -</div>
  -
  -</div>
  -
  -<div class="menu">
  -<span class="menuLabel">Misc</span>
  -  
  -<div class="menuItem">
  -<a href="../site.html">Whole Site</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../who.html">Who We Are</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../contact.html">Contact</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../legal.html">Legal</a>
  -</div>
  -
  -  
  -<div class="menuItem">
  -<a href="../docs.html">Notes/Docs</a>
  -</div>
  -
  -</div>
  -
  -
  -</div>
  -</div>
  -</div>
  -</td>
  -<!--================= end Menu ==================-->
  -<!--================= start Content ==================--><td>
  -<div id="bodycol">
  -<div class="app">
  -<div align="center">
  +<body>
   <h1>Axis C++ Linux Installation Guide</h1>
  -</div>
  -<div class="h3">
  -<div class="h3">
  -<h3>Axis C++ Linux Installation Guide</h3>
  -</div>
  -<p>
  -<strong>Contents</strong>
  -</p>
  -<ul>
  +
  +<p><strong>Contents</strong></p>
  +
  +
  +
   <li>
   <a href="#Introducti">Introduction</a>
   </li>
  @@ -291,225 +20,268 @@
   <li>
   <a href="#Install">Installing Axis C++</a>
   </li>
  -<li style="list-style: none">
   <br>
  -</li>
  -</ul>
  +
  +<p><b>Note:</b>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>
  +
  +
  +<h1>Introduction</h1>
  +
  +<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>&nbsp; &nbsp; &nbsp; <a href="http://httpd.apache.org/download.cgi">Apache web server</a> (2.0.x or 1.3.x)&nbsp; - 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>
  +
  +<h1>What You Need</h1>
  +
  +
  +<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>&nbsp; &nbsp; &nbsp; <a href="http://httpd.apache.org/download.cgi">Apache web server </a> (2.0.x or 1.3.x)&nbsp; - 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>&nbsp; &nbsp; &nbsp; <a href="http://sourceforge.net/projects/expat/">Expat (1.95.7) </a> (<b>Note:</b>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>&nbsp; &nbsp; &nbsp; <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 Expat and Xerces parsers are supported by Axis C++.<br>
  +
  +<p><a name="Install"></a>
   </p>
  -<br>
  -<p>
  -<a name="Install"></a>
  +
  +<h1>Installing Axis C++</h1>
  +
  +
  +
  +<h2>1. Install Apache Web Server </h2>
  +<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> 
  +
  +<h2>2. Install Expat (1.95.7) and/or Xerces C++ (2.2.0) </h2>
  +<p><b>Note:</b>The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section.
   </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>Select an XML parser depending on your parser preferences. See the respective parser's documentation for installation instructions.</p>
  -<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>Select an XML parser depending on your parser preferences. See the respective parser's documentation for
  +installation instructions. </p> <br>
  +
  +
  +<h2>3. Download Axis C++</h2>
  +<p> <a href="http://ws.apache.org/axis/cpp/download.html">Download Axis C++</a> source or binary distribution and extract the  package.</p>
  +
  +<h2>4. Define the Environment Variables.</h2>
   <p>
  -<strong>AXISCPP_HOME="Path to Axis C++ source or binary extracted folder"</strong>
  -<br> e.g. <strong>AXISCPP_HOME="/my/home/axiscpp"</strong>
  +<b>AXISCPP_HOME="Path to Axis C++ source or binary extracted folder"</b><br>
  +
  +e.g. <b><i>AXISCPP_HOME="/my/home/axiscpp"</i></b><br>
  +
  +<br><b>
  +
  +AXISCPP_DEPLOY="Path to the folder where you want to install Axis C++"</b><br>
  +
  +e.g. <i><b>AXISCPP_DEPLOY="/usr/local/axiscpp_deploy"<br>
  +</b></i>
  +
  +<br><b>
  +
  +LD_LIBRARY_PATH="&lt;path to parser library you use&gt;/lib:$AXISCPP_DEPLOY/lib:$LD_LIBRARY_PATH"<br>
  +</b>
  +
  +<br><b>
  +
  +export AXISCPP_HOME AXISCPP_DEPLOY LD_LIBRARY_PATH</b> </p>
  +
  +
  +<h2>5. Build Axis C++</h2>
  + 
  +<p> <b>Note:</b> The following steps are for Axis C++ source downloads.<br> <br>
  +<b>cd $AXISCPP_HOME </b> <br> <br>
  +
  +<b>./configure --prefix=$AXISCPP_DEPLOY --with-apache2=/path/to/Apache2 \<br>
  +&nbsp;&nbsp;&nbsp;&nbsp;--with-xercesc=/path/to/xerces-c </b> <br>
  +<b> make </b> <br>
  +<b> make install</b><br>
   <br>
  -<br> 
  -<strong>AXISCPP_DEPLOY="Path to the folder where you want to install Axis C++"</strong>
  -<br> e.g. <em>AXISCPP_DEPLOY="/usr/local/axiscpp_deploy"</em>
  -<br> 
  -<strong>LD_LIBRARY_PATH="&lt;path to parser library you use&gt;/lib:$AXISCPP_DEPLOY/lib:$LD_LIBRARY_PATH"</strong>
  -<br> 
  -<strong>export AXISCPP_HOME AXISCPP_DEPLOY LD_LIBRARY_PATH</strong>
  -</p>
  -<div class="h4">
  -<h4>5. Build Axis C++</h4>
  -</div>
  +
  +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><i>./configure --help</i></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>
  +
  +&nbsp;<br></p>
  +
  +<p> <b>Note:</b> 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>
  +
  +<i><b>chmod -R 777 $AXISCPP_DEPLOY</b></i> </p>
  +
  +<h2>6. Configure Apache Module</h2>
   <p>
  -<strong>Note:</strong> If you have downloaded Axis C++ binaries, you can skip this step<br>
  +<b>Note:</b> to execute the following steps, you may need to have <strong>super user rights</strong> on your machine.
   <br>
  -<strong>cd $AXISCPP_HOME</strong>
   <br>
  -<br> 
  -<strong>./configure --prefix=$AXISCPP_DEPLOY --with-apache2=/path/to/Apache2 \&nbsp;&nbsp;&nbsp;&nbsp;--with-xercesc=/path/to/xerces-c</strong>
  -<br> 
  -<strong>make</strong>
  -<br> 
  -<strong>make install</strong>
  +
  +Now you need to  edit
  +<b>httpd.conf</b> file in &lt;path to Apache web server installation&gt;/conf
  +and add the following lines at the bottom of that file (assuming you
  +are using Apache 2.0.x):<br>
  +
   <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> &nbsp;<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 &lt;path to Apache web server installation&gt;/conf and add the following lines at the bottom of that file (assuming you are using Apache 2.0.x):<br>
  -<br> 
  -<strong>LoadModule axis_module modules/libaxiscpp_mod2.so</strong>
  -<br> 
  -<strong>&lt;Location /axis&gt;</strong>
  +
  +<b>LoadModule axis_module modules/libaxiscpp_mod2.so</b><br>
  +
  +<b>&lt;Location /axis&gt;</b><br>
  +<b>SetHandler axis </b> <br>
  +<b>&lt;/Location&gt;</b><br>
   <br>
  -<strong>SetHandler axis</strong>
  +For Apache1.3.x LoadModule line should read as:<br>
  +
  +<b>LoadModule axis_module libexec/libaxiscpp_mod.so</b> </p>
  +
  +<h2>7. Configure Server Deployment Descriptor File</h2>
  +<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>
  -<strong>&lt;/Location&gt;</strong>
  +server.wsdd file is an XML file, and the contents are self descriptive. </p>
  +
  +<h2>8. Set Engine Wide Settings in Configuration File</h2>
  +<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>
  -<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>
  +
  +Configuration file has the following <b>Syntax:</b> </p> <br>
  +
  +<p> The comment character is '#'<br>
  +WSDDFilePath - Path to the server wsdd file<br>
  +ClientWSDDFilePath - Path to the client wsdd<br>
  +LogPath - Path to the Axis C++ server log<br> 
  +ClientLogPath - Path to the Axis C++ client log<br>
  +Transport_http - HTTP transport library<br>
  +XMLParser - XML parser library
   </p>
   <br>
  -<p>The comment character is '#'<br>WSDDFilePath - Path to the server wsdd file<br>ClientWSDDFilePath - Path to the client wsdd<br>LogPath - Path to the Axis C++ server log<br> ClientLogPath - Path to the Axis C++ client log<br>Transport_http - HTTP transport library<br>XMLParser - XML parser library</p>
  -<br>
  -<p>A sample <strong>axiscpp.conf</strong> file:</p>
  -<pre>LogPath:/usr/local/axiscpp_deploy/log/AxisLog
  +<p>
  +A sample <b>axiscpp.conf</b> file: </p>
  +
  +<pre>
  +LogPath:/usr/local/axiscpp_deploy/log/AxisLog
   WSDDFilePath:/usr/local/axiscpp_deploy/etc/server.wsdd
   ClientLogPath:/usr/local/axiscpp_deploy/log/AxisClientLog
   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>
  +
  +<h2>9. Deploying with Apache Web Server </h2>
  +
  +<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:
   <ol>
  -<li>Copy libaxiscpp_mod2.so to /&lt;your Apache 2.0.x home&gt;/modules (or copy libaxiscpp_mod.so to /&lt;your Apache 1.3.x home&gt;/libexec)</li>
  -<li>Start Apache /&lt;path to Apache installation&gt;/bin/apachectl start</li>
  -</ol>
  -<p>To do the same you can you can use scripts in $AXISCPP_DEPLOY/bin.</p>
  -<strong>cd $AXISCPP_DEPLOY/bin</strong>
  -<br>
  -<p>To deploy with Apache 2.0.x</p>
  -<strong>sh deploy_apache2.sh</strong>
  -<br>
  -<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> 
  -<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>
  -<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>
  -<strong>cd $AXISCPP_DEPLOY/bin</strong>
  -<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>
  -</p>
  -<p>and make sure that the contents of that file match your system settings</p>
  -<p>4. Run simple axis server in <strong>$AXISCPP_DEPLOY/bin</strong>
  -<br>Synopsis: simple_axis_server server-port Where server-port is the port on which you would like the server to listen for client requests.</p>
  -<p>For Example</p>
  -<p>
  -<strong>cd $AXISCPP_DEPLOY/bin</strong>
  -</p>
  +<li> Copy libaxiscpp_mod2.so to /&lt;your Apache 2.0.x home&gt;/modules (or copy libaxiscpp_mod.so to /&lt;your Apache 1.3.x home&gt;/libexec)</li>
  +<li> Start Apache /&lt;path to Apache installation&gt;/bin/apachectl start </li>
  +</ol> 
  +
   <p>
  -<strong>./simple_axis_server 9090</strong>
  -</p>
  -<p>5. Run clients in <strong>$AXISCPP_DEPLOY/bin</strong>
  -</p>
  -<p>On a different shell:</p>
  +To do the same you can you can use scripts in $AXISCPP_DEPLOY/bin.</p>
  +
  +<b>cd $AXISCPP_DEPLOY/bin </b> <br> 
  +<p>                                       
  +To deploy with Apache 2.0.x </p>
  +<b>sh deploy_apache2.sh </b> <br>
   <p>
  -<strong>cd $AXISCPP_DEPLOY/bin</strong>
  +To deploy with Apache 1.3.x </p>
  +<b>sh deploy_apache.sh </b> </br>
  +
  +<p> <b>Note:</b> 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><b>Note:</b>The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section.
   </p>
  +
  +
  +<b><i> cp -f ${AXISCPP_DEPLOY}/lib/libaxis_xercesc.so ${AXISCPP_DEPLOY}/lib/libaxis_xmlparser.so </i></b> </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. 
  +
  +<h2>10. See Axis C++ in action</h2>
   <p>
  -<strong>./base http://localhost:9090/axis/base</strong>
  +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>
  +
  +<strong>cd $AXISCPP_DEPLOY/bin</strong>  <br>
  +<strong>./base</strong> 
  +
  +<p>To help you run several samples at once there is a script named
  +<b>run_interoptests.sh</b> in $AXISCPP_DEPLOY/bin folder. You can try running
  +that as well.
   </p>
  -<p>Similarly you could run the other samples.</p>
  +
  +<h2>11. Simple axis server installation </h2>
  +
  +<p>1. Build the source distribution as mentioned above.</p>
  +
  +<p>2. Make sure that you have set the  <b>AXISCPP_DEPLOY</b>  environment variable to point to your deployment folder as mentioned above </p>
  +
  +<p>3.Copy  <b> $AXISCPP_DEPLOY/etc/axiscpp.conf_linux</b>  to  <b>$AXISCPP_DEPLOY/etc/axiscpp.conf </b> <p>
  +<p>and make sure that the contents of that  file match your system settings </p>
  +
  +<p>4. Run simple axis server in  <b> $AXISCPP_DEPLOY/bin </b> <br>
  +Synopsis: simple_axis_server server-port Where server-port is the port on which you would like the server to listen for
  +client requests.</p>
  +
  +<p> For Example </p>
  +<p><b>cd $AXISCPP_DEPLOY/bin </b> </p>
  +<p><b>./simple_axis_server 9090</b> </p>
  +
  +<p>5. Run clients in <b> $AXISCPP_DEPLOY/bin </b> </p>
  +<p> On a different shell: </p>
  +<p><b>cd $AXISCPP_DEPLOY/bin </b> </p>
  +<p><b>./base http://localhost:9090/axis/base </b> </p>
  +<p>Similarly you could run the other samples. </p>
  +
  +<p>Similarly you could run the other samples.
   <div id="pdf" align="right">
   <a href="lininstall-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
             PDF</a>
  -</div>
  -</div>
  -</div>
  -</div>
  -</td>
  -<!--================= end Content ==================-->
  -</tr>
  -</tbody>
  -</table>
  -<!--================= end Main ==================-->
  -<!--================= start Footer ==================-->
  -<div id="footer">
  -<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
  -<tbody>
  -<tr>
  -<!--================= start Copyright ==================-->
  -<td colspan="2">
  -<div align="center">
  -<div class="copyright">
  -              Copyright &copy; 2000-2004&nbsp;The Apache Software Foundation. All rights reserved.
  -            </div>
  -</div>
  -</td>
  -<!--================= end Copyright ==================-->
  -</tr>
  -<tr>
  -<td align="left">
  -<!--================= start Host ==================-->
  -<!--================= end Host ==================--></td><td align="right">
  -<!--================= start Credits ==================-->
  -<div align="right">
  -<div class="credit"></div>
  -</div>
  -<!--================= end Credits ==================-->
  -</td>
  -</tr>
  -</tbody>
  -</table>
  -</div>
  -<!--================= end Footer ==================-->
  +</p>
  +
   </body>
   </html>
  
  
  
  1.2       +733 -0    ws-axis/c/docs/linuser-guide.pdf
  
  	<<Binary file>>
  
  

Mime
View raw message