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 ro...@apache.org on 2004/07/08 13:09:18 UTC
cvs commit: ws-axis/site/src/documentation/content/xdocs/cpp winuser-guide.ihtml wininstall-guide.ihtml windev-guide.ihtml
roshan 2004/07/08 04:09:18
Modified: site/src/documentation/content/xdocs/cpp winuser-guide.ihtml
wininstall-guide.ihtml windev-guide.ihtml
Log:
Did some minor changes to the win Dev , User and Intstallation Guides.Changed by Rangika
Revision Changes Path
1.18 +5 -5 ws-axis/site/src/documentation/content/xdocs/cpp/winuser-guide.ihtml
Index: winuser-guide.ihtml
===================================================================
RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/winuser-guide.ihtml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- winuser-guide.ihtml 6 Jul 2004 05:26:26 -0000 1.17
+++ winuser-guide.ihtml 8 Jul 2004 11:09:18 -0000 1.18
@@ -73,7 +73,7 @@
<br> <br>
-2) Run the WSDL2WS tool (refer the section below 'How to use the WSDL2WS tool
+2) Run the WSDL2WS tool (refer the section below 'to use the WSDL2WS tool
on the command line') and generate the server side skeletons and wrappers.
These files will be in two new folders which are generated from the tool
called 'ServerOut' and 'ClientOut'.
@@ -191,8 +191,8 @@
<br> <br>
Lets say that the apache installation folder is APACHE_FOLDER.
<br>
-(The default installation that is for apache 1.3.X the path is "C:\Program Files\Apache Group\Apache"
- and for apache 2.X the path is "C:\Program Files\Apache Group\Apache2")
+(The default installation is apache 1.3.X and the path is "C:\Program Files\Apache Group\Apache"
+ and the path for apache 2.X is "C:\Program Files\Apache Group\Apache2")
<br>
<br>
@@ -305,8 +305,8 @@
XMLParser:WWWW<br>
<br>
-Where XXXX will be the path to a file named AxisLog (The log file)and YYYY
-will be the path to the server.wsdd file.<br>
+XXXX is the path to a file named AxisLog (The log file)and YYYY
+is the path to the server.wsdd file.<br>
<br>
i.e.<br>
LogPath:[APACHE_HOME]\Axis\logs\AxisLog.log
1.10 +34 -30 ws-axis/site/src/documentation/content/xdocs/cpp/wininstall-guide.ihtml
Index: wininstall-guide.ihtml
===================================================================
RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/wininstall-guide.ihtml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- wininstall-guide.ihtml 16 Jun 2004 05:57:11 -0000 1.9
+++ wininstall-guide.ihtml 8 Jul 2004 11:09:18 -0000 1.10
@@ -44,7 +44,7 @@
2.The folder �bin� contains sample clients and other dlls needed to run the Axis c++ server
<br> <br>
-3.Inside the "deploy" folder following sub folders exists
+3.Inside the "deploy" folder following sub folders exist
<br>
-> conf (This includes the server.wsdd, which is the deployment descriptor used for deploying services.) <br>
@@ -57,7 +57,7 @@
<br>
4. The "include" folder contains all the include files which are necessary for building Axis c++ clients. <br> <br>
-5. "lib" folder contains jars needed to use the wsdl2ws tool. <br>
+5. "lib" folder contains jars which are needed to use the wsdl2ws tool. <br>
<br>
6. "samples" folder contains sources for all the server and client samples including interop tests.</p>
@@ -68,7 +68,7 @@
<p>Steps: <br>
<br>
-1. Install apache web server and locate the installation folder(For the default installation this is "C:\Program Files\Apache Group\Apache" for apache 1.3.X and "C:\Program Files\Apache Group\Apache2" for apache 2.X). Lets say this folder to be APACHE_FOLDER. <br>
+1. Install apache web server and locate the installation folder(For the default installation (apache 1.3.X)the path is "C:\Program Files\Apache Group\Apache" and for apache 2.X the path is "C:\Program Files\Apache Group\Apache2"). Lets say this folder is APACHE_FOLDER. <br>
<br>
2. Unzip the binary distribution to a folder of your choice. Say this folder is AXIS_EXTRACT.<br>
@@ -86,14 +86,14 @@
6. Add AXIS_FOLDER/libs to the PATH environment variable.<br>
<br>
-7. Edit Apache configuration file httpd.conf located in APACHE_FOLDER/conf and add following lines at the end.<br>
+7. Edit Apache configuration file httpd.conf which is located at APACHE_FOLDER/conf and add following lines at the end.<br>
<br>
LoadModule axis_module modules/AXISMODULE<br>
<Location><br>
SetHandler axis <br>
<Location><br> <br>
-Where AXISMODULE is either mod_axis.dll for apache 1.3.X or mod_axis2.dll for apache 2.X. <br>
+For apache 1.3.X the AXISMODULE is mod_axis.dll for apache 2.X. the AXISMODULE is mod_axis2.dll <br>
<br>
8. Copy AXISMODULE from the AXIS_EXTRACT/bin folder to APACHE_FOLDER/modules folder.<br> <br>
@@ -101,31 +101,34 @@
9. Copy AxisServer.dll from the AXIS_EXTRACT/bin folder to AXIS_FOLDER/libs <br>
<br>
-10.If you want to use the Expat parser with Axis C++ Rename AxisXMLParser_Expat.dll from AXIS_EXTRACT/bin folder to AxisXMLParser.dll and copy it to AXIS_FOLDER/libs <br>
-<br> </p>
+10. If you want to use the Expat parser with Axis C++, rename AxisXMLParser_Expat.dll which is at AXIS_EXTRACT/bin folder to AxisXMLParser.dll and copy it to AXIS_FOLDER/libs <br>
+<br>
+
+11. If you want to use the Xerces parser with Axis C++, rename AxisXMLParser_Xerces.dll which is at AXIS_EXTRACT/bin folder to AxisXMLParser.dll and copy it to AXIS_FOLDER/libs </p>
+
+ </p>
<p><b>Installing the Expat XML parser </b></p>
<p>If you decide to use the Expat parser you need to install the Expat parser. Download the Expat-1.95.7 binary version from <a href="http://sourceforge.net/projects/expat/">http://sourceforge.net/projects/expat/</a> <br>
-Extract the Expat binaries to a folder Called Expat ,we will refer this folder as [EXPAT_EXTRACT]. <br>
+Extract the Expat binaries to a folder Called Expat ,we will refer to this folder as [EXPAT_EXTRACT]. <br>
Copy libexpat.dll file from [EXPAT_EXTRACT]\Libs to [AXIS_HOME]/libs/ <br> <br>
-If you want to use the Xerces parser with Axis C++ Rename AxisXMLParser_Xerces.dll from AXIS_EXTRACT/bin folder to AxisXMLParser.dll and copy it to AXIS_FOLDER/libs </p>
-
+<br>
<p><b>Installing the Xerces XML parser</b>
-<br>
-If you decide the Xerces parser you need to install the Xerces parser. Download the Xerces-C 2.2.0( 32 bit binary release)from:
+<br> <br>
+If you decide to use the Xerces parser you need to install the Xerces parser. Download the Xerces-C 2.2.0( 32 bit binary release)from:
<a href="http://xml.apache.org/xerces-c/download.cgi">http://xml.apache.org/xerces-c/download.cgi</a> <br>
<br>
-Extract the Xerces-C 2.2.0 binary version. We will refer this folder as [XERCES_EXTRACT]. Copy xerces-c_2_2_0.dll from [XERCES_EXTRACT]/bin/ to [AXIS_HOME]/libs/ <br>
+Extract the Xerces-C 2.2.0 binary version. We will refer to this folder as [XERCES_EXTRACT]. Copy xerces-c_2_2_0.dll from [XERCES_EXTRACT]/bin/ to [AXIS_HOME]/libs/ <br>
<br> <br>
-11. Open the AXIS_FOLDER/axiscpp.conf_win for editing. The contents of the file will look as follows.<br> <br>
+12. Open the AXIS_FOLDER/axiscpp.conf_win for editing.The contents of the file will look like the following <br> <br>
LogPath:XXXX <br>
WSDDFilePath:YYYY <br>
<br>
-Where XXXX will be the path to a file named AxisLog (The log file)and YYYY will be the path to the server.wsdd file. Give the appropriate values for XXXX and YYYY as follows.<br> <br>
+XXXX is the path to AxisLog (The log file)and YYYY is the path to the server.wsdd file. Give the appropriate values for XXXX and YYYY as follows.<br> <br>
i.e. <br> <br>
@@ -133,24 +136,24 @@
WSDDFilePath: [APACHE_HOME]\Axis\conf\WSDDFILE <br>
<br>
-Where WSDDFILE is [APACHE_HOME]\Axis\conf\server.wsdd for Apache 1.3 and Apache 2. (There will be three wsdd files in the [APACHE_HOME]\Axis\conf\ rename the relevant wsdd file for your platform to server.wsdd).<br>
+WSDDFILE is [APACHE_HOME]\Axis\conf\server.wsdd for Apache 1.3 and Apache 2. (There will be three wsdd files in the [APACHE_HOME]\Axis\conf\ rename the relevant wsdd file of your platform to server.wsdd).<br> <br>
-Also in order to run the samples provided do the following.<br>
-Open server.wsdd for editing. For each service element, locate the element "parameter", having the value "classname" for the "name" attribute.
+Also in order to run the provided samples do the following.<br>
+Open server.wsdd for editing. For each service element, locate the element "parameter", which has the value "classname" for the "name" attribute.
Change the value of the "value" attribute, to have the absolute path to the indicated webservice.dll in that value. <br> <br>
Rename AXIS_FOLDER/axiscpp.conf_win to AXIS_FOLDER/axiscpp.conf <br> <br>
-12. Restart the apache web server. If you have done correctly apache server should start without giving any error.</p>
+13. Restart the apache web server. If you have done correctly apache server will start without giving any error.</p>
<br>
-<p><b>apache 1.3.X : </b> <br>
-It is recommended that apache 1.3.X be started as "apache -k start" on the command line <br> <br>
+<p><b>apache 1.3.X : </b> <br> <br>
+It is recommended that apache 1.3.X should be started as "apache -k start" on the command line <br> <br>
-<b>apache 2.X :</b> <br>
+<b>apache 2.X :</b> <br> <br>
While testing the apache 2 module a problem was noted with the apache 2 web server, in that the webserver takes up about 98% of CPU time and the server does not even serve the startup page. The workaround for this is to start the apache web server as "apache -X" to make it run single threaded. While this is sufficient to test the apache 2 module this problem needs to be investigated further. <br> <br>
-10. Open a internet browser and check http://localhost/axis. If the module has loaded properly then you should get the axis welcome page with a listing of deployed web services.<br> <br>
+14. Open an internet browser and check http://localhost/axis. If the module has loaded properly then you should get the axis welcome page with a listing of deployed web services.<br> <br>
<p><a name=#simpleaxis"></a></p>
@@ -159,18 +162,18 @@
<p>STEPS:</p>
<p>
1. Create a folder of your choice. We will call this folder as SIMPLE_AXIS_SERVER_FOLDER. <br> <br>
-2. Unzip axis-c-1.1-win32.zip to a folder of your choice. Say this folder AXIS_EXTRACT.<br> <br>
+2. Unzip axis-c-1.1-win32.zip to a folder of your choice. Say this folder is AXIS_EXTRACT.<br> <br>
3.Inside the extracted folder AXIS_EXTRACT you have a sub folder called deploy. Copy whole deploy folder to SIMPLE_AXIS_SERVER_FOLDER.<br> <br>
-4. Rename copied "deploy" folder to "Axis". Lets say this folder to be AXIS_FOLDER.<br> <br>
+4. Rename copied "deploy" folder to "Axis". Lets say this folder is AXIS_FOLDER.<br> <br>
5. Set environment variable AXIS_HOME to point to above folder.<br> <br>
6. Copy the exe SimpleAxisServer.exe from AXIS_EXTRACT/bin to the SIMPLE_AXIS_SERVER_FOLDER. <br> <br>
7. Copy the content of AXIS_FOLDER/libs to the SIMPLE_AXIS_SERVER_FOLDER.<br> <br>
-8. Start the SimpleAxisServer by providing the port to which operate. (eg: c:\SimpleAxisServer>SimpleAxisServer 80) </p>
+8. Start the SimpleAxisServer by providing the port to which it should operate. (eg: c:\SimpleAxisServer>SimpleAxisServer 80) </p>
<p><a name="#samples"></a></p>
<h1>Running Provided Samples</h1>
-<p>If Axis installation is a complete success, following sample web services and handlers have already been installed successfully.<br> <br>
+<p>If Axis installation is a complete success, then the following sample web services and handlers would have already been installed successfully.<br> <br>
You will find the built console applications at AXIS/c/bin directory. Following are the built .exe files. <br> <br>
1.base.exe <br>
@@ -183,21 +186,22 @@
<br>
In order to run these samples you should have AxisClient.dll in the PATH environment variable or in the same directory where the client .exe is located.<br> <br>
-You can run the provided client programs to confirm whether the Axis cpp sever and clients are working fine. To run this sample client applications you need to have the path to libexapt.dll in the "PATH" environment variable or libexapt.dll should be placed where the apache.exe is. Note: These sample clients are compiled with assumption that server is running at localhost port 80.<br>
+You can run the provided client programs to confirm whether the Axis cpp server and clients are working fine. To run this sample client applications you need to have the path to libexapt.dll in the "PATH" environment variable or libexapt.dll should be placed where the apache.exe is. <br>
+<b> Note: These sample clients are compiled with the assumption that server is running at localhost port 80.</b><br>
<br>
<p><a name="#playsamples"></a></p>
<h1>Using Visual C++ to play with provided samples.</h1>
-<p>In your AXIS_EXTRACT/samples folder you have the samples. If you are using Visual C++ you can open the workspace file for client applications AXIS_EXTRACT\c\samples\client\interoptests\interoptests.dsw and For Deployable webservices, AXIS_EXTRACT\c\samples\server\interoptests\interoptests.dsw and play with them. There are seven projects in the workspace.
+<p>In your AXIS_EXTRACT/samples folder you have the samples. If you are using Visual C++ you can open the workspace file for client applications which is located at AXIS_EXTRACT\c\samples\client\interoptests\interoptests.dsw. <br> <br> You can open Deployable webservices which are at AXIS_EXTRACT\c\samples\server\interoptests\interoptests.dsw and play with them. There are seven projects in the workspace.
<br> <br>
<p><a name="#writews"></a></p>
<h1>Writing your web services and client applications using Axis C++.</h1>
-<p>For writing your own web services and client applications see the <a href="winuser-guide.html"><b>Windows User Guide</a></b>
+<p>To write your own web services and client applications see the <a href="winuser-guide.html"><b>Windows User Guide</a></b>
1.16 +15 -15 ws-axis/site/src/documentation/content/xdocs/cpp/windev-guide.ihtml
Index: windev-guide.ihtml
===================================================================
RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/windev-guide.ihtml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- windev-guide.ihtml 7 Jul 2004 09:17:41 -0000 1.15
+++ windev-guide.ihtml 8 Jul 2004 11:09:18 -0000 1.16
@@ -102,7 +102,7 @@
The checkout of the repository will be created in the current directory in a
folder named �ws-axis�<br>
<br>
-The checked out folder ws-axis will be referred as [CHECKOUT_HOME] from
+The checked out folder ws-axis will be referred to as [CHECKOUT_HOME] from
this point on.<br></p>
<p><a name="getapacheexpat"></a></p>
@@ -137,7 +137,7 @@
<br>
<p>Run the file
xerces-c2_2_0-win32.The folder to which Xerces is unzipped will be
-referred as [XERCES_EXTRACT] from this point onwards.</p>
+referred to as [XERCES_EXTRACT] from this point onwards.</p>
<br>
@@ -145,14 +145,14 @@
<br>
<p>Run the file
expat_win32bin_1_95_7.exe . The folder to which Expat is unzipped will be
-referred as [EXPAT_EXTRACT] from this point onwards.</p>
+referred to as [EXPAT_EXTRACT] from this point onwards.</p>
<br>
<p><b>Apache</b></p>
<br>
<p>Install the Apache web server. By default Apache 1.3.X is installed in
"C:\Program Files\Apache Group\Apache" and Apache 2.X in "C:\Program
-Files\Apache Group\Apache2". These locations will be referred as [APACHE_HOME]
+Files\Apache Group\Apache2". These locations will be referred to as [APACHE_HOME]
from this point onwards.</p>
@@ -256,7 +256,7 @@
|__ logs (log files are located here)<br>
|__ conf (server.wsdd file is located here)<br>
|__ webservices (The place to put webservice dlls)<br>
-|__ wsdls (The directory for the wsdl files of the deployed web services)<br>
+|__ wsdls (wsdl files of the deployed web services are located here)<br>
<br>
2) Set an environment variable named AXIS_HOME and give [APACHE_HOME]\Axis as
@@ -308,8 +308,8 @@
XMLParser:WWWW<br>
<br>
-Where XXXX will be the path to a file named AxisLog (The log file)and YYYY
-will be the path to the server.wsdd file.ZZZZ will be the path to AxisTransport.dll if it's a HTTP(if the selected transport is SMTP then should give that path.WWWW will be the path to AxisXMLParser.dll<br>
+XXXX is the path to a file named AxisLog (The log file)and YYYY
+is the path to the server.wsdd file.ZZZZ is the path to AxisTransport.dll if it's a HTTP(if the selected transport is SMTP then should give that path.)WWWW is the path to AxisXMLParser.dll<br>
<br>
i.e.<br>
LogPath:[APACHE_HOME]\Axis\logs\AxisLog.log
@@ -382,7 +382,7 @@
dialog" keep the "use default" Tick Box checked.
<br>
Note down the path in the "Directory" Text Box. This location will be
-referred as [SKELSTUB_HOME] from this point onwards. Click "Next".<br>
+referred to as [SKELSTUB_HOME] from this point onwards. Click "Next".<br>
<br>
@@ -487,7 +487,7 @@
<h3>Building and running WSDL2Ws on the command line</h3>
-<p>For building WSDL2Ws java tool on the command line you require jdk1.4 or
+<p>To build the WSDL2Ws java tool on the command line you require jdk1.4 or
above.<br>
<br>
To build WSDL2Ws java tool set the CLASSPATH Environment Variable
@@ -533,7 +533,7 @@
<br>
Give the class path exactly the same order as given above.
<br><br>
-If the tool is successful the tool will display the files it has
+If the tool is successful it will display the files it has
generated. The skeletons and stubs will be generated in
[SKELSTUB_HOME]\ServerOut.<br>
<br>
@@ -621,14 +621,14 @@
The service element specifies the service name.<br>
<service name="Calculator"><br>
<br>
-In this parameter element we specify the parameter className and it�s value,
+In this parameter element we specify the parameter className and for it�s value we specify
the location of the webservice dll.<br>
<parameter name="className" value="C:\Program Files\Apache
Group\Apache\Axis\webservices\ws1.dll"/><br>
<br>
-In this parameter element we specify the parameter allowedMethods and its
-value, the methods exposed by the web service (i.e. subtract and add).<br> <br>
-<b>Note: A trailing space should be put after every allowed method.</b><br>
+In this parameter element we specify the parameter allowedMethods and for its
+value we specify the methods exposed by the web service (i.e. subtract and add).<br> <br>
+<b>Note: A trailing space should be inserted after every allowed method.</b><br>
<parameter name="allowedMethods" value="subtract add "/><br>
<br>
16) Now start the Apache web server by typing �apache -k start�. If the Apache server is
@@ -750,7 +750,7 @@
<p>
<br>1) Open the Visual C++ workspace (interoptests.dsw) at [CHECKOUT_HOME]\c\vc\samples\client\interoptests\ and do a batch build of all projects.<br>
<br>2) You need to build the AxisClient project in the "Distribution" workspace at [CHECKOUT_HOME]\c\vc\, because you need the AxisClient.lib to compile client applications and AxisClient.dll to run them.<br>
-<br>3) You will find the built console applications and AxisClient.dll at [CHECKOUT_HOME]\c\bin directory. Following are the built .exe files.
+<br>3) You will find the built console applications and AxisClient.dll at [CHECKOUT_HOME]\c\bin directory. Following are the built .exe files. <br> <br>
base.exe <br>
cbase.exe<br>
cgroupB.exe<br>