Installation on WindowsXP with VisualStudio?

Installing dependencies

Install cmake

Install  cmake because the build system of WS4D-gSOAP is based on cmake!

Install gSOAP

Get a supported version of gSOAP from  here. Only unpack the gSOAP tarball! Don't install it! See more informations about tested gSOAP versions under Supported gSOAP Versions.

Install xsltproc.exe, patch.exe and sed.exe

The build system uses xsltproc.exe, patch.exe and sed.exe during build time. This programms are typically not available on WindowsXP. You can either install these programs with  cygwin or extract the binaries of this zipfile inside the bin directory of the ws4d-gSOAP source tree.

Install Tortoise

If you want to get ws4d-gSOAP from the subversion repository we recommend the Tortoise subversion client for Windows. You can download it from  here.

Getting the sources

  • Create a Project directory called ws4d-gsoap
    • Create a directory called ws4d-gsoap-build
    • Create a directory called ws4d-gsoap-install

There are two ways how to get the sources. You can either use a source tarball of ws4d-gsoap or the latest development version from our subversion source code repository.

From source tarball

Get latest source tarball from download page and unpack the source tarball into the project directory.

From subversion repository

One easy way to use subversion on Windows is  Tortoise, the following Descriptions based on this GUI.

  • Open the folder whre you want to checkout ws4d-gsoap
  • Rightclick in the folder window and choose "SVN Checkout ..."

Setup build system

Start cmake and fill in the following paths:

Now click the configure button and cmake will ask which version of Visual Studio you wan't to use to compile ws4d-gSOAP. Please choose Visual Studio 8 2005

Now click the OK button. The following error dialog should come up:

This error dialog says that the build system can't find gSOAP. Please press the OK button and again on the following dialog:

Now you have to specify the following options:

  • GSOAP_PATH: the absolute path to the directory where the source tarball of gsoap was unpacked.
  • CMAKE_INSTALL_PREFIX: the absolute path to the directory where this gsoap configuration should be installed. You should use the ws4d-gsoap-install directory created before.

Now click the configure button again until all fields are grey like in the window below.

Now click the OK button and cmake will generate the WS4D-gSOAP.sln project file inside ws4d-gsoap-build.

Build and install WS4D-gSOAP

Open the WS4D-gSOAP project file under dpws-core/Build with Visual Studio 2005 and build the INSTALL target.

Results of installation

After installation you will find the following directory structure inside the cmake install prefix specified before

  • bin: tools for working with and testing devices and code generation
  • etc/ws4d-gSOAP: startup scripts and configuration files
  • include/ws4d-gSOAP: header files for API
  • include/ws4d-gSOAP/WS: gsoap header files of WS-specifications used in DPWS
  • lib/ws4d-gSOAP: libraries implementing dpws: dpwsD - device side, dpwsDmt - device side with multithreading support, dpwsC - client side, dpwsCmt - client side with multithreading support, dpwsS - dpws c databinding of xml schema types
  • share/ws4d-gSOAP: xslt files for metadata code generation
  • share/ws4d-gSOAP/cmake-modules: cmake modules for projects using the stack and cmake as build system
  • share/doc/ws4d-gSOAP/refman.pdf: Documentation for ws4g-gSOAP in pdf format.
  • share/doc/ws4d-gSOAP/html: Documentation for ws4g-gSOAP in html format.
  • share/doc/ws4d-gSOAP/example: This example shows how to use the stack in an external project with cmake as build system.
  • share/doc/ws4d-gSOAP/hosted-example: This example shows how to use create a service for the hosting service mechanism of ws4d-gSOAP.
  • share/doc/ws4d-gSOAP/peer-example: This example shows how to create a dpws peer (client and device at the same time) with ws4d-gSOAP.