Axis C++ Integration Guide

0.1 Version

Table of Contents

Introduction
Pluggable APIs
  Components
  Logging/Tracing
  Configuration
  Handlers
  Internationalization
  Performance Monitoring
  Encoding
  WSDL Parser and Code Generator Framework

Introduction

The primary purpose of this guide is to present how AXISCPP can be integrated into an existing web application server, such as Apache, Netscape web server for example.  AXIS has a number of Pluggable APIs that are necessary for such an integration.

The reader may find useful background information in the Architecture Guide

Pluggable APIs

The following are the points that are pluggable in order to integrate AXIS into a web application server. The first subsection details a number of pluggable components in general. More details are provided for other components in the remaining subsections.

Handlers

See the Architecture Guide for current information on Handlers.

Configuration

Axis C++ server can be configured to run on Aapache, Netscape web server(Not implemented yet) and Microsoft IIS(Not yet implemented. Also it is expected to run on Solaris, IBM AIX, HPUnix,FreeBSD, Linux and Windows. Currently it is tested only on RedHat Linux(8).

Linux :Apache web server

This document is intended for the developer who wish to download and test the axiscpp server.

Checkout axiscpp from cvs repository.

for simplicity assume that your axiscpp is now /usr/local/axiscpp

From now on I call this <axiscpp_home>

goto <axiscpp_home>/release


copy the libaxiscpp_mod.so file into <apache home directory>/libexec directory.

For the apache server to load this shared module it (the apache web server) must be compiled with shareable module support (To do this, when running the configure script pass it the option "--enable-module=so") For further information on comipiling and installing the apache web server please visit http://httpd.apache.org .


open the httpd.conf file in <apache directory>/conf/

add the following lines


LoadFile /usr/local/apache/libexec/libaxiscpp_mod.so

LoadModule axis_module libexec/libaxiscpp_mod.so


<Location /axis>

SetHandler axis

</Location>


where /axis is context path where the apache|axiscpp is listening to webservice requests.

Now stop the apache web server if it is already started.

Start the apache web server. If it starts without giving problem the module is successfully loaded.

Read the userguide for information on how to test the webservices on your newly installed soap server.