Installation
============

IdPC uses automake and autoconf which should make compilation and installation
a breeze.  Kind of.

Basic usage is::

 ./configure
 make
 make install

It will most likely bail out because of missing libraries.  You need libxml2_
(XML support, used for configuration file), neon_ (HTTP support, used for SOAP
requests), OpenSSL_ (OCSP support) and Lasso_ (Liberty Alliance support).

=======   =============================  ==========================
Library   URL                            Debian package name
=======   =============================  ==========================
libxml2   http://xmlsoft.org/            libxml2-dev
neon      http://www.webdav.org/neon/    libneon-dev
lasso     http://lasso.entrouvert.org/   liblasso-dev
openssl   http://www.openssl.org/        libssl-dev
=======   =============================  ==========================

Additionaly, you will also need either PostgreSQL or MySQL for the database
support.  PostgreSQL is the default.  It is possible to set the database engine
to use that way::

  ./configure --with-dbengine=mysql

==========   =============================  =================================
Library      URL                            Debian package name
==========   =============================  =================================
postgresql   http://www.postgresql.org      postgresql-dev
mysql        http://www.mysql.org           libmysqlclient-dev
==========   =============================  =================================

It may also be useful to set the path to the configuration files; default is
``${prefix}/etc`` (hence ``/usr/local/etc/``)::

  ./configure --sysconfdir=/etc/

It is possible to combine ``configure`` flags such as::

  ./configure --prefix=/usr/ --sysconfdir=/etc/  --dbengine=postgresql

Compilation is then straightforward; just type ``make``.

Once compiled; ``make install`` won't do much since there are no standard
places for CGI.  You can copy them (they are the executables in src/) in your
favourite place.  Note that if you want to use HTTP authentication;
``singleSignOn`` should be installed in a different directory.


.. _libxml2: http://www.xmlsoft.org/
.. _neon: http://www.webdav.org/neon/
.. _lasso: http://lasso.entrouvert.org/
.. _openssl: http://www.openssl.org/