axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dami...@apache.org
Subject cvs commit: xml-axis/c/docs build.txt integration-guide.html integration-guide.txt user-guide.txt developer-guide.txt
Date Fri, 12 Sep 2003 11:56:29 GMT
damitha     2003/09/12 04:56:29

  Modified:    c/docs   build.txt integration-guide.html
                        integration-guide.txt user-guide.txt
                        developer-guide.txt
  Log:
  log:updated the document files
  
  Revision  Changes    Path
  1.3       +43 -13    xml-axis/c/docs/build.txt
  
  Index: build.txt
  ===================================================================
  RCS file: /home/cvs/xml-axis/c/docs/build.txt,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- build.txt	19 Aug 2003 06:09:13 -0000	1.2
  +++ build.txt	12 Sep 2003 11:56:28 -0000	1.3
  @@ -1,21 +1,51 @@
  +To build axisengine library
  +===========================
   When you download the source you have only Makfile.am's and configure.ac and
   autogen.sh script for building.
  +
  +make sure you create and  set the environment variable AXISCPP_HOME
  +to reflect the path to the directory where you downloaded the axiscpp.
  +for example I have it as following
  +AXISCPP_HOME="/home/damitha/projects/axiscpp/c" where c is the rood directory
  +for axiscpp source. There you find autogen.sh, configure.ac etc.
  +
   to build go to axisroot dirctory.
   sh autogen.sh
   
  -If you want to avoid cluttering of the source with object files use the build directory
  -to generate your object files. To do that do it as follows.
  -Copy the axisconfigure file from c directory to c/build directory.
  -Next just change the following line of it
  -./configure --libdir=/home/damitha/projects/axiscpp/c/release
  -into
  -../configure --libdir=/home/damitha/projects/axiscpp/c/release
  +To avoid cluttering of the source with object files use the build directory
  +to generate your object files.
   
   Now from c/build directory run
  -sh axisconfigure
  +sh runconfigure
  +
  +This will create all the Makefiles in a tree starting from build directory.
  +make
  +then
  +make install
  +this will install libaxiscpp_mod.so in c/release directory.
  +copy this to <apache home>/libexec directory and restart apache
  +to load the axisengine in apache.
  +
  +Note: in $AXISCPP_HOME/include you have folder called xercesc apache1_3
  +apache2_0. Copy the corresponding include files into them.
  +
  +To build samples
  +=====================
  +Go to the samples folder
  +$(AXISCPP_HOME)/src/server/samples
  +and select the sample you want. As an example we try on
  +simplewebservice
  +type the following commands in that order
  +sh autogen.sh
  +sh runconfig
  +make
  +make install
  +
  +this will install the sample library in /usr/local/apache/Axis/webservices
  +
  +note: the server.wsdd file for this sample has to be put in
  +/usr/local/apache/Axis/conf folder.
  +This path is hardcoded in Axis.cpp file as following
  +
  +#define WSDDFILEPATH "/usr/local/apache/Axis/conf/server.wsdd"
   
  -Note: Make sure you set the environment variables
  -APACHE_HOME and XERCES_HOME to appropriate values
  -for examele
  -APACHE_HOME="/usr/local/apache"
  -XERCES_HOME="/usr/local/xerces_c"
  
  
  
  1.2       +150 -145  xml-axis/c/docs/integration-guide.html
  
  Index: integration-guide.html
  ===================================================================
  RCS file: /home/cvs/xml-axis/c/docs/integration-guide.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- integration-guide.html	23 Jun 2003 13:38:41 -0000	1.1
  +++ integration-guide.html	12 Sep 2003 11:56:28 -0000	1.2
  @@ -1,146 +1,151 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
  -<HTML>
  -<HEAD>
  -	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
  -	<TITLE>Axis System Integration Guide</TITLE>
  -	<META NAME="GENERATOR" CONTENT="OpenOffice.org 1.0.1  (Linux)">
  -	<META NAME="CREATED" CONTENT="20030619;18104500">
  -	<META NAME="CHANGED" CONTENT="20030620;13552600">
  -	<!-- saved from url=(0022)http://internet.e-mail -->
  -	<STYLE>
  -	<!--
  -		H1 { color: #000000 }
  -		P { margin-left: 0.98cm; color: #000000; font-family: "Verdana", "Arial", "Helvetica",
sans-serif }
  -		H2 { color: #000000; text-decoration: underline }
  -		H3 { color: #000000 }
  -	-->
  -	</STYLE>
  -</HEAD>
  -<BODY LANG="en-US" TEXT="#000000" BGCOLOR="#ffffff">
  -<H1 ALIGN=CENTER><IMG SRC="../../../usr/local/axis/docs/axis.jpg" NAME="Graphic1"
ALIGN=BOTTOM WIDTH=222 HEIGHT=96 BORDER=0></H1>
  -<H1>Axis C++ Integration Guide</H1>
  -<P><I>0.1 Version</I> 
  -</P>
  -<H3>Table of Contents</H3>
  -<P><A HREF="#Introduction">Introduction</A> <BR><A HREF="#Pluggable
APIs">Pluggable
  -APIs</A> <BR>&nbsp; <A HREF="#Components">Components<!-- <br>&nbsp;
<a href="#System Management Plug">System Management</a>
  ---></A>
  -<BR>&nbsp; <A HREF="#Logging/Tracing Plug">Logging/Tracing</A> <BR>&nbsp;
  -<A HREF="#Configuration" NAME="Configuration">Configuration</A><BR>&nbsp;
  -<A HREF="#Handlers Plug">Handlers</A> <BR>&nbsp; <A HREF="#Internationalization
Plug">Internationalization</A>
  -<BR>&nbsp; <A HREF="#Performance Monitoring Plug">Performance
  -Monitoring</A> <BR>&nbsp; <A HREF="#Encoding Plug">Encoding</A>
<BR>&nbsp;
  -<A HREF="#WSDL plug">WSDL Parser and Code Generator Framework</A> 
  -</P>
  -<H2><A NAME="Introduction"></A>Introduction</H2>
  -<P>The primary purpose of this guide is to present how AXISCPP can be
  -integrated into an existing web application server, such as Apache,
  -Netscape web server for example.&nbsp; AXIS has a number of Pluggable
  -APIs that are necessary for such an integration. 
  -</P>
  -<P>The reader may find useful background information in the
  -<A HREF="architecture-guide.html">Architecture Guide</A></P>
  -<H2><A NAME="Pluggable APIs"></A>Pluggable APIs</H2>
  -<P>The following are the points that are pluggable in order to
  -integrate AXIS into a web application server. The first subsection
  -details a number of pluggable components in general. More details are
  -provided for other components in the remaining subsections. 
  -</P>
  -<H3><A NAME="Handlers Plug"></A>Handlers</H3>
  -<P>See the <A HREF="architecture-guide.html">Architecture Guide </A>for
  -current information on Handlers. <!-- How can a system integrator plug in other encoding
mechanisms such as SOAP
  -1.2 or optimized XML-based encoding?
  -<ul>
  -<li>
  -Justification/Rationale - why is this plug point necessary?&nbsp; Spec
  -compliance?</li>
  -
  -<li>
  -Interfaces</li>
  -
  -<li>
  -Mechanism</li>
  -
  -<ul>
  -<li>
  -Life cycle</li>
  -
  -<li>
  -Exception handling - in general; plug-in shouldn't throw any exceptions
  -- does runtime ignore? Log?)</li>
  -
  -<li>
  -Multiple thread support?&nbsp; Ie., is synchronization required?</li>
  -</ul>
  -
  -<li>
  -Configuration/reconfiguration</li>
  -
  -<li>
  -Default behavior if not plugged.</li>
  -
  -<li>
  -Example</li>
  -</ul>
  --->
  -</P>
  -<H3><A NAME="Configuration"></A><FONT SIZE=4>Configuration</FONT></H3>
  -<P><FONT SIZE=4>Axis C++ server can be configured to run on Aapache,
  -Netscape web server(Not implemented yet) and Microsoft IIS(Not yet
  -implemented. Also it is expected to run on Solaris, IBM AIX,
  -HPUnix,FreeBSD, Linux and Windows. Currently it is tested only on
  -RedHat Linux(8).</FONT></P>
  -<P STYLE="margin-bottom: 0cm; line-height: 0.5cm"><FONT SIZE=4 STYLE="font-size:
15pt">Linux
  - :Apache web server</FONT></P>
  -<P STYLE="margin-bottom: 0cm; line-height: 0.5cm"><FONT SIZE=3>Download
  -the axiscpp.tar.gz</FONT></P>
  -<P STYLE="line-height: 100%"><FONT SIZE=4>gunzip and untar it where
  -ever you like.</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3><FONT SIZE=4>f<FONT SIZE=3>or
  -simplicity assume that your axiscpp is now </FONT></FONT>/usr/local/axiscpp</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>From now on I call this
  -&lt;axiscpp_home&gt;</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>goto
  -&lt;axiscpp_home&gt;/release</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><BR>
  -</P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>copy the libaxiscpp_mod.so
  -file into &lt;apache home directory&gt;/libexec directory.</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>For the apache server to
  -load this shared module it (the apache web server) must be compiled
  -with shareable module support (To do this, when running the configure
  -script pass it the option &quot;--enable-module=so&quot;) For further
  -information on comipiling and installing the apache web server please
  -visit http://httpd.apache.org .</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><BR>
  -</P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>open the httpd.conf file
  -in &lt;apache directory&gt;/conf/</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>add the following lines</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><BR>
  -</P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>LoadFile
  -/usr/local/apache/libexec/libaxiscpp_mod.so</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>LoadModule axis_module    
  -libexec/libaxiscpp_mod.so</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><BR>
  -</P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>&lt;Location /axis&gt;</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>SetHandler axis</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>&lt;/Location&gt;</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><BR>
  -</P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>where /axis is context
  -path where the apache|axiscpp is listening to webservice requests.</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>Now stop the apache web
  -server if it is already started.</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>Start the apache web
  -server. If it starts without giving problem the module is
  -successfully loaded.</FONT></P>
  -<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>Read the userguide for
  -information on how to test the webservices on your newly installed
  -soap server.</FONT></P>
  -<P><BR><BR>
  -</P>
  -</BODY>
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
  +<HTML>
  +<HEAD>
  +	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
  +	<TITLE>Axis System Integration Guide</TITLE>
  +	<META NAME="GENERATOR" CONTENT="OpenOffice.org 1.0.1  (Linux)">
  +	<META NAME="CREATED" CONTENT="20030619;18104500">
  +	<META NAME="CHANGED" CONTENT="20030620;13552600">
  +	<!-- saved from url=(0022)http://internet.e-mail -->
  +	<STYLE>
  +	<!--
  +		H1 { color: #000000 }
  +		P { margin-left: 0.98cm; color: #000000; font-family: "Verdana", "Arial", "Helvetica",
sans-serif }
  +		H2 { color: #000000; text-decoration: underline }
  +		H3 { color: #000000 }
  +	-->
  +	</STYLE>
  +</HEAD>
  +<BODY LANG="en-US" TEXT="#000000" BGCOLOR="#ffffff">
  +<H1 ALIGN=CENTER><IMG SRC="../../../usr/local/axis/docs/axis.jpg" NAME="Graphic1"
ALIGN=BOTTOM WIDTH=222 HEIGHT=96 BORDER=0></H1>
  +<H1>Axis C++ Integration Guide</H1>
  +<P><I>0.1 Version</I> 
  +</P>
  +<H3>Table of Contents</H3>
  +<P><A HREF="#Introduction">Introduction</A> <BR><A HREF="#Pluggable
APIs">Pluggable
  +APIs</A> <BR>&nbsp; <A HREF="#Components">Components<!-- <br>&nbsp;
<a href="#System Management Plug">System Management</a>
  +--></A>
  +<BR>&nbsp; <A HREF="#Logging/Tracing Plug">Logging/Tracing</A> <BR>&nbsp;
  +<A HREF="#Configuration" NAME="Configuration">Configuration</A><BR>&nbsp;
  +<A HREF="#Handlers Plug">Handlers</A> <BR>&nbsp; <A HREF="#Internationalization
Plug">Internationalization</A>
  +<BR>&nbsp; <A HREF="#Performance Monitoring Plug">Performance
  +Monitoring</A> <BR>&nbsp; <A HREF="#Encoding Plug">Encoding</A>
<BR>&nbsp;
  +<A HREF="#WSDL plug">WSDL Parser and Code Generator Framework</A> 
  +</P>
  +<H2><A NAME="Introduction"></A>Introduction</H2>
  +<P>The primary purpose of this guide is to present how AXISCPP can be
  +integrated into an existing web application server, such as Apache,
  +Netscape web server for example.&nbsp; AXIS has a number of Pluggable
  +APIs that are necessary for such an integration. 
  +</P>
  +<P>The reader may find useful background information in the
  +<A HREF="architecture-guide.html">Architecture Guide</A></P>
  +<H2><A NAME="Pluggable APIs"></A>Pluggable APIs</H2>
  +<P>The following are the points that are pluggable in order to
  +integrate AXIS into a web application server. The first subsection
  +details a number of pluggable components in general. More details are
  +provided for other components in the remaining subsections. 
  +</P>
  +<H3><A NAME="Handlers Plug"></A>Handlers</H3>
  +<P>See the <A HREF="architecture-guide.html">Architecture Guide </A>for
  +current information on Handlers. <!-- How can a system integrator plug in other encoding
mechanisms such as SOAP
  +1.2 or optimized XML-based encoding?
  +<ul>
  +<li>
  +Justification/Rationale - why is this plug point necessary?&nbsp; Spec
  +compliance?</li>
  +
  +<li>
  +Interfaces</li>
  +
  +<li>
  +Mechanism</li>
  +
  +<ul>
  +<li>
  +Life cycle</li>
  +
  +<li>
  +Exception handling - in general; plug-in shouldn't throw any exceptions
  +- does runtime ignore? Log?)</li>
  +
  +<li>
  +Multiple thread support?&nbsp; Ie., is synchronization required?</li>
  +</ul>
  +
  +<li>
  +Configuration/reconfiguration</li>
  +
  +<li>
  +Default behavior if not plugged.</li>
  +
  +<li>
  +Example</li>
  +</ul>
  +-->
  +</P>
  +<H3><A NAME="Configuration"></A><FONT SIZE=4>Configuration</FONT></H3>
  +<P><FONT SIZE=4>Axis C++ server can be configured to run on Aapache,
  +Netscape web server(Not implemented yet) and Microsoft IIS(Not yet
  +implemented. Also it is expected to run on Solaris, IBM AIX,
  +HPUnix,FreeBSD, Linux and Windows. Currently it is tested only on
  +RedHat Linux(8).</FONT></P>
  +<P STYLE="margin-bottom: 0cm; line-height: 0.5cm"><FONT SIZE=4 STYLE="font-size:
15pt">Linux
  + :Apache web server</FONT></P>
  +
  +<P STYLE="margin-bottom: 0cm; line-height: 0.5cm"><FONT SIZE=3>This document
is intended for the developer who wish to download and test the axiscpp server.
  +</FONT></P>
  +<P STYLE="line-height: 100%"><FONT SIZE=4>Checkout axiscpp from cvs repository.</FONT></P>
  +
  +<P STYLE="margin-bottom: 0cm">
  +<FONT SIZE=3>
  +for simplicity assume that your axiscpp is now /usr/local/axiscpp</FONT>
  +
  +
  +</P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>From now on I call this
  +&lt;axiscpp_home&gt;</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>goto
  +&lt;axiscpp_home&gt;/release</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><BR>
  +</P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>copy the libaxiscpp_mod.so
  +file into &lt;apache home directory&gt;/libexec directory.</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>For the apache server to
  +load this shared module it (the apache web server) must be compiled
  +with shareable module support (To do this, when running the configure
  +script pass it the option &quot;--enable-module=so&quot;) For further
  +information on comipiling and installing the apache web server please
  +visit http://httpd.apache.org .</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><BR>
  +</P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>open the httpd.conf file
  +in &lt;apache directory&gt;/conf/</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>add the following lines</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><BR>
  +</P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>LoadFile
  +/usr/local/apache/libexec/libaxiscpp_mod.so</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>LoadModule axis_module    
  +libexec/libaxiscpp_mod.so</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><BR>
  +</P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>&lt;Location /axis&gt;</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>SetHandler axis</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>&lt;/Location&gt;</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><BR>
  +</P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>where /axis is context
  +path where the apache|axiscpp is listening to webservice requests.</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>Now stop the apache web
  +server if it is already started.</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>Start the apache web
  +server. If it starts without giving problem the module is
  +successfully loaded.</FONT></P>
  +<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>Read the userguide for
  +information on how to test the webservices on your newly installed
  +soap server.</FONT></P>
  +<P><BR><BR>
  +</P>
  +</BODY>
   </HTML>
  
  
  
  1.2       +1 -2      xml-axis/c/docs/integration-guide.txt
  
  Index: integration-guide.txt
  ===================================================================
  RCS file: /home/cvs/xml-axis/c/docs/integration-guide.txt,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- integration-guide.txt	23 Jun 2003 13:38:41 -0000	1.1
  +++ integration-guide.txt	12 Sep 2003 11:56:28 -0000	1.2
  @@ -1,7 +1,6 @@
   Linux Solaris :Apache web server
   
  -Download the axiscpp.tar.gz
  -gunzip and untar it where ever you like.
  +checkout the axiscpp from apache.
   for simplicity assume that your axiscpp is now
   /usr/local/axiscpp
   From now on I call this <axiscpp_home>
  
  
  
  1.2       +0 -39     xml-axis/c/docs/user-guide.txt
  
  	<<Binary file>>
  
  
  1.2       +49 -15    xml-axis/c/docs/developer-guide.txt
  
  Index: developer-guide.txt
  ===================================================================
  RCS file: /home/cvs/xml-axis/c/docs/developer-guide.txt,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- developer-guide.txt	23 Jun 2003 13:38:41 -0000	1.1
  +++ developer-guide.txt	12 Sep 2003 11:56:28 -0000	1.2
  @@ -1,21 +1,55 @@
   This document is intended for the developer who wish to download and test the axiscpp server.
   
  -Download the axiscpp.tar.gz from the cvs repository
  -tar -zxvf axiscpp.tar.gz into your selected folder.
  - 
  -create and export an environment variable called
  -XERCES_HOME. This environment variable should contain the path to the xerces home directory.
  -
  -For example if your xerces is installed in
  -
  -/usr/local/xerces_c folder then 
  -$(XERCES_HOME)/lib should expand to /usr/local/xerces_c/lib and
  -$(XERCES_HOME)/include should expand to /usr/local/xerces_c/include
  +Checkout axiscpp from cvs repository.
  +To build axisengine library
  +===========================
  +When you download the source you have only Makfile.am's and configure.ac and
  +autogen.sh script for building.
   
  -cd axiscpp
  -make clean
  +make sure you create and  set the environment variable AXISCPP_HOME
  +to reflect the path to the directory where you downloaded the axiscpp.
  +for example I have it as following
  +AXISCPP_HOME="/home/damitha/projects/axiscpp/c" where c is the rood directory
  +for axiscpp source. There you find autogen.sh, configure.ac etc.
  +
  +to build go to $AXISCPP_HOME dirctory.
  +sh autogen.sh
  +
  +To avoid cluttering of the source with object files use the build directory
  +to generate your object files.
  +
  +Now from c/build directory run
  +sh runconfigure
  +
  +This will create all the Makefiles in a tree starting from build directory.
  +make
  +then
  +make install
  +
  +this will install libaxiscpp_mod.so in c/release directory.
  +copy this to <apache home>/libexec directory and restart apache
  +to load the axisengine in apache.
  +
  +Note: in $AXISCPP_HOME/include you have folder called xercesc apache1_3
  +apache2_0. Copy the corresponding include files into them.
  +
  +To build samples
  +=====================
  +Go to the samples folder
  +$(AXISCPP_HOME)/src/server/samples
  +and select the sample you want. As an example we try on
  +simplewebservice
  +type the following commands in that order
  +sh autogen.sh
  +sh runconfig
   make
  +make install
  +
  +this will install the sample library in /usr/local/apache/Axis/webservices 
  +
  +note: the server.wsdd file for this sample has to be put in
  +/usr/local/apache/Axis/conf folder.
  +This path is hardcoded in Axis.cpp file as following
   
  -If the build successful, libaxiscpp.so should have been created in 
  -axiscpp/release directory.
  +#define WSDDFILEPATH "/usr/local/apache/Axis/conf/server.wsdd"
   
  
  
  

Mime
View raw message