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 2003/09/12 13:56:29 UTC
cvs commit: xml-axis/c/docs build.txt integration-guide.html integration-guide.txt user-guide.txt developer-guide.txt
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> <A HREF="#Components">Components<!-- <br> <a href="#System Management Plug">System Management</a>
---></A>
-<BR> <A HREF="#Logging/Tracing Plug">Logging/Tracing</A> <BR>
-<A HREF="#Configuration" NAME="Configuration">Configuration</A><BR>
-<A HREF="#Handlers Plug">Handlers</A> <BR> <A HREF="#Internationalization Plug">Internationalization</A>
-<BR> <A HREF="#Performance Monitoring Plug">Performance
-Monitoring</A> <BR> <A HREF="#Encoding Plug">Encoding</A> <BR>
-<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. 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? 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? 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
-<axiscpp_home></FONT></P>
-<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>goto
-<axiscpp_home>/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 <apache home directory>/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 "--enable-module=so") 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 <apache directory>/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><Location /axis></FONT></P>
-<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>SetHandler axis</FONT></P>
-<P STYLE="margin-bottom: 0cm"><FONT SIZE=3></Location></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> <A HREF="#Components">Components<!-- <br> <a href="#System Management Plug">System Management</a>
+--></A>
+<BR> <A HREF="#Logging/Tracing Plug">Logging/Tracing</A> <BR>
+<A HREF="#Configuration" NAME="Configuration">Configuration</A><BR>
+<A HREF="#Handlers Plug">Handlers</A> <BR> <A HREF="#Internationalization Plug">Internationalization</A>
+<BR> <A HREF="#Performance Monitoring Plug">Performance
+Monitoring</A> <BR> <A HREF="#Encoding Plug">Encoding</A> <BR>
+<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. 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? 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? 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
+<axiscpp_home></FONT></P>
+<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>goto
+<axiscpp_home>/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 <apache home directory>/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 "--enable-module=so") 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 <apache directory>/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><Location /axis></FONT></P>
+<P STYLE="margin-bottom: 0cm"><FONT SIZE=3>SetHandler axis</FONT></P>
+<P STYLE="margin-bottom: 0cm"><FONT SIZE=3></Location></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"