|
Wednesday, 05 April 2006 21:56 |
|
Here is a How to since it take me a very long time to install something which should have been trivial....
For the benefit of the community, I am publishing it here on my free time :-) ... Enjoy... Apache Axis and Apache Axis C++ are implementation of the SOAP ("Simple Object Access Protocol") submission to W3C. From the W3C draft specification: SOAP is a lightweight protocol for exchanging structured information in a decentralized, distributed environment. It is an XML based protocol that consists of three parts: an envelope that defines a framework for describing what is in a message and how to process it, a set of encoding rules for expressing instances of application-defined datatypes, and a convention for representing remote procedure calls and responses.
Axis C/C++ (Axis CPP) is a non-Java implementation of Axis. At its core Axis CPP has a C++ runtime engine. The provided tooling allows you to create C++ client-side stubs and server-side skeletons. The server skeletons can be deployed to either a full Apache web server using the supplied apache module or a "simple_axis_server" - which is a simple HTTP listener (designed to help you test your services).
1. Download either Apache 2.0 or Apache 1.3
unpack it to c:\apache
2. Download the latest version of Axis C++
unpack it to c:\axis
Note: try to avoid space in path, it has always been proved to be a mess under Windows.
3. Open and add following lines at the end of Apache config file
Apache 1.3
in c:\apache\conf\http.conf | Apache 2.0
in c:\apache\conf\http.conf | LoadModule axis_module ../axis/lib/modules/mod_axis.dll
<Location /axis>
SetHandler axis
</Location> | LoadModule axis_module ../axis/lib/mod_axis2.dll
<Location /axis>
SetHandler axis
</Location> |
4. Now it is starting to be interesting, both mod_axis.dll and mod_axis2.dll have dependencies to an old dll which do no more exist since windows 98 ! msjava.dll
You need to copy from Internet msjava.dll into c:\axis\lib
You also need to copy the xerces parser xerces-c_2_2_0.dll into c:\axis\lib
5. Create a file axiscpp.conf (or search in zip distributions for a template of it) and copy it into c:\axis
Modify all path to DLL accordingly. Note that relative path or absolute path also work.
| Example of axiscpp.conf | # The comment character is '#'
#Available directives are as follows
#(Some of these directives may not be implemented yet)
#
#WSDDFilePath:The path to the server wsdd
#LogPath:The path to the axis log
#ClientLogPath:The path to the axis client log
#ClientWSDDFilePath:The path to the client wsdd
#Transport_http:The HTTP transport library
#Transport_smtp:The SMTP transport library
#XMLParser:The xml parser library
#NodeName:Node name
#ListenPort:Listening port
#Channel_HTTP:The HTTP transport channel library
#Channel_HTTP_SSL:The HTTP transport secure channel library
LogPath:c:\axis\logs\AxisLog.txt
WSDDFilePath:c:\axis\conf\server.wsdd
XMLParser:c:\axis\lib\AxisXMLParser.dll
Transport_http:c:\axis\lib\HTTPTransport.dll
Channel_HTTP:c:\axis\lib\HTTPChannel.dll
Channel_HTTP_SSL:c:\axis\lib\HTTPSSLChannel.dll |
6. Go into c:/apache and create a small batch file there
| example of start script for Apache startApache.bat | SET AXIS_HOME=c:\axis
SET AXISCPP_DEPLOY=c:\axis
SET PATH=%PATH%;c:\axis\lib
SET LIB_PATH=%LIB_PATH%;c:\axis\lib
apache.exe
pause |
7. create a file in c:\axis\conf\server.wsdd
| Example of c:\axis\conf\server.wsdd | <?xml version="1.0" encoding="UTF-8"?>
<!-- The Entity, wspath in the following internal subset allows setting a
path for the webservices location -->
<!DOCTYPE vars [ <!ENTITY wspath "/home/sanjaya/Axis/webservices/"> ]>
<deployment xmlns="http://xml.apache.org/axis/wsdd/"
xmlns:C="http://xml.apache.org/axis/wsdd/providers/C"
xmlns:CPP="http://xml.apache.org/axis/wsdd/providers/CPP">
<globalConfiguration>
</globalConfiguration>
<service name="transportProperties"
provider="CPP:DOCUMENT"
description="This is a simple test">
<parameter name="className"
value="c:\axis\dll\calculator.dll"/>
<parameter name="allowedMethods" value="add subtract"/>
</service>
</deployment> |
Use script 6. to start Apache, if you get an exception, read it or verify DLL dependencies with DLL dependency walker
Go In a Browser and type http://localhost/axis
|
|
Last Updated ( Wednesday, 05 April 2006 22:01 )
|
