roshan 2004/09/29 02:30:41
Modified: targets/axis/cpp wininstall-guide.pdf wininstall-guide.html
Log:
Edited the wininstall guide. Changed by Rangika
Revision Changes Path
1.18 +66 -66 ws-site/targets/axis/cpp/wininstall-guide.pdf
<<Binary file>>
1.21 +19 -16 ws-site/targets/axis/cpp/wininstall-guide.html
Index: wininstall-guide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cpp/wininstall-guide.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- wininstall-guide.html 27 Sep 2004 07:34:02 -0000 1.20
+++ wininstall-guide.html 29 Sep 2004 09:30:41 -0000 1.21
@@ -302,7 +302,7 @@
<h3>What binary distribution contains</h3>
</div>
<p>1. The binary distribution contains the following folders<br> -> bin<br>->
deploy<br>-> docs<br>-> include<br>-> lib<br>-> samples<br>
-<br>2.The folder “bin” contains sample clients and other dlls needed to
run the Axis c++ server<br>
+<br>2.The folder “bin” contains sample clients and other dlls which are
needed to run the Axis c++ server<br>
<br> 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>-> handlers (This includes sample handler dlls)<br>-> libs
(Contains dlls which are needed by axis.)<br>-> logs (Directory for logs)<br>->
webservices (Contains sample web services that can be deployed with Axis C++)<br>->
wsdls (Contains sample wsdls)<br>
<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>
@@ -322,11 +322,12 @@
<br> 6. Add AXIS_FOLDER/lib 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>
<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>
-<br> 8. Copy AXISMODULE from the AXIS_EXTRACT/bin folder to APACHE_FOLDER/modules
folder.<br>
-<br> 9. Copy AxisServer.dll and AxisTransport.dll from the AXIS_EXTRACT/bin folder
to AXIS_FOLDER/lib<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/lib<br>
+<br> AXISMODULE is either mod_axis.dll for apache 1.3.X or mod_axis2.dll for apache
2.X.<br>
+<br> 8. Copy AXISMODULE from AXIS_EXTRACT/bin folder to APACHE_FOLDER/modules
folder.<br>
+<br> 9. Copy AxisServer.dll and AxisTransport.dll from AXIS_EXTRACT/bin folder to
AXIS_FOLDER/lib<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/lib<br>
<br> 11.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/lib</p>
+<br>
<p>
<strong>Installing the Expat XML parser</strong>
</p>
@@ -335,10 +336,12 @@
<br>Extract the Expat binaries to a folder Called Expat ,we will refer to this
folder as [EXPAT_EXTRACT].<br>
<br>Copy libexpat.dll file from [EXPAT_EXTRACT]\Libs to [AXISCPP_DEPLOY]/lib/<br>
<br>
+<br>
</p>
<p>
<strong>Installing the Xerces XML parser</strong>
-<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>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 to this folder as
[XERCES_EXTRACT]. Copy xerces-c_2_2_0.dll from [XERCES_EXTRACT]/bin/ to
[AXISCPP_DEPLOY]/lib/<br>
<br>
@@ -347,11 +350,11 @@
<br> XXXX is the path to a file named 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> LogPath: [APACHE_HOME]\Axis\logs\AxisLog<br>WSDDFilePath:
[APACHE_HOME]\Axis\conf\WSDDFILE<br>
-<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>WSDDFILE is located at [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 provided samples do the following.<br>
-<br>Open server.wsdd for editing. For each service element, locate the element
"parameter", having 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> 13. Restart the apache web server. If you have done correctly apache server
should start without giving any error.</p>
+<br>Open server.wsdd for editing. For each service element, locate the element
"parameter", which has the value "classname" for the "name" attribute. Give the
absolute path of the indicated webservice.dll in the "value" attribute<br>
+<br>Rename axiscpp.conf_win which is in AXIS_FOLDER to axiscpp.conf<br>
+<br> 13. Restart the apache web server. If you have done correctly apache server
will start without giving any error.</p>
<br>
<p>
<strong>apache 1.3.X :</strong>
@@ -361,7 +364,7 @@
<strong>apache 2.X :</strong>
<br>
<br>While testing the apache 2 module a problem was noted with the apache 2 web
server, in that the webserver takes 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> 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> 14. Open an internet browser and check http://localhost/axis. If the module
has loaded properly then you will get the axis welcome page with a listing of deployed
web services.<br>
<br>
</p>
<p>
@@ -376,16 +379,16 @@
<br>3. Inside the extracted folder AXIS_EXTRACT there is 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>5. Set environment variable AXISCPP_DEPLOY 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>6. Copy the SimpleAxisServer.exe from AXIS_EXTRACT/bin to the
SIMPLE_AXIS_SERVER_FOLDER.<br>
<br>7. Copy the content of AXIS_FOLDER/lib 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>
+<br>8. Start the SimpleAxisServer by providing the port to which it operates.(eg:
c:\SimpleAxisServer>SimpleAxisServer 80)</p>
<p>
<a name="#samples"></a>
</p>
<div class="h3">
<h3>Running Provided Samples</h3>
</div>
-<p>If Axis installation is a complete success, following sample web services and
handlers have already been installed successfully.<br>
+<p>If Axis installation is a complete success, then the following sample web
services and handlers have 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>2.cbase.exe<br>3.doclitbase.exe<br>4.doclitgroupB.exe<br>5.groupB.exe<br>6.cgroupB.exe<br>
<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>
@@ -403,8 +406,8 @@
<h3>Using Visual C++ to play with provided samples.</h3>
</div>
<p>In your AXIS_EXTRACT/samples folder you have the samples.<br>
-<br> If you are using Visual C++ you can open the workspace file for client
applications AXIS_EXTRACT\c\samples\client\interoptests\interoptests.dsw<br>
-<br> For Deployable webservices,
AXIS_EXTRACT\c\samples\server\interoptests\interoptests.dsw and play with them.<br>
+<br> If you are using Visual C++ you can open the workspace file for client
applications which are in
AXIS_EXTRACT\c\samples\client\interoptests\interoptests.dsw<br>
+<br> Deployable webservices are in
AXIS_EXTRACT\c\samples\server\interoptests\interoptests.dsw and you can play with
them.<br>
<br>There are seven projects in the workspace.<br>
<br>
</p>
