You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ws.apache.org by da...@apache.org on 2004/05/07 06:29:37 UTC
cvs commit: ws-site/targets/axis/cpp lininstall-guide.html lininstall-guide.pdf linuser-guide.html linuser-guide.pdf
damitha 2004/05/06 21:29:37
Modified: targets/axis/cpp lininstall-guide.html lininstall-guide.pdf
linuser-guide.html linuser-guide.pdf
Log:
Revision Changes Path
1.12 +11 -14 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.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- lininstall-guide.html 6 May 2004 10:51:24 -0000 1.11
+++ lininstall-guide.html 7 May 2004 04:29:37 -0000 1.12
@@ -322,7 +322,7 @@
</div>
<p>We tested with the following</p>
<ul>
-<li>Redhat Linux 8.0(2.4.18-14) RedhatLinux9.0(2.4.20-8), Dabian(2.6.3-1-686)(unstable)</li>
+<li>RedhatLinux9.0(2.4.20-8), Dabian(2.6.3-1-686)(unstable), Redhat Linux8.0(2.4.18-14)</li>
<li>Apache 1.3 [apache_1.3.27.tar .gz, apache_1.3.28.tar.gz)] (Source), Apache2.0 (source)</li>
<li>expat [expat-1.95.7.tar.gz](Source) </li>
</ul>
@@ -426,12 +426,12 @@
</p>
<p>If you are using xercesc parser copy the xercesc include files</p>
<p>
-<strong>$ cp -rf <xercescinstdirectory>/include/* $AXISCPP_HOME/include/xercesc/</strong>
+<strong>$ cp -rf <xercescinstdirectory>/include/xercesc/* $AXISCPP_HOME/include/xercesc/</strong>
</p>
<p>
<strong>$ cd $AXISCPP_HOME</strong>
</p>
-<p>The Folder called deploy in the $AXISCPP_HOME/ should be copied to apache root folder .Rename the deploy folder as "Axis" . Give all permissions to this folder.<br>
+<p>The Folder called deploy in the $AXISCPP_HOME/ should be copied to your place of choice. Rename the deploy folder as "Axis" . Give all permissions to this folder.<br>
<br>
<br>
<strong>$ cp -rf $AXISCPP_HOME/deploy /usr/local</strong>
@@ -461,7 +461,7 @@
<p>If you are using expat parser do the following<br>
</p>
<p>set <strong>EXPAT_HOME</strong>="<Your expat installation root folder>"</p>
-<p>set <strong>LD_LIBRARY_PATH="$EXPAT_HOME/lib:AXISCPP_HOME/bin"</strong> (do this in your .bash_profile)<br>
+<p>set <strong>LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$EXPAT_HOME/lib:$AXISCPP_HOME/bin:$AXIS_HOME"</strong> (do this in your .bash_profile)<br>
<br>
<br>
<strong>cd $AXISCPP_HOME/src/soap</strong>
@@ -475,10 +475,7 @@
</p>
<p>If you are using Xerces-c parser do the following</p>
<p>set <strong>XERCESC_HOME</strong>="<Your xercesc installation root folder>"</p>
-<p>set <strong>LD_LIBRARY_PATH="$XERCESC_HOME/lib"</strong> (do this in your .bash_profile)<br>
-<br>
-<strong>cp -rf $XERCESC_HOME/include/xercesc/* $AXISCPP_HOME/include/xercesc/</strong>
-<br>
+<p>set <strong>LD_LIBRARY_PATH="$XERCESC_HOME/lib:$AXISCPP_HOME/bin:$AXIS_HOME"</strong> (do this in your .bash_profile)<br>
<br>
<strong>cd $AXISCPP_HOME/src/soap</strong>
<br>
@@ -523,7 +520,7 @@
<br>
<br>
</p>
-<p>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.</p>
+<p>libaxiscpp_mod.so (If you built for apache2 this is libaxiscpp_mod2.so), libaxiscpp_client.so, libserver_engine.so, libAdminService.so, adminclient, simple-axis_server should have been created in $AXISCPP_HOME/bin directory. Note:- you can give the install path inside the runconfigure script.</p>
<p>Now there is no need to seperately build client side and server side. When execute build.sh it will lookafter everything.<br>-----------------------------------------------------------------------</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>
@@ -542,9 +539,9 @@
<br>Then to deploy it on apache<br>
<br>
</p>
-<p>First you need to edit /usr/local/apache/conf/httpd.conf</p>
+<p>First you need to edit <apache install directory>/conf/httpd.conf</p>
<p>
-<strong>$ vi /usr/local/apache/conf/httpd.conf</strong>
+<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>
@@ -603,7 +600,7 @@
<p>
<strong>$ cd $AXISCPP_HOME</strong>
</p>
-<p>The Folder called deploy in the $AXISCPP_HOME/ should be copied to apache root folder .Rename the deploy folder as "Axis" . Give all permissions to this folder.<br>
+<p>The Folder called deploy in the $AXISCPP_HOME/ should be copied to a folder of your choice .Rename the deploy folder as "Axis" . Give all permissions to this folder.<br>
<br>
<br>
<strong>$ cp -rf $AXISCPP_HOME/deploy /usr/local</strong>
@@ -637,9 +634,9 @@
<br>Then to deploy it on apache<br>
<br>
</p>
-<p>First you need to edit /usr/local/apache/conf/httpd.conf</p>
+<p>First you need to edit <apache install directory>/conf/httpd.conf</p>
<p>
-<strong>$ vi /usr/local/apache/conf/httpd.conf</strong>
+<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>
1.11 +174 -180 ws-site/targets/axis/cpp/lininstall-guide.pdf
<<Binary file>>
1.10 +131 -12 ws-site/targets/axis/cpp/linuser-guide.html
Index: linuser-guide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cpp/linuser-guide.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- linuser-guide.html 6 May 2004 11:12:09 -0000 1.9
+++ linuser-guide.html 7 May 2004 04:29:37 -0000 1.10
@@ -298,6 +298,9 @@
</dd>
<dd>
<a href="#scls">Building Client Side for provided Samples</a>
+</dd>
+<dd>
+<a href="#handlers">Handlers</a>
<br>
</dd>
<dd>
@@ -367,7 +370,7 @@
<p>- WSDLs hosted statistically in the server.</p>
<p>- Standalone server (with HTTP support)</p>
<p>- Web server modules for Apache 1.3 &amp; Apache2 (Linux/Windows)</p>
-<p>- Basic Wrapper Class Generator tool with following functionalities.</p>
+<p>- Basic Wrapper Class Generator tool.</p>
<p>- Web interface to the deployed services and their WSDL s.</p>
<p>- Sample web services and client applications.</p>
<p>- Document style web services support<br>
@@ -378,8 +381,7 @@
<div class="h3">
<h3>Axis C++ now delivers the following key features</h3>
</div>
-<p>- Speed: Axis uses SAX (event-based) parsing to acheive significantly greater speed than earlier versions of Apache</p>
-<p>SOAP.</p>
+<p>- Speed: Axis uses SAX (event-based) parsing to acheive significantly greater speed</p>
<p>- Flexibility</p>
<p>- Stability , Component oriented Deployment</p>
<p>- Transport Framework</p>
@@ -465,7 +467,7 @@
<p>
<strong>$cp -f wsdl2ws.jar $AXISCPP_HOME/lib/axis</strong>
</p>
-<p>add this jar to the classpath as well.</p>
+<p>add this jar to the classpath as well.(In the binary distribution you don't need to create this jar. It is already in $AXISCPP_HOME/lib/axis)</p>
<p>
<a name="Server"></a>
</p>
@@ -501,12 +503,12 @@
<div class="h3">
<h3>Deploying the Service</h3>
</div>
-<p>The Folder called deploy in the <strong>$AXISCPP_HOME/</strong> should be copied to apache root folder .Rename the deploy folder as <strong>"Axis"</strong> . Give all permissions to this folder.</p>
+<p>The Folder called deploy in the <strong>$AXISCPP_HOME/</strong> should be copied to a folder of your choice .Rename the deploy folder as <strong>"Axis"</strong> . Give all permissions to this folder.</p>
<p>
-<strong>$ cp –rf $AXISCPP_HOME/deploy /usr/local/apache</strong>
+<strong>$ cp –rf $AXISCPP_HOME/deploy /usr/local</strong>
</p>
<p>
-<strong>$ cd /usr/local/apache</strong>
+<strong>$ cd /usr/local</strong>
</p>
<p>
<strong>$ mv deploy Axis</strong>
@@ -516,7 +518,7 @@
</p>
<p>Now set the environment variable <strong>AXIS_HOME</strong> pointing to this directory.</p>
<p>
-<strong>AXIS_HOME="/usr/local/apache/Axis"</strong>
+<strong>AXIS_HOME="/usr/local/Axis"</strong>
</p>
<p>Note that inside $AXIS_HOME directory there are files called axiscpp.conf_linux and axiscpp.conf_win. Rename axiscpp.conf_linux to axiscpp.conf. Make sure that it has read permissions. This file contains key, value pairs of paths used by the Axis Soap Engine. You can change the WSDDFILEPATH and AXISLOGPATH inside this file according to your choice.</p>
<p>$ <strong>cd</strong> <strong>$AXISCPP_HOME/samples/server<br>$ sh build.sh<br>
@@ -535,7 +537,7 @@
<br>
<strong><service></strong>
<br>
-<strong><service name ="Calculator" provider ="CPP:RPC" description:"Simple calculator web service"> <parameter name="classname" value = "/usr/local/apache/Axis/webservices/libcalculator.so" /></strong>
+<strong><service name ="Calculator" provider ="CPP:RPC" description:"Simple calculator web service"> <parameter name="classname" value = "/usr/local/Axis/webservices/libcalculator.so" /></strong>
</p>
<p>
<strong><parameter name= "allowedMethods" value="add sub mul div "/> </service></strong>
@@ -544,8 +546,6 @@
<p>
<strong></deployment></strong>
</p>
-<p>You have to rename the relevant server.wsdd to match with the Apache version that you are using. <br>
-</p>
<p>Start the Apache server</p>
<p>
<strong>$ /usr/local/apache/bin/apachectl start</strong>
@@ -656,6 +656,9 @@
</p>
<strong>Restart Apache</strong>
<br>
+<p>
+<a name="scls"></a>
+</p>
<br>
<div class="h3">
<h3>Building Client Side of the provided samples</h3>
@@ -683,7 +686,7 @@
<strong>$ sh build.sh</strong>
<br>
<br>
-<p>sample executables will be created in your current folder.<br>to run the samples for example</p>
+<p>sample executables will be created in your current folder.<br>to run samples one by one</p>
<p>
<strong><strong>$ ./base localhost 80 </strong></strong>
</p>
@@ -692,12 +695,128 @@
<br>
</strong></strong>
</p>
+<p>to run all the samples at once<br>sh run_interoptests.sh (Note: local host and port 80 is assumed)</p>
<p>
<strong></strong>
</p>
<br>
<p>
<strong><strong></strong></strong>
+</p>
+<p>
+<a name="handlers"></a>
+</p>
+<div class="h3">
+<h3>Handlers</h3>
+</div>
+<p>Handlers are pluggable components to Axis C++. We have included a set of sample handlers for your reference. You could write your own handlers by following the instructions which are given for the sample Handlers.</p>
+<p>Note: If you are using Client side Handlers you need to enter the following entry in the AXIS_HOME/axiscpp.conf configuration file.</p>
+<p>CLIENTWSDDFILEPATH:Axis\conf\client.wsdd</p>
+<p>After entering this entry your AXIS_HOME/axiscpp.conf configuration file will look like:</p>
+<p> AXISLOGPATH:Axis\logs\AxisLog.txt</p>
+<p> WSDDFILEPATH:Axis\conf\server.wsdd</p>
+<p> CLIENTWSDDFILEPATH:Axis\conf\client.wsdd</p>
+<br>
+<p>
+<strong><strong>Testing the sample Handlers</strong></strong>
+</p>
+<p>We have included the following sample Handlers for your reference.</p>
+<p>1) echoStringHeaderHandler (A server side handler sample)</p>
+<p> This sample handler will simply echo (i.e send back) the string which you send in the SOAP request.</p>
+<p>2) testHandler (A client side handler sample)</p>
+<p> This sample handler will simply add a SOAP Header to the generated SOAP request.</p>
+<br>
+<p>Please note that these are very primitive sample handlers and are presented here to give you an idea about writing your own Handlers.</p>
+<br>
+<p>
+<strong><strong>echoStringHeaderHandler</strong></strong>
+</p>
+<p>
+<strong><strong>Building the Sample Handlers in RedHat linux</strong></strong>
+</p>
+<br>
+<p>
+<strong><strong>Building echoStringHeaderHandler (A server side handler sample)</strong></strong>
+</p>
+<p>The build files are available at AXISCPP_HOME/samples/server/echoStringHeaderHandler. Change your current directory to this direcotory and then you could execute the following.</p>
+<p> sh autogen.sh</p>
+<p> sh runconfig</p>
+<p> make</p>
+<p> make install</p>
+<p>The handler so file will be created at $AXIS_HOME/handlers/custom/echoStringHeaderHandler.</p>
+<p>
+<strong><strong>Configuring the Handler</strong></strong>
+</p>
+<p>Now edit the AXIS_HOME/conf/server.wsdd to include the handler for a particular service.</p>
+<br>
+<p><service name="Calculator" provider="CPP:RPC" description="Simple Calculator Axis C++ Service "></p>
+<p><requestFlow name="CalculatorHandlers"></p>
+<p><handler name="ESHHandler" type="AXIS_HOME/handlers/custom/echoStringHeaderHandler/libeshhandler.so"></p>
+<p></handler></p>
+<p></requestFlow></p>
+<p><responseFlow name="CalculatorHandlers"></p>
+<p><handler name="ESHHandler" type="AXIS_HOME/handlers/custom/echoStringHeaderHandler/libeshhandler.so"></p>
+<p></handler></p>
+<p></responseFlow></p>
+<p><parameter name="allowedMethods" value="add sub mul div "/></p>
+<p><parameter name="className" value="Axis\webservices\Calculator.dll" /></p>
+<p></service></p>
+<br>
+<p>Note: Make sure you specify the correct path of the handler so in the server.wsdd file. Replace the AXIS_HOME with the exact relative path which AXIS_HOME points to. (eg: type="/usr/local/apache2/Axis/handlers/custom/echoStringHeaderHandler/libeshhandler.so )</p>
+<p>Now you are almost done to run your server side handler.</p>
+<p>Restart the Apache server and that is it.</p>
+<p>
+<strong><strong>Running the Handler</strong></strong>
+</p>
+<p>Since this Handler is configured to the Calculator web service in the above step, this Handler will be executed when a client send a SOAP request to the Calculator web service.</p>
+<br>
+<p>
+<strong><strong>testHandler</strong></strong>
+</p>
+<p>
+<strong><strong>Building the Sample Handlers in RedHat linux</strong></strong>
+</p>
+<br>
+<p>
+<strong><strong>Building testHandler (A client side handler sample)</strong></strong>
+</p>
+<p>The build files are available at AXISCPP_HOME/samples/client/testHandler. Change your current directory to this direcotory and then you could execute the following.</p>
+<p> sh autogen.sh</p>
+<p> sh runconfig</p>
+<p> make</p>
+<p> make install</p>
+<p>The handler so file will be created at $AXIS_HOME/handlers/client/test_handler.</p>
+<p>
+<strong><strong>Configuring the Handler</strong></strong>
+</p>
+<p>Now edit the AXIS_HOME/conf/client.wsdd to include the handler for a particular service.</p>
+<br>
+<p><service name="Calculator" provider="CPP:DOCUMENT" description="Calculator web service"></p>
+<p><requestFlow name="CalculatorHandlers"></p>
+<p><handler name="TestHandler" type="AXIS_HOME/handlers/client/test_handler/libtest_client_handler.so"></p>
+<p></handler></p>
+<p></requestFlow></p>
+<p></service></p>
+<br>
+<p>Note: Make sure you specify the correct path of the handler so in the client.wsdd file. Replace the AXIS_HOME with the exact relative path which AXIS_HOME points to. (eg: type="/usr/local/apache2/Axis/handlers/client/test_handler/libtest_client_handler.so)</p>
+<p>Now you are almost done to run your client side handler.</p>
+<p>Note: If you are using Client side Handlers you need to enter the CLIENTWSDDFILEPATH entry in the AXIS_HOME/axiscpp.conf configuration file. (See above)</p>
+<p>
+<strong><strong>Running the Handler</strong></strong>
+</p>
+<p>Since this Handler is configured to the Calculator web service in the above step, this Handler will be executed when you run the calculator web service client. (It is at AXISCPP_HOME/samples/client/simple/calculator)</p>
+<br>
+<p>
+<strong><strong>Handler Notes:</strong></strong>
+</p>
+<p>1) You can see the Handler behavior through the TCP Monitor. (TCP Monitor is a Axis Java tool)</p>
+<p>2) To get an idea of Handlers look at the Handler sample source files.</p>
+<p> a. echoStringHeaderHandler (AXISCPP_HOME/samples/server/echoStringHeaderHandler)</p>
+<p></p>
+<p> b. testHandler (AXISCPP_HOME/samples/client/testHandler)</p>
+<p>
+<br>
+<br>
</p>
<p>
<strong><strong><a name="Getting"></a></strong></strong>
1.10 +307 -221 ws-site/targets/axis/cpp/linuser-guide.pdf
<<Binary file>>