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/12/18 05:02:59 UTC
cvs commit: ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp lininstall-guide.ihtml linuser-guide.ihtml
damitha 2003/12/17 20:02:59
Modified: contrib/axisdocs/src/documentation/content/xdocs/cpp
lininstall-guide.ihtml linuser-guide.ihtml
Log:
Updated the linux documentation for Axis C++
Revision Changes Path
1.2 +54 -20 ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/lininstall-guide.ihtml
Index: lininstall-guide.ihtml
===================================================================
RCS file: /home/cvs/ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/lininstall-guide.ihtml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- lininstall-guide.ihtml 31 Oct 2003 20:41:55 -0000 1.1
+++ lininstall-guide.ihtml 18 Dec 2003 04:02:59 -0000 1.2
@@ -55,32 +55,31 @@
<p>We tested with the following</p>
<ul>
- <li>Redhat Linux 8.0(2.4.18-14) RedhatLinux9.0(2.4.20-8)</li>
- <li>Apache 1.3 [apache_1.3.27.tar .gz, apache_1.3.28.tar.gz)] (Source)</li>
+ <li>Redhat Linux 8.0(2.4.18-14) RedhatLinux9.0(2.4.20-8), Mandrake8.0(2.4.8-26)</li>
+ <li>Apache 1.3 [apache_1.3.27.tar .gz, apache_1.3.28.tar.gz)] (Source), Apache2.0 (source)</li>
<li>Xerces C++ [xerces-c-src2_2_0.tar.gz](Source) >(Source)</li>
</ul>
<p></p>
-<p><b>Getting the source or binary from the mirror site and setting the
+<p><b>Downloading the source or binary from the mirror site and setting the
environment variables</b></p>
-<p>User can download the Axis C++ source or binary from one of the apache
-mirror sites</p>
+<p>You can download the Axis C++ source or binary from one of the apache
+mirror sites<a href="http://ws.apache.org/axis/cpp/download.html">http://ws.apache.org/axis/cpp/download.html</a></p>
<p></p>
-<p>Your downloaded distribution is axis-c-src-alpha-linux.tar.gz. After you
+<p>Your downloaded distribution is axis-c-src-1_0-linux.tar.gz. After you
extracting it for example as,
-<strong>/home/axisuser/projects/axis-c-src-alpha-linux</strong> you can
+<strong>/home/axisuser/projects/axis-c-src-1_0-linux</strong> you can
rename it as <strong>axis_c</strong></p>
<p></p>
-<p>The directory where you extracted the tar ball will be called
-<axiscpphome> from now on. We further assume that the user dose the
+<p>You have to set the environment variable $AXISCPP_HOME to the directory where you extracted the tar ball.. We further assume that the user dose the
installation and has the linux user account axisuser. For example I have my
-<axiscpphome> as following.</p>
+<AXISCPP_HOME> as following.</p>
<p>/home/axisuser/projects</p>
<p><a name="Installing"></a></p>
@@ -104,7 +103,7 @@
<p><strong>$ ./configure --enable-module=so</strong></p>
-<p>Note:- Here "so" are simple letters</p>
+<p>Note:- Here "so" is simple letters</p>
<p></p>
@@ -195,11 +194,45 @@
<p><strong>$ make</strong></p>
<p><strong>$ make install</strong></p>
+<p>
+<p>
+-----------------------------------------------------------------------
+</p>
+<strong>NOTE: </strong>If you use apache2.0 following two small changes has to be done in $AXISCPP_HOME/configure.ac and $AXISCPP_HOME/src/server/Makefile.am)
+</p>
+<p>
+in $AXISCPP_HOME/configure.ac
+</p>
+<p>
+comment
+</p>
+<p>
+<strong>
+AC_OUTPUT(Makefile src/Makefile src/common/Makefile src/engine/Makefile src/soap/Makefile src/wsdd/Makefile src/xml/Makefile src/server/Makefile src/server/apache/Makefile)
+</strong>
+</p>
+<p>
+and uncomment
+</p>
+<p>
+<strong>
+#AC_OUTPUT(Makefile src/Makefile src/common/Makefile src/engine/Makefile src/soap/Makefile src/wsdd/Makefile src/xml/Makefile src/server/Makefile src/server/apache2/Makefile)
+</strong>
+</p>
+<p>
+in $AXISCPP_HOME/src/server/Makefile.am
+</p>
+<p>
+change
+SUBDIRS = apache
+to
+SUBDIRS = apache2
+</p>
+<p>
+-----------------------------------------------------------------
+</p>
-<p class="command"><span class="command"></span></p>
-
-<p>Now libaxiscpp_mod.so should have been created in $AXISCPP_HOME/bin
-directory. Note:- you can give the install path inside the runconfigure
+<p>Now libaxiscpp_mod.so (If you built for apache2 this is libaxiscpp_mod2.so) should have been created in $AXISCPP_HOME/bin directory. Note:- you can give the install path inside the runconfigure
script.There will be link errors if you don't use correct version of
xerces-c.</p>
@@ -216,7 +249,7 @@
<p></p>
-<p><strong>LoadModule axis_module libexec/libaxiscpp_mod.so</strong></p>
+<p><strong>LoadModule axis_module libexec/libaxiscpp_mod.so (in apache2 replace libexec with modules and libaxiscpp_mod.so with libaxiscpp_mod2.so)</strong></p>
<p><strong><Location /axis></strong></p>
@@ -226,11 +259,12 @@
<p class="command"><span class="command"></span></p>
-<p>Copy /home/axisuser/projects/axis_c/bin/libaxiscpp_mod.so into
-/usr/local/Apache/libexec/</p>
+<p>Copy $AXISCPP_HOME/bin/libaxiscpp_mod.so into
+/usr/local/Apache/libexec/ (in apache2 replace libexec with modules and libaxiscpp_mod.so with libaxiscpp_mod2.so)</p>
-<p><strong>$cp -f /home/axisuser/projects/axis_c/bin/libaxiscpp_mod.so
-/usr/local/apache/libexec</strong></p>
+<p><strong>$cp -f $AXISCPP_HOME/bin/libaxiscpp_mod.so
+/usr/local/apache/libexec (in apache2 replace
+libexec with modules and libaxiscpp_mod.so with libaxiscpp_mod2.so)</strong></p>
<p class="command"><span class="command"></span></p>
1.4 +34 -50 ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/linuser-guide.ihtml
Index: linuser-guide.ihtml
===================================================================
RCS file: /home/cvs/ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/linuser-guide.ihtml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- linuser-guide.ihtml 28 Nov 2003 03:59:46 -0000 1.3
+++ linuser-guide.ihtml 18 Dec 2003 04:02:59 -0000 1.4
@@ -1,7 +1,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html">
- <title>Axis C++ User Guide (Alpha)</title>
+ <title>Axis C++ User Guide</title>
</head>
<body>
@@ -148,7 +148,7 @@
<p>- Axis C++</p>
-<p>- Apache1.3</p>
+<p>- Apache1.3 (or Apache2.0)</p>
<p>- xerces-C</p>
@@ -168,7 +168,7 @@
<p></p>
-<p><strong>$AXISCPP_HOME/src/server/samples/interoptests/base</strong></p>
+<p><strong>$AXISCPP_HOME/samples/client/interoptests/base </strong></p>
<p></p>
@@ -180,7 +180,7 @@
<p></p>
-<p><strong>$axiscpp_home/src/wsdl</strong></p>
+<p><strong>$AXISCPP_HOME/src/wsdl</strong></p>
<p></p>
@@ -545,7 +545,7 @@
<p></p>
-<p><strong>$ cp –rf $AXISCPP_HOME/deloy
+<p><strong>$ cp –rf $AXISCPP_HOME/deploy
/usr/local/apache</strong></p>
<p><strong>$ cd /usr/local/apache</strong></p>
@@ -577,7 +577,7 @@
<p></p>
-<p><strong>cd $AXISCPP_HOME/src/server/samples/introptests/base</strong></p>
+<p><strong>cd $AXISCPP_HOME/samples/server/introptests/base</strong></p>
<p></p>
@@ -598,7 +598,7 @@
<p>By typing this in the command line the dynamic library (
<strong>libinteropbase.so</strong> for example) is created which is used for
-the deployment. This library is automatically is placed in</p>
+the deployment. This library has to be placed in</p>
<p></p>
@@ -615,8 +615,7 @@
<p><strong><?xml version="1.0" encoding="UTF-8"?></strong><br>
<strong><deployment
-xmlns="http://xml.apache.org/axis/wsdd/"xmlns:C="http://xml.apache.org/axis/wsdd/providers/c"></strong><br>
-<strong><globalConfiguration></strong><br>
+xmlns="http://xml.apache.org/axis/wsdd/"xmlns:C="http://xml.apache.org/axis/wsdd/providers/c"></strong><br><br>
<strong>< service name="InteropBase" provider="C:RPC"
description="SOAPBuilders Interoperability Lab Round 2 base test suite
described at http://www.whitemesa.com/interop/proposal2.html
@@ -666,7 +665,7 @@
<p></p>
-<p><strong>cd $AXISCPP_HOME/src/client/samples/interoptests/base</strong></p>
+<p><strong>cd $AXISCPP_HOME/samples/client/interoptests/base</strong></p>
<p></p>
@@ -952,12 +951,6 @@
<p><strong>}</strong></p>
-<p></p>
-
-<p>Copy from <strong>$AXISCPP_HOME/bin/libaxiscpp_mod.a</strong> to
-<strong>$AXISCPP_HOME/lib/axis</strong></p>
-
-<p></p>
<p>Creating the client library</p>
@@ -983,7 +976,7 @@
<p>Now</p>
-<p><strong>cd $AXISCPP_HOME/src/client/samples/interoptests/base</strong></p>
+<p><strong>cd $AXISCPP_HOME/samples/client/interoptests/base</strong></p>
<p></p>
@@ -992,25 +985,24 @@
</strong><strong>- ansi -g -O2 -c ./*.cpp -fPIC</strong></p>
<p></p>
+<p>
+<strong>$ g++ -g -O2 -o interopbase InteropBaseClient.o SOAPStruct.o InteropTestPortType.o $AXISCPP_HOME/lib/axis/libaxiscpp_client.a $AXISCPP_HOME/bin/libaxiscpp_mod.a -L$AXISCPP_HOME/lib/xerces-c -lxerces-c -ldl</strong><br>
-<p><strong>$ g++ -g -O2 -o interopbase InteropBaseClient.o SOAPStruct.o
-InteropTestPortType.o</strong></p>
-
-<p><strong>$AXISCPP_HOME/lib/axis/libaxiscpp_client.a
-$AXISCPP_HOME/lib/axis/libaxiscpp_mod.a-</strong><strong>L$AXISCPP_HOME/lib/xerces-c
--lxerces-c -ldl<br>
-</strong><strong>$AXISCPP_HOME/src/client/lib/libaxiscpp_client.a
-</strong><strong>$AXISCPP_HOME/release/libaxiscpp_mod.a<br>
--L$AXISCPP_HOME/lib/xerces-c -lxerces-c -ldl</strong></p>
+</p>
<p></p>
-
+<p>
+Note that in the above command replace libaxiscpp_mod.a with libaxiscpp_mod2.a if you work with
+apache2
+</p>
<p>Start the Apache Server(Assuming base service is deployed.)</p>
<p><strong>$ /usr/local/apache/bin/apachectl start</strong></p>
<p>to run</p>
-
+<p>
+<strong>$ cd $AXISCPP_HOME/samples/client/interoptests/base
+</p>
<p><strong>$ ./interopbase</strong></p>
<p><a name="Handler"></a></p>
@@ -1021,10 +1013,7 @@
<p>If you want to test handlers go into the
<strong>$AXISCPP_HOME/src/server/handlers</strong> folder where example
-handlers are included (If you use the binary download sample handler
-libraries are included in <strong>$(AXIS_HOME)/handlers</strong>
-folder(assuming that you created this folder as described in installation
-guide). Several sample handlers are included there covering the concepts of
+handlers are included. Several sample handlers are included there covering the concepts of
service specific, global and transport handlers. We will show you the detail
of running a service specific handler named loghandler. The task of this
handler is writing to a file the number of times the service is accessed.</p>
@@ -1077,7 +1066,7 @@
<p>Restart the apache web server and test your handler using the web service
client for InteropBase webservice. When the client is run an entry will be
added to
-<strong>/usr/local/apache/Axis/handlers/custom/loghandler/LogAccessCountFile</strong>
+<strong>$AXIS_HOME/handlers/custom/loghandler/LogAccessCountFile</strong>
Note that the folder in which the LogAccessCountFile is created should have
write access. You can test the global handlers and transport handlers in a
similar manner. Note the change you have to make in server.wsdd. You can see
@@ -1165,7 +1154,7 @@
<p></p>
-<p><strong>$AXISCPP_HOME/samples/interoptests/base</strong>.</p>
+<p><strong>$AXISCPP_HOME/samples/server/interoptests/base</strong>.</p>
<p></p>
@@ -1422,7 +1411,7 @@
<p></p>
-<p><strong>$ cp –rf $AXISCPP_HOME/deloy
+<p><strong>$ cp –rf $AXISCPP_HOME/deploy
/usr/local/apache</strong></p>
<p><strong>$ cd /usr/local/apache</strong></p>
@@ -1447,7 +1436,7 @@
<p></p>
-<p><strong>cd $AXISCPP_HOME/src/server/samples/introptest/base</strong></p>
+<p><strong>cd $AXISCPP_HOME/samples/server/introptests/base</strong></p>
<p></p>
@@ -1458,15 +1447,14 @@
<p></p>
<p><strong>$ g++ -shared -Wl,--whole-archive -Wl,--no-whole-archive -I. -I..
--L$AXISCPP_HOME/lib/xerces-c<br>
-</strong><strong>-lxerces-c -Wl,-soname -Wl,libinteropbase.so.0 -o
+-L$AXISCPP_HOME/lib/xerces-c -lxerces-c -Wl,-soname -Wl,libinteropbase.so.0 -o
libinteropbase.so ./*.o</strong></p>
<p></p>
<p>By typing this in the command line the dynamic library (
<strong>libinteropbase.so</strong> for example) is created which is used for
-the deployment. This library is automatically is placed in</p>
+the deployment. This library has to be placed in</p>
<p></p>
@@ -1484,8 +1472,7 @@
<p><strong><?xml version="1.0" encoding="UTF-8"?></strong><br>
<strong><deployment xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:C="http://xml.apache.org/axis/wsdd/providers/c"></strong></p>
-
-<p><strong><globalConfiguration></strong><br>
+<br>
<strong>< service name="InteropBase" provider="C:RPC"
description="SOAPBuilders Interoperability Lab Round 2 base test suite
described at http://www.whitemesa.com/interop/proposal2.html
@@ -1842,12 +1829,8 @@
<p></p>
<p><strong>$ g++ -g -O2 -o interopbase InteropBaseClient.o SOAPStruct.o
-InteropTestPortType.o<br>
-</strong><strong>$AXISCPP_HOME/lib/axis/libaxiscpp_client.a
-$AXISCPP_HOME/lib/axis/libaxiscpp_mod.a <br>
--</strong><strong>L$AXISCPP_HOME/lib/xerces-c -lxerces-c -ldl <br>
-</strong><strong>$AXISCPP_HOME/lib/axis/libaxiscpp_client.a <br>
-</strong><strong>$AXISCPP_HOME/lib/axis/libaxiscpp_mod.a
+InteropTestPortType.o $AXISCPP_HOME/lib/axis/libaxiscpp_client.a
+$AXISCPP_HOME/lib/axis/libaxiscpp_mod.a -L$AXISCPP_HOME/lib/xerces-c -lxerces-c -ldl $AXISCPP_HOME/lib/axis/libaxiscpp_client.a $AXISCPP_HOME/lib/axis/libaxiscpp_mod.a
-L$AXISCPP_HOME/lib/xerces-c -lxerces-c -ldl</strong></p>
<p></p>
@@ -1861,7 +1844,9 @@
<p></p>
<p>To Run</p>
-
+<p>
+<strong>$ cd $AXISCPP_HOME/samples/client/interoptests/base
+</p>
<p><strong>$ ./interopbase</strong></p>
<p><a name="Handler1"></a></p>
@@ -1871,8 +1856,7 @@
<p></p>
<p>Sample handler libraries are included in
-<strong>$(AXIS_HOME)/handlers</strong> folder(assuming that you created this
-folder as described in installation guide). Several sample handlers are
+<strong>$(AXISCPP_HOME)/src/server/handlers</strong> folder. Several sample handlers are
included there covering the concepts of service specific, global and
transport handlers. We will show you the detail of running a service specific
handler named loghandler. The task of this handler is writing to a file the