You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by sa...@apache.org on 2005/05/05 11:12:29 UTC
cvs commit: ws-axis/c/docs wininstall-guide.html
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><sample executable name> [-?] -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>