roshan 2004/06/15 03:05:11
Modified: targets/axis/cpp lininstall-guide.pdf lininstall-guide.html
Log:
Changed the Linux Installation Guide.Changed by Rangika
Revision Changes Path
1.15 +59 -119 ws-site/targets/axis/cpp/lininstall-guide.pdf
<<Binary file>>
1.16 +115 -24 ws-site/targets/axis/cpp/lininstall-guide.html
Index: lininstall-guide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cpp/lininstall-guide.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- lininstall-guide.html 14 Jun 2004 14:04:31 -0000 1.15
+++ lininstall-guide.html 15 Jun 2004 10:05:11 -0000 1.16
@@ -295,12 +295,26 @@
<p>You can download the Axis C++ source or binary from one of the apache mirror
sites<br> http://ws.apache.org/axis/cpp/download.html<br>You can get expat from the
uri http://sourceforge.net/projects/expat/<br> You can get xercesc from the uri
http://www.xml.apache.org/xerces-c/download.cgi<br> You must define some environment
variables in order to build.AXISCPP_HOME is where you checkout Axis C++</p>
<br>
<p>
-<strong>AXISCPP_HOME="/home/damitha/projects/axiscpp"AXIS_HOME="/home/damitha/Axis"EXPAT_HOME="/usr/local/expat1957"XERCESC_HOME="/usr/local/xerces-c"LD_LIBRARY_PATH="$XERCESC_HOME/lib:$EXPAT_HOME/lib:$AXISCPP_HOME/bin:$AXIS_HOME/libs:$LD_LIBRARY_PATH"export
AXISCPP_HOME AXIS_HOME XERCESC_HOME EXPAT_HOME LD_LIBRARY_PATH</strong>
+<strong>AXISCPP_HOME="/home/damitha/projects/axiscpp"</strong>
+<br>
+<strong>AXIS_HOME="/usr/local/Axis"</strong>
+<br>
+<strong>EXPAT_HOME="/usr/local/expat1957"</strong>
+<br>
+<strong>XERCESC_HOME="/usr/local/xerces-c"</strong>
+<br>
+<strong>LD_LIBRARY_PATH="$XERCESC_HOME/lib:$EXPAT_HOME/lib:$AXISCPP_HOME/bin:$AXIS_HOME/libs:$LD_LIBRARY_PATH"</strong>
+<br>
+<strong>export AXISCPP_HOME AXIS_HOME XERCESC_HOME EXPAT_HOME
LD_LIBRARY_PATH</strong>
</p>
<p>
<strong>A note about AXIS_HOME</strong>
</p>
-<p>Copy $AXISCPP_HOME/deploy folder to a place of your choice and define AXIS_HOME
pointing to it.<br>cp -rf $AXISCPP_HOME/deploy /usr/local/<br>mv /usr/local/deploy
/usr/local/Axis<br>Give read write permissions to /usr/local/Axis<br>
+<p>Copy $AXISCPP_HOME/deploy folder to a place of your choice and define AXIS_HOME
pointing to it.<br>
+<strong>cp -rf $AXISCPP_HOME/deploy /usr/local/</strong>
+<br>
+<strong>mv /usr/local/deploy /usr/local/Axis</strong>
+<br>Give read write permissions to /usr/local/Axis<br>
<br>
</p>
<p>EXPAT_HOME points to where you installed expat<br>XERCESC_HOME points to where
you installed xereces-c</p>
@@ -351,44 +365,121 @@
<p>#AC_OUTPUT(Makefile src/Makefile src/common/Makefile src/soap/Makefile
src/wsdd/Makefile src/xml/Makefile<br> src/transport/Makefile
src/transport/axis/Makefile src/engine/Makefile src/engine/server/Makefile
src/engine/client/Makefile<br> src/server/Makefile src/server/apache/Makefile
src/server/simple_axis_server/Makefile src/server/adminservice/Makefile<br>
src/client/Makefile src/client/adminclient/Makefile src/xml/xerces/Makefile)</p>
<p>#}apache1.3 block ends</p>
<p>You also need to do a selection at $AXISCPP_HOME/src/xml/Makefile.am</p>
-<p>SUBDIRS = expat xerces #Here I build both expat and xerces libraries<br>#SUBDIRS
= expat<br>#SUBDIRS = xerces</p>
+<p>
+<strong>SUBDIRS = expat xerces #Here I build both expat and xerces
libraries</strong>
+<br>
+<strong>#SUBDIRS = expat</strong>
+<br>
+<strong>#SUBDIRS = xerces</strong>
+</p>
<p>And again in $AXISCPP_HOME/src/server/Makefile.am</p>
-<p>#if you use apache2<br>SUBDIRS = apache2 adminservice #Here I build for
Apache2<br> #if you use apache1.3<br>#SUBDIRS = apache adminservice</p>
+<p>
+<strong>#if you use apache2</strong>
+<br>
+<strong>SUBDIRS = apache2 adminservice #Here I build for Apache2</strong>
+<br>
+<strong>#if you use apache1.3</strong>
+<br>
+<strong>#SUBDIRS = apache adminservice</strong>
+</p>
<p>Now you need to copy header files from apache and parser that you use</p>
-<p>Install xercesc at /usr/local/xerces-c, expat at /usr/local/expat1957,apache2 at
/usr/local/apache2 and apache1.3 at /usr/local/apache</p>
+<p>I have installed xercesc at /usr/local/xerces-c, expat at
/usr/local/expat1957,apache2 at /usr/local/apache2 and apache1.3 at
/usr/local/apache</p>
+<p>I'm going to build Axis C++ for apache2 and for both xercesc and expat(But I'm
going to<br>use only one parser. But anyway I can give instructions to build both as
you've seen earlier)<br>
+</p>
<p>
-<strong>Building Axis C++ for apache2 and for both xercesc and expat. (better to
use one)</strong>Instructions to build both are given above</p>
-<p>cp -rf /usr/local/xerces-c/include/xercesc/*
$AXISCPP_HOME/include/xercesc/<br>cp -f /usr/local/expat1957/include/expat.h
$AXISCPP_HOME/include/expat/<br>cp -f /usr/local/apache2/include/*
$AXISCPP_HOME/include/apache2_0/</p>
-<p>Then can build Axis C++ server, client,parser libraries, transport library and
server/client samples by, cd $AXISCPP_HOME<br>sh build.sh</p>
+<strong>cp -rf /usr/local/xerces-c/include/xercesc/*
$AXISCPP_HOME/include/xercesc/</strong>
+<br>
+<strong>cp -f /usr/local/expat1957/include/expat.h
$AXISCPP_HOME/include/expat/</strong>
+<br>
+<strong>cp -f /usr/local/apache2/include/* $AXISCPP_HOME/include/apache2_0/</strong>
+</p>
+<p>Then I can build Axis C++ server, client,parser libraries, transport library and
server/client samples by,<br>
+<strong>cd $AXISCPP_HOMEsh build.sh</strong>
+</p>
+<p>Once you have finished, have a look at $AXISCPP_HOME/build_errors,<br>
$AXISCPP_HOME/samples/server/sample_server_build_errors
and<br>$AXISCPP_HOME/samples/client/sample_client_build_errors to identify any
warnings and errors. Most probably you will see many warnings. Just ignore them. But
if you see any errors it means that build was not successful and check whether you
followed the instructions carefully. Note that if you see errors on build_errors file
then client samples will also fail since it depends on libaxiscpp_client.so.</p>
<p>You can see the folder $AXISCPP_HOME/bin to see what are created</p>
-<p>libaxis_mod.so is apache module which is loaded when apache
loads<br>libaxis_mod2.so is apache2 module which is loaded when apache2
loads<br>libserver_engine.so is the Axis C++ server engine which is loaded by
libaxis_mod(2).so module<br>libaxiscpp_client.so is Axis C++ client
library<br>libaxis_transport.so is the Axis C++ client transport
library<br>libaxis_expat.so is the expat parser library implementation for Axis
C++<br>libaxis_xercesc.so is the xercesc parser library implmentation for Axis C++</p>
+<p>libaxiscpp_mod.so is apache module which is loaded when apache
loads<br>libaxiscpp_mod2.so is apache2 module which is loaded when apache2
loads<br>libserver_engine.so is the Axis C++ server engine which is loaded by
libaxis_mod(2).so module<br>libaxiscpp_client.so is Axis C++ client
library<br>libaxis_transport.so is the Axis C++ client transport
library<br>libaxis_expat.so is the expat parser library implementation for Axis
C++<br>libaxis_xercesc.so is the xercesc parser library implmentation for Axis C++</p>
<p>Also $AXISCPP_HOME/samples/server samples are built and installed in
$AXIS_HOME/web_services</p>
<p>$AXISCPP_HOME/samples/client samples are built and executables are in
$AXISCPP_HOME/samples/client</p>
-<p>Parser and Transport libraries are loaded into axis engine when it is loaded by
apache.</p>
-<p>Now you need to add to $/conf/httpd.conf<br>$ vi /conf/httpd.conf</p>
+<p>Now you need to add to $<apache install directory>/conf/httpd.conf<br>
+<strong>$ vi <apache install directory>/conf/httpd.conf</strong>
+</p>
<p>At the bottom of the file you have to include following lines and save it.</p>
<p>LoadModule axis_module modules/libaxiscpp_mod2.so (in apache1.3 replace modules
with libexec and libaxiscpp_mod2.so with libaxiscpp_mod.so)<br>
-<br>SetHandler axis<br>
+<strong><Location /axis></strong>
+<br>
+<strong>SetHandler axis</strong>
+<br>
+<strong></Location></strong>
</p>
<p>Now you need the deployment descripter to deploy server samples you built</p>
-<p>cd $AXIS_HOME/conf<br>mv server.wsdd_linux server.wsdd</p>
+<p>
+<strong>cd $AXIS_HOME/conf</strong>
+<br>
+<strong>mv server.wsdd_linux server.wsdd</strong>
+<br>
+<strong>cd ..</strong>
+<br>
+<strong>mv axiscpp.conf_linux axiscpp.conf</strong>
+</p>
<p>In $AXIS_HOME/axiscpp.conf file you can give paths to<br>your log files,
configuration files libraries etc</p>
-<p># The comment character is '#'<br>#Available directives are as follows<br>#(Some
of these directives may not be implemented yet)<br>#<br>#WSDDFilePath:The path to the
server wsdd<br>#LogPath:The path to the axis log<br>#ClientLogPath:The path to the
axis client log<br>#ClientWSDDFilePath:The path to the client
wsdd<br>#Transport_http:The HTTP transport library<br>#Transport_smtp:The SMTP
transport library<br>#XMLParser:The xml parser library.</p>
-<p>LogPath:/usr/local/Axis/logs/AxisLog<br>WSDDFilePath:/usr/local/Axis/conf/server.wsdd<br>ClientLogPath:/usr/local/Axis/logs/AxisClientLog<br>XMLParser:/usr/local/Axis/libs/libaxis_xmlparser.so<br>Transport_http:/usr/local/Axis/libs/libaxis_transport.so</p>
-<p>Now we need to copy neccessary libraries to the correct places and start apache.
To do that you can find scripts written in $AXIS_HOME.<br>cd $AXIS_HOME</p>
-<p>To deploy on apache2<br>sh deploy_apache2.sh</p>
-<p>To deploy on apache<br>sh deploy_apache.sh</p>
-<p>All the libraries are loaded.</p>
+<p>
+<strong># The comment character is '#'</strong>
+<br>
+<strong>#Available directives are as follows</strong>
+<br>
+<strong>#(Some of these directives may not be implemented yet)</strong>
+<br>
+<strong>#</strong>
+<br>
+<strong>#WSDDFilePath:The path to the server wsdd</strong>
+<br>
+<strong>#LogPath:The path to the axis log</strong>
+<br>
+<strong>#ClientLogPath:The path to the axis client log</strong>
+<br>
+<strong>#ClientWSDDFilePath:The path to the client wsdd</strong>
+<br>
+<strong>#Transport_http:The HTTP transport library</strong>
+<br>
+<strong>#Transport_smtp:The SMTP transport library</strong>
+<br>
+<strong>#XMLParser:The xml parser library.</strong>
+</p>
+<p>
+<strong>LogPath:/usr/local/Axis/logs/AxisLogWSDDFilePath:/usr/local/Axis/conf/server.wsddClientLogPath:/usr/local/Axis/logs/AxisClientLogXMLParser:/usr/local/Axis/libs/libaxis_xmlparser.soTransport_http:/usr/local/Axis/libs/libaxis_transport.so</strong>
+</p>
+<p>Now we need to copy neccessary libraries to the correct places and start apache.
To do that you can find scripts written in $AXIS_HOME.<br>
+<strong>cd $AXIS_HOME</strong>
+</p>
+<p>To deploy on apache2<br>
+<strong>sh deploy_apache2.sh</strong>
+</p>
+<p>To deploy on apache<br>
+<strong>sh deploy_apache.sh</strong>
+</p>
+<p>When you run the above script all the libraries are copied into corresponding
places.<br>libaxiscpp_mod2.so is copied to /modules folder.<br>libserver_engine.so and
libaxis_expat.so is copied to $AXIS_HOME/libs folder(and renamed
libaxis_xmlparser.so). Also apache is started and libaxiscpp_mod2.so is loaded into
apache.<br>libaxiscpp_mod2.so is the apache module for Axis C++. This will in term
load Axis C++ server engine (libserver_engine.so)<br>
+<strong>Note that libaxis_xmlparser.so is loaded by the engine dynamically as
parsing is required from the engine.</strong>
+</p>
<p>
<strong>Note that in the line no. 12 of the script above we change the name
libaxis_expat.so to libaxis_xmlparser.so. If we use xerces we need to change
libaxis_xercesc.so to libaxis_xmlparser.so</strong>.</p>
-<p>If you have done installation successfully it will display the Axis C++ welcome
page when you point to URI http://localhost/axis</p>. <p>
-<strong>Note: In the axis welcome page all the services in
$AXIS_HOME/conf/server.wsdd are listed. This does not mean that the libraries
corresponding to these services are deployed yet. It merely list whatever in the
server.wsdd.</strong>
+<p>If you have done installation successfully it will display the Axis C++ welcome
page when you point to URI http://localhost/axis</p>
+<p>
+<strong>Note: In the axis welcome page all the services in
$AXIS_HOME/conf/server.wsdd are listed. This does not mean that the libraries
corresponding to these services are deployed yet. It merely lists whatever in the
server.wsdd.</strong>
</p>
<p>To run interop samples</p>
-<p>cd $AXISCPP_HOME/samples/client<br>sh run_interoptests.sh<br>By default this
script assumes that apache is running in the localhost at port 80<br>If you want
other<br>sh run_interoptests.sh <server> <port><br>eg: sh
run_interoptests.sh -u localhost -p 80<br>
-</p>
+<p>
+<strong>cd $AXISCPP_HOME/samples/client</strong>
<br>
-<a href="lininstall-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"><br>
PDF</a>
+<strong>sh run_interoptests.sh</strong>
+<br>By default this script assumes that apache is running in the localhost at port
80<br>If you want other<br>
+<strong>sh run_interoptests.sh <server> <port></strong>
+<br>eg: sh run_interoptests.sh -u localhost -p 80<br>
+</p>
+<p>
+<strong>Note for people who downloaded Axis C++ binary.In this case all the
libraries are already generated for you in $AXISCPP_HOME/bin.You need to just build
samples.</strong>
+</p>
+<strong></strong><strong> PDF</strong> <strong></strong>
</li>
</ul>
<div id="pdf" align="right">
