[prev in list] [next in list] [prev in thread] [next in thread]
List: webservices-general
Subject: cvs commit: ws-site/targets/axis/cpp lininstall-guide.html lininstall-guide.pdf linuser-guide.html l
From: damitha () apache ! org
Date: 2004-05-07 4:29:37
Message-ID: 20040507042937.16881.qmail () minotaur ! apache ! org
[Download RAW message or body]
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>>
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic