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 da...@apache.org on 2004/10/22 13:48:58 UTC

cvs commit: ws-axis/c/docs lininstall-guide.html lininstall-guide.pdf

damitha     2004/10/22 04:48:58

  Modified:    c/docs   lininstall-guide.html lininstall-guide.pdf
  Log:
  (null)
  
  Revision  Changes    Path
  1.6       +469 -221  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.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- lininstall-guide.html	22 Oct 2004 11:09:07 -0000	1.5
  +++ lininstall-guide.html	22 Oct 2004 11:48:58 -0000	1.6
  @@ -1,16 +1,287 @@
  +<!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">
  -  <title>Axis C++ Linux Installation Guide</title>
  +<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>
   </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>
   
  -<body>
  + 
  +<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">
   <h1>Axis C++ Linux Installation Guide</h1>
  -
  -<p><strong>Contents</strong></p>
  -
  -
  -
  +</div>
  +<div class="h3">
  +<div class="h3">
  +<h3>Axis C++ Linux Installation Guide</h3>
  +</div>
  +<p>
  +<strong>Contents</strong>
  +</p>
  +<ul>
   <li>
   <a href="#Introducti">Introduction</a>
   </li>
  @@ -20,248 +291,225 @@
   <li>
   <a href="#Install">Installing Axis C++</a>
   </li>
  +<li style="list-style: none">
   <br>
  -
  -
  +</li>
  +</ul>
   <p>
   <a name="Introduction"></a>
   </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>
  -
  +<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>
  -
  -<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> 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>
  -
  -<br>
  -
  -<p><a name="Install"></a>
  +<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>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>Select an XML parser depending on your parser preferences. See the respective parser's documentation for
  -installation instructions.</p> 
  -
  -<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>
  -<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> If you have downloaded Axis C++ binaries, you can skip this step<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>
  -
  -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>
  -
  +<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>
   <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>
  -
  -<i><b>chmod -R 777 $AXISCPP_DEPLOY</b></i> </p>
  -
  -<h2>6. Configure Apache Module</h2>
   <p>
  -<b>Note:</b> to execute the following steps, you may need to have <strong>super user rights</strong> on your machine.
  +<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>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>
  +<strong>AXISCPP_HOME="Path to Axis C++ source or binary extracted folder"</strong>
  +<br> e.g. <strong>AXISCPP_HOME="/my/home/axiscpp"</strong>
   <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>
  +<p>
  +<strong>Note:</strong> If you have downloaded Axis C++ binaries, you can skip this step<br>
   <br>
  -
  -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>
  -
  +<strong>cd $AXISCPP_HOME</strong>
   <br>
  -
  -<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>./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>
   <br>
  -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>
  +<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>
  -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.
  +<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>
   <br>
  -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>
  -
  +<strong>SetHandler axis</strong>
   <br>
  -
  -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
  +<strong>&lt;/Location&gt;</strong>
  +<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>
   </p>
   <br>
  -<p>
  -A sample <b>axiscpp.conf</b> file: </p>
  -
  -<pre>
  -LogPath:/usr/local/axiscpp_deploy/log/AxisLog
  +<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
   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>
  -
  -<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:
  +<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 /&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> 
  -
  +<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>
  -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>
  +<strong>cd $AXISCPP_DEPLOY/bin</strong>
  +</p>
   <p>
  -To deploy with Apache 1.3.x </p>
  -<b>sh deploy_apache.sh </b> </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>
  -
  -<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>
  +<strong>./simple_axis_server 9090</strong>
  +</p>
  +<p>5. Run clients in <strong>$AXISCPP_DEPLOY/bin</strong>
  +</p>
  +<p>On a different shell:</p>
   <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
  -<b>run_interoptests.sh</b> in $AXISCPP_DEPLOY/bin folder. You can try running
  -that as well.
  +<strong>cd $AXISCPP_DEPLOY/bin</strong>
   </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>
  +<strong>./base http://localhost:9090/axis/base</strong>
  +</p>
  +<p>Similarly you could run the other samples.</p>
  +<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 ==================-->
   </body>
   </html>
  
  
  
  1.2       +32 -32    ws-axis/c/docs/lininstall-guide.pdf
  
  	<<Binary file>>