Before INSTALL
==============

 To install this package, you need to pre-install the following:

  1. libxml2 (http://xmlsoft.org/)
  2. OpenSSL (http://www.openssl.org/)

* Warning
   If you install from pkgsrc on NetBSD, `xml2-config' has a bug and
  you need to modify it so that the output of "xml2-config --cflags"
  is valid.

   You may require the development environment for libxml2 like
  "libxml2-devel" for certain packages like Linux rpm.

Simple Installation
===================

  The following shows how to perform a simple installation:

  $ ./configure
  $ make
  $ su 
  # make install

* Warning
   GNU make may have to be used on the above make.
  If installing on *BSD, replace the above "make" with "gmake".

configure options
=================

  ./configure --help  shows a list of configuration options.

  If OpenSSL is not installed on the default /usr/local directory, you
  need to specify the installed directory by --with-ssl=DIR.
  For example, if files like
  /usr/local/ssl/include/openssl/rsa.h
  /usr/local/ssl/lib/libcrypt.o
  are installed, you can specify that by
  ./configure --with-ssl=/usr/local/ssl

  On RedHat9, you may need to specify /usr/kerberos/include directory
  for compiling OpenSSL.
  Please refer the result of `pkg-config --cflags openssl`.  The
  easiest way is following:
  ./configure --with-ssl-include=/usr/kerberos/include

  If the conversion routine of multibyte strings to widecharacter
  strings on the system has a bug, "--enable-buildin-mbfuncs" option
  may possibly avoid the problem.  But this workaround can handle only
  US-ASCII(ISO-8859-1) character encoding.

  On such enviorments like NetBSD and so on, where iconv doesn't work
  as expected, using "--disable-system-iconv" option can be a
  workaround.

Compiling your original program
===============================

  On the default settings, add "/usr/local/opensoap/include" to the Include
  Path and "/usr/local/opensoap/lib" to the Library Path.
  Specify the library with "-lOpenSOAPClient" for client programs, and
  "-lOpenSOAPService -lOpenSOAPClient" for service programs.
  On the system with shared libraries, add "/usr/local/lib" to the
  search path of execution library.  For example, with gcc, add
  "-Wl,-rpath -Wl,/usr/local/lib" to the options for linking
  libraries.

Installation Directories
========================

  By default, the OpenSOAP Server is installed under /usr/local/opensoap.
  Use the -prefix option of configure to specify an alternate installation directory.

  In previous versions (up to opensoap-1.0-20021130) of this package, the default installation
  directories were /var/tmp/OpenSOAP, and /usr/local for libraries, header files and executables.
  To remove older files that have been installed in these directories use the uninstall-olddir.sh
  script.

  Also, if there are any services that have been created using the previous
  OpenSOAP directory structure, attention should be paid to the following points.

  1. Libraries Path
       (/usr/local/lib -> /usr/local/opensoap/lib)
     If the dynamically linked libraries libOpenSOAP*.so are used, then add the 
     path /usr/local/opensoap/lib to /etc/ld.so.conf and as root run ldconfig to
     update the library search path.

  2. OpenSOAP Server Configuration Files
       (/var/tmp/OpenSOAP/conf -> /usr/local/opensoap/etc)
     Previous configuration files (backward.conf, forward.conf, signature.conf) are
     combined to form a single configuration file server.conf.
     The keys files for the server are also located in this directory.

  3. Running Services From The OpenSOAP Server
     SSML files are now located in /usr/local/opensoap/etc/ssml/ .
       (/var/tmp/OpenSOAP/conf/ssml/*.ssml -> /usr/local/opensoap/etc/ssml/*.ssml)
     Program related files for each service are now located under /usr/local/opensoap/services/
     in their respective directories.
     Eg. for the HelloService,
       (/usr/localsbin/HelloService -> /usr/local/opensoap/services/HelloService/HelloService).
    


