You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ws.apache.org by ro...@apache.org on 2004/09/27 09:34:03 UTC

cvs commit: ws-site/targets/axis/cpp wininstall-guide.pdf wininstall-guide.html

roshan      2004/09/27 00:34:03

  Modified:    targets/axis/cpp wininstall-guide.pdf wininstall-guide.html
  Log:
  Edited the win install guide to make it more user friendly. Edited by Rangika
  
  Revision  Changes    Path
  1.17      +145 -151  ws-site/targets/axis/cpp/wininstall-guide.pdf
  
  	<<Binary file>>
  
  
  1.20      +25 -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.19
  retrieving revision 1.20
  diff -u -r1.19 -r1.20
  --- wininstall-guide.html	19 Aug 2004 06:39:55 -0000	1.19
  +++ wininstall-guide.html	27 Sep 2004 07:34:02 -0000	1.20
  @@ -319,35 +319,39 @@
   <br> 3. Inside the extracted folder AXIS_EXTRACT there is a sub folder called deploy. Copy the whole deploy folder to APACHE_FOLDER.<br>
   <br> 4. Rename copied "deploy" folder to "Axis". Lets say this folder is AXIS_FOLDER.<br>
   <br> 5. Set environment variable AXISCPP_DEPLOY to point to above folder.<br>
  -<br> 6. Add AXIS_FOLDER/libs to the PATH environment variable.<br>
  +<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>&lt;Location&gt;<br>SetHandler axis<br>&lt;\Location&gt;<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/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>
  +<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> 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>
   <p>
   <strong>Installing the Expat XML parser</strong>
   </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 to this folder as [EXPAT_EXTRACT].<br>Copy libexpat.dll file from [EXPAT_EXTRACT]\Libs to [AXISCPP_DEPLOY]/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>
  +<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>
  +</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>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]/libs/<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>
  -<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 as follows.<br>
   <br> LogPath:XXXX<br>WSDDFilePath:YYYY<br>
   <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> 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", 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>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 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> 12. Restart the apache web server. If you have done correctly apache server should start without giving any error.</p>
  +<br> 13. Restart the apache web server. If you have done correctly apache server should start without giving any error.</p>
   <br>
   <p>
   <strong>apache 1.3.X :</strong>
  @@ -357,7 +361,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> 10. 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 should get the axis welcome page with a listing of deployed web services.<br>
   <br>
   </p>
   <p>
  @@ -373,7 +377,7 @@
   <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>7. Copy the content of AXIS_FOLDER/libs 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&gt;SimpleAxisServer 80)</p>
   <p>
   <a name="#samples"></a>
  @@ -383,9 +387,11 @@
   </div>
   <p>If Axis installation is a complete success, following sample web services and handlers 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>2.cbase.exe<br>3.doclitbase.exe<br>4.doclitgroupB.exe<br>5.groupB.exe<br>6.cgroupB<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>
  -<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> 
  +<br> You can run the provided client programs to confirm whether the Axis cpp server and clients are working fine.<br>
  +<br>To run these sample client applications you need to have the path to libexpat.dll in the "PATH" environment variable or libexpat.dll should be placed where the apache.exe is.(libexpat.dll can be found in [EXPAT_EXTRACT\libs)<br>
  +<br> 
   <strong>Note: These sample clients are compiled with the assumption that server is running at localhost port 80.</strong>
   <br>
   <br>
  @@ -396,7 +402,10 @@
   <div class="h3">
   <h3>Using Visual C++ to play with provided samples.</h3>
   </div>
  -<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.<br>
  +<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>There are seven projects in the workspace.<br>
   <br>
   </p>
   <p>