Build ProLinga-Soap

Table of Contents

Prerequisites
Build Instructions

Prerequisites

ProLinga-Soap 0.0.4 has currently been built and tested on Fedora Core, Mandriva Linux, Debian, openSUSE, Ubuntu, FreeBSD and MS-Windows (Cygwin). The product should compile and run successfully on other GNU/Linux distributions as well as UNIX. GNU gcc/g++ >= 3.3 compilers/tools are required for a successful build.

Required 3rd party package(s) for a successful build:

libxml2. This product provides XML libraries.

Optional 3rd party package(s):

gSOAP. This product provides a SOAP/XML to C/C++ language binding. Not required for normal ProLinga-Soap builds, since gSOAP sources are integrated with ProLinga Soap sources. Only required when upgrading gSOAP or changing the SOAP schema. The current version used is gSOAP 2.7.16 stable.
xsltproc. Command line processor. This package is only required to re-generate the HTML pages after making changes to the documentation.

General Download Instructions 3rd Party Products.

Assuming the directory /opt/builds will be used for 3rd party products, then in general the following steps need to be taken to download and extract a 3rd party product source archive.

Download source tar/gz archive to /opt/builds/[product] Example: place libxml2-x.x.x.tar.gz in /opt/builds/libxml2
Use 'gunzip' to unzip the archive
Use 'tar xvf [product.tar] to extract the archive. Example: tar xvf libxml2-x.x.x.tar.
A new sub directory will be created with the new version of the product. Example: /opt/builds/libxml2/libxml2-x.x.x This way several versions of the same products can be installed next to each other.

For product specific installation instructions see following sections.

Libxml2:

Product root dir: /opt/builds/libxml2

Current version: 2.7.2

Download: ftp://xmlsoft.org/libxml2/libxml2-2.7.2.tar.gz

Build Instructions:

cd /opt/builds/libxml2/libxml2-2.7.2
./configure --prefix=/opt/builds/libxml2/libxml2-2.7.2
make
make install

gSOAP:

This product only needs to be installed when upgrading gSOAP or when changing the SOAP schema.

Product root dir: /opt/builds/gsoap

Current version: 2.7.16 stable

Download: http://sourceforge.net/projects/gsoap2/files/gSOAP/2.7.16%20stable/gsoap_2.7.16.zip/download

gSOAP sources will be integrated into the ProLinga-Soap sources. When upgrading a gSOAP version perform the following steps:

Go to the ProLinga-Soap src/gsoap directory and remove all files except prolingaSoap.hpp
Generate a new SOAP schema by typing: "[gsoap-unpack-dir]/gsoap-2.7/gsoap/bin/linux386/soapcpp2 -2 prolingaSoap.hpp". This will generate (about) 14 files.
Copy the files stdsoap2.cpp and stdsoap2.h from [gsoap-unpack-dir]/gsoap-2.7/gsoap to the ProLinga-Soap src/gsoap directory.
Build ProLinga-Soap. (make and/or make install)
Done.

When changing the ProLinga-Soap schema you should know what you are doing, otherwise DO NOT TOUCH or all projects using the ProLinga-Soap library will fall over!