Return-Path: Delivered-To: apmail-ws-axis-dev-archive@www.apache.org Received: (qmail 1176 invoked from network); 5 May 2005 09:12:58 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 5 May 2005 09:12:58 -0000 Received: (qmail 44648 invoked by uid 500); 5 May 2005 09:14:53 -0000 Delivered-To: apmail-ws-axis-dev-archive@ws.apache.org Received: (qmail 44526 invoked by uid 500); 5 May 2005 09:14:51 -0000 Mailing-List: contact axis-cvs-help@ws.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Delivered-To: mailing list axis-cvs@ws.apache.org Received: (qmail 44496 invoked by uid 99); 5 May 2005 09:14:51 -0000 X-ASF-Spam-Status: No, hits=0.7 required=10.0 tests=NO_REAL_NAME,WEIRD_PORT X-Spam-Check-By: apache.org Received: from minotaur.apache.org (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.28) with SMTP; Thu, 05 May 2005 02:14:47 -0700 Received: (qmail 1095 invoked by uid 1852); 5 May 2005 09:12:29 -0000 Date: 5 May 2005 09:12:29 -0000 Message-ID: <20050505091229.1094.qmail@minotaur.apache.org> From: samisa@apache.org To: ws-axis-cvs@apache.org Subject: cvs commit: ws-axis/c/docs wininstall-guide.html X-Virus-Checked: Checked X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N 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.

Installing the Xerces XML parser

@@ -77,7 +77,7 @@ Extract the Xerces-C 2.2.0 binary version. We will refer to this folder as [Xerces_Folder].

Installation with Apache 1.3.X/2.X web server

Steps:
@@ -170,83 +170,126 @@ 13. 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.

-

Installation with Simple Axis Server

STEPS:

-1. Create a folder of your choice. We will call this folder as Simple_Axis_Server_Folder.

-2. Unzip the binary distribution to a folder of your choice. Say this folder is Axis_Extract.

-3. Inside the extracted folder Axis_Extract there is a sub folder called deploy. Copy the whole deploy folder to Simple_Axis_Server_Folder.

-4. Rename copied "deploy" folder to "Axis". Lets say this folder is [Axis_Folder].

-5. Set environment variable AXISCPP_DEPLOY to point to above [Axis_Folder].

-6. Add [Axis_Folder]/lib to the PATH environment variable.

-7. Copy the SimpleAxisServer.exe from Axis_Extract/bin to the Simple_Axis_Server_Folder.

-8. Copy AxisServer.dll,HTTPTransport.dll and HTTPChannel.dll from Axis_Extract/bin folder to [Axis_Folder]/lib

- -9.Rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib

-10.Copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin and paste it in [Axis_Folder]/lib.

-

Note: This could also be done by editing the axiscpp.conf.
+1. Download binaries +Axis C++ binary from http://www.apache.org/dist/ws/axis-c/axis-c-win32-current-bin.zip +
+Xerces binary from http://archive.apache.org/dist/xml/xerces-c/Xerces-C_2_2_0/xerces-c2_2_0-win32.zip +
+
-10. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.

+2. Extract downloads +
+Extract axis-c-win32-current-bin.zip to D:\axis-c-1-5-win32 +
+Extract xerces-c2_2_0-win32.zip to D:\xerces-c2_2_0-win32 +
+
-LogPath:XXXX
-WSDDFilePath:YYYY
-XMLParser:ZZZZ
-Transport_http:AAAA
-Channel_HTTP:BBBB
+3. Copy Xerces lib to Axis C++ extract folder +
+

  +copy D:\xerces-c2_2_0-win32\bin\xerces-c_2_2_0.dll D:\axis-c-1-5-win32\bin
  +

- 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.

-i.e.

+4. Set Environment variables +
+Open a command shell and run: +
+

  +set AXISCPP_DEPLOY=D:\axis-c-1-5-win32
  +set PATH=%PATH%;%AXISCPP_DEPLOY%\bin
  +

+
-LogPath: [Apache_Folder]\Axis\logs\AxisLog
-WSDDFilePath: [Apache_Folder]\Axis\conf\server.wsdd
-XMLParser:[Axis_Folder]\lib\AxisXMLParser.dll
-Transport_http:[Apache_Folder]\Axis\lib\HTTPTransport.dll
-Channel_HTTP:[Apache_Folder]\Axis\lib\HTTPChannel.dll

+5. Set up the configuration +
+On the same shell used in step 4 run: +
+

  +cd %AXISCPP_DEPLOY%
  +

-Rename axiscpp.conf_win to axiscpp.conf. +Now you should be on D:\axis-c-1-5-win32 +
-

+Copy the conf file: +
+

  +copy deploy\axiscpp.conf_win axiscpp.conf
  +

+
-11. Start the SimpleAxisServer by providing the port to which it operates.(eg: c:\SimpleAxisServer>SimpleAxisServer 80)

-Note:If SimpleAxisServer does not start then paste AxisClient.dll to the place where SimpleAxisServer.exe is. -

+Edit the conf file to have the following content +
+

  +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
  +

-Also in order to run the provided samples do the following.

-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".
-Give the absolute path of the indicated webservice.dll in the "value" attribute

+NOTE: Please do not set Channel_HTTP_SSL in axiscpp.conf +
+
-12. Restart the SimpleAxisServer.If you have done correctly then SimpleAxisServer will start without giving any error.
+Now setup the server.wsdd file +
+

  +copy samples\server.wsdd.win32 samples\server.wsdd
  +

+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) +
+
+6. Run SimpleAxisServer +On the same command shell used in steps 4 and 5 +
+

  +bin\simpleaxisserver 9090
  +

+
-

+7. Run clients +Open a new command shell +
+Set environment variables: +
+

  +set AXISCPP_DEPLOY=D:\axis-c-1-5-win32
  +set PATH=%PATH%;%AXISCPP_DEPLOY%\bin
  +

+
-

Running Provided Samples

+cd to %AXISCPP_DEPLOY% +
-

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. http://localhost/axis

+And run the sample +
+

  +bin\base http://localhost:9090/axis/base
  +

+
-You will find the built console applications at [Axis_Extract]/bin directory. Following are the built .exe files.

-1.base.exe
-2.cbase.exe
-3.doclitbase.exe
-4.doclitgroupB.exe
-5.groupB.exe
-6.cgroupB.exe
+

Running Provided Samples

+You can find the samples in "bin" folder of the Axis C++ extract folder.
-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.

- -You can run the provided client programs to confirm whether the Axis cpp server and clients are working fine.

-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)

- Note: These sample clients are compiled with the assumption that server is running at localhost port 80.
+To get help on how to run sample run : <sample executable name> [-?] -h] +
+For more information on how to build samples using ant please see Axis C++ Samples Guide
-

Using Visual C++ to play with provided samples.

@@ -256,7 +299,7 @@ There are seven projects in the workspace.

Writing your web services and client applications using Axis C++.

@@ -266,32 +309,6 @@ PDF

PDF

- - - - - - - - - - - - - - - - - - - - - - - - - - - - + +