WSO2 Web Services Framework for C++ - Installation Guide (Linux)

1. Software Dependencies

1.1. Mandatory

Libxml2 - http://www.xmlsoft.org/
libiconv - http://www.gnu.org/software/libiconv/
zlib - http://www.zlib.net/

1.2. Optional

Apache2 httpd - http://httpd.apache.org/ - Required for deploying services with HTTPD
OpenSSL - http://www.openssl.org/ - Required for SSL client transport and WS-Security with Apache Rampart/C
Either SQLite - http://www.sqlite.org/ or MySQL - http://www.mysql.org/ - Required for WS-ReliableMessaging with Apache Sandesha2/C
iksemel - http://iksemel.jabberstudio.org/ - Required for XMPP transport

2. Requirements

To install and run WSF/C++ using the source distribution on Linux, you are required to have pkg-config on your system. By default, most Linux systems have this tool.

3. Building and Installing WSO2 WSF/C++ from Source on Linux.

Extract the source tar package to a folder.
Set WSFCPP_HOME environment variable pointing to the location where you want to install WSO2 WSF/C++.
```
	$ WSFCPP_HOME='/your_desired_path_to_wsf_c++_installation'
	$ export WSFCPP_HOME
```
Then go to the folder where you extracted the source.
```
	$ cd /your_path_to_wsf_c++_source
```
Build the source
* This can be done using the following command sequence in the directory where you have extracted the source
```
	$  ./configure --prefix=${WSFCPP_HOME}
	$ make
	$ make install
	$ make examples
```
Go to where you installed WSO2 WSF/C++. Start simple axis server
* To start the simple axis server on port 9090 run the following commands
```
	$ cd ${WSFCPP_HOME}/bin
	$ ./axis2_http_server
```
To see the possible command line options run ./axis2_http_server -h. If you run into shared library problems, try setting the LD_LIBRARY_PATH
```
	$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${WSFCPP_HOME}/lib
```

Now you are ready to use WSO2 WSF/C++.

Notes:

You may require super user privileges to run make install on your system.
You may optionally specify the path in which the installation should be deployed using ./configure --prefix=PATH.
If you don't provide the --prefix configure option, WSO2 WSF/C++ will by default be installed into, /opt/wso2/wsf_cpp
You may run ./configure --help for more information on configure options.