axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sam...@apache.org
Subject cvs commit: ws-axis/c/docs wininstall-guide.html
Date Thu, 05 May 2005 09:12:29 GMT
samisa      2005/05/05 02:12:29

  Modified:    c/docs   wininstall-guide.html
  Log:
  Added the Simple Axis server HOWTO content to this doc.
  Also updated the samples section as this was outdated.
  
  Revision  Changes    Path
  1.14      +101 -84   ws-axis/c/docs/wininstall-guide.html
  
  Index: wininstall-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-axis/c/docs/wininstall-guide.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- wininstall-guide.html	3 Feb 2005 13:14:09 -0000	1.13
  +++ wininstall-guide.html	5 May 2005 09:12:29 -0000	1.14
  @@ -68,7 +68,7 @@
   
   6. "samples" folder contains sources of all the server and client samples including interop
tests.</p>
   
  -<p><a name="#parser2"> </a> </p>
  +<p><a name="parser2"> </a> </p>
   
   <h1>Installing the Xerces XML parser</h1>
   <br> 
  @@ -77,7 +77,7 @@
   
   Extract the Xerces-C 2.2.0 binary version. We will refer to this folder as [Xerces_Folder].</p>
   
  -<p><a name=#apache"></a></p>  
  +<p><a name="apache"></a></p>  
   <h1> Installation with Apache 1.3.X/2.X web server</h1>
   
   <p>Steps: <br>
  @@ -170,83 +170,126 @@
   
   13. Open an internet browser and check <a href="http://localhost/axis">http://localhost/axis</a>
If the module has loaded properly then you will get the axis welcome page with a listing of
deployed web services.<br> <br>
   
  -<p><a name=#simpleaxis"></a></p>
  +<p><a name="simpleaxis"></a></p>
   
   <h1>Installation with Simple Axis Server</h1>
   
   <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 the binary distribution to a folder of your choice. Say this folder is Axis_Extract.<br>
<br>
  -3. Inside the extracted folder Axis_Extract there is a sub folder called deploy. Copy the
whole deploy folder to  Simple_Axis_Server_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 [Axis_Folder].<br> <br>
  -6. Add [Axis_Folder]/lib to the PATH environment variable.<br> <br>
  -7. Copy the SimpleAxisServer.exe from Axis_Extract/bin to the Simple_Axis_Server_Folder.<br>
<br>
  -8. Copy AxisServer.dll,HTTPTransport.dll and HTTPChannel.dll from Axis_Extract/bin folder
to [Axis_Folder]/lib <br> <br>
  -
  -9.Rename AxisXMLParser_Xerces.dll (which is located at  Axis_Extract/bin) to AxisXMLParser.dll
and copy it to [Axis_Folder]/lib <br> <br>
  -10.Copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin and paste it in [Axis_Folder]/lib.
<br> <br>  
  -</p>
  -<p><b>Note:</b> This could also be done by editing the axiscpp.conf.
<br>
  +1. Download binaries
  +Axis C++ binary from <a href="http://www.apache.org/dist/ws/axis-c/axis-c-win32-current-bin.zip">http://www.apache.org/dist/ws/axis-c/axis-c-win32-current-bin.zip</a>

  +<br>
  +Xerces binary from <a href="http://archive.apache.org/dist/xml/xerces-c/Xerces-C_2_2_0/xerces-c2_2_0-win32.zip">http://archive.apache.org/dist/xml/xerces-c/Xerces-C_2_2_0/xerces-c2_2_0-win32.zip</a>
  +<br>
  +<br>
   
  -10. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will
look as follows.<br> <br>
  +2. Extract downloads
  +<br>
  +Extract axis-c-win32-current-bin.zip to D:\axis-c-1-5-win32
  +<br>
  +Extract xerces-c2_2_0-win32.zip to D:\xerces-c2_2_0-win32
  +<br>
  +<br>
   
  -LogPath:XXXX <br>
  -WSDDFilePath:YYYY <br>
  -XMLParser:ZZZZ <br>
  -Transport_http:AAAA <br>
  -Channel_HTTP:BBBB <br>
  +3. Copy Xerces lib to Axis C++ extract folder
  +<br>
  +<pre>
  +copy D:\xerces-c2_2_0-win32\bin\xerces-c_2_2_0.dll D:\axis-c-1-5-win32\bin
  +</pre>
   <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.ZZZZ is the path to the XMLParser
and AAAA is the path to the used Transport and BBBB is the path to the Channel used.<br>
<br>
   
  -i.e. <br> <br>
  +4. Set Environment variables
  +<br>
  +Open a command shell and run:
  +<br>
  +<pre>
  +set AXISCPP_DEPLOY=D:\axis-c-1-5-win32
  +set PATH=%PATH%;%AXISCPP_DEPLOY%\bin
  +</pre>
  +<br>
   
  -LogPath: [Apache_Folder]\Axis\logs\AxisLog <br>
  -WSDDFilePath: [Apache_Folder]\Axis\conf\server.wsdd <br>
  -XMLParser:[Axis_Folder]\lib\AxisXMLParser.dll<br>
  -Transport_http:[Apache_Folder]\Axis\lib\HTTPTransport.dll<br>
  -Channel_HTTP:[Apache_Folder]\Axis\lib\HTTPChannel.dll<br> <br>
  +5. Set up the configuration
  +<br>
  +On the same shell used in step 4 run:
  +<br>
  +<pre>
  +cd %AXISCPP_DEPLOY%
  +</pre>
   
  -Rename axiscpp.conf_win to axiscpp.conf.
  +Now you should be on D:\axis-c-1-5-win32
  +<br>
   
  -<br> <br>
  +Copy the conf file:
  +<br>
  +<pre>
  +copy deploy\axiscpp.conf_win axiscpp.conf
  +</pre>
  +<br>
   
  -11. Start the SimpleAxisServer by providing the port to which it operates.(eg: c:\SimpleAxisServer>SimpleAxisServer
80)<br> <br>
  -<b>Note:</b>If SimpleAxisServer does not start then paste AxisClient.dll to
the place where SimpleAxisServer.exe is.
  -<br> <br>
  +Edit the conf file to have the following content
  +<br>
  +<pre>
  +LogPath:D:\axis-c-1-5-win32\bin\AxisLog.txt
  +WSDDFilePath:D:\axis-c-1-5-win32\samples\server.wsdd
  +XMLParser:D:\axis-c-1-5-win32\bin\AxisXMLParserXerces.dll
  +Transport_http:D:\axis-c-1-5-win32\bin\HTTPTransport.dll
  +Channel_HTTP:D:\axis-c-1-5-win32\bin\HTTPChannel.dll
  +</pre>
   
  -Also in order to run the provided samples do the following.<br> <br>
  -Open server.wsdd for editing. server.wsdd is located at [Axis_Folder]\conf\ rename the
wsdd file of your platform to server.wsdd. For each service element, locate the element "parameter
name", which has the value "classname". <br>
  -Give the absolute path of the indicated webservice.dll  in the "value" attribute <br>
 <br>
  +<b>NOTE: Please do not set Channel_HTTP_SSL in axiscpp.conf</b>
  +<br>
  +<br>
   
  -12. Restart the SimpleAxisServer.If you have done correctly then SimpleAxisServer will
start without giving any error. <br>
  +Now setup the server.wsdd file
  +<br>
  +<pre>
  +copy samples\server.wsdd.win32 samples\server.wsdd
  +</pre>
  +Edit server.wsdd file to match your settings 
  +(In this case replace all C:\obj\samples with D:\axis-c-1-5-win32\deploy\webservices)
  +<br>
  +<br>
   
  +6. Run SimpleAxisServer
  +On the same command shell used in steps 4 and 5
  +<br>
  +<pre>
  +bin\simpleaxisserver 9090
  +</pre>
  +<br>
   
  -</p>
  +7. Run clients
  +Open a new command shell
  +<br>
  +Set environment variables:
  +<br>
  +<pre>
  +set AXISCPP_DEPLOY=D:\axis-c-1-5-win32
  +set PATH=%PATH%;%AXISCPP_DEPLOY%\bin
  +</pre>
  +<br>
   
  -<p><a name="#samples"></a></p>
  -<h1>Running Provided Samples</h1>
  +cd to %AXISCPP_DEPLOY%
  +<br>
   
  -<p>If Axis installation is a complete success, then the following sample web services
and handlers have been installed successfully. Please click on the following link to see the
deployed web services. <a href="http://localhost/axis">http://localhost/axis</a>
<br> <br>
  +And run the sample
  +<br>
  +<pre>
  +bin\base http://localhost:9090/axis/base
  +</pre>
  +<br>
   
  -You will find the built console applications at [Axis_Extract]/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>
  +<p><a name="samples"></a></p>
  +<h1>Running Provided Samples</h1>
   
  +You can find the samples in "bin" folder of the Axis C++ extract folder.
   <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. <br> <br>
  -To run these sample client applications you need to have the path to xerces-c_2_2_0.dll
in the "PATH" environment variable or xerces-c_2_2_0.dll should be placed where the apache.exe
is.(xerces-c_2_2_0.dll can be found in [Xerces_Folder]\bin)<br> <br>
  -<b> Note: These sample clients are compiled with the assumption that server is running
at localhost port 80.</b><br>
  +To get help on how to run sample run : <i>&lt;sample executable name&gt;
[-?] -h] </i>
  +<br>
  +For more information on how to build samples using ant please see <a href="samples-guide.html">Axis
C++ Samples Guide</a>
   <br>
   
  -<p><a name="#playsamples"></a></p>
  +<p><a name="playsamples"></a></p>
   
   <h1>Using Visual C++ to play with provided samples.</h1>
   
  @@ -256,7 +299,7 @@
   There are seven projects in the workspace.
   <br> <br> </p>
   
  -<p><a name="#writews"></a></p>
  +<p><a name="writews"></a></p>
   
   <h1>Writing your web services and client applications using Axis C++.</h1>
   
  @@ -266,32 +309,6 @@
   <a href="wininstall-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
class="skin"><br>
             PDF</a> </p>
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  +</body>
  +</html>
   
  
  
  

Mime
View raw message