This files describes how to install the openser for the Austrian IENUM Trial.

openser-ienum changelog:
  Version 0.4: 
  - based on openser-1.1.0 from 2006-10-02
  - domainpolicy module 0.4 + sql patch
    - aligns with draft-lendl-domain-policy-ddds-02
    - a few updates and bug-fixes
    - supports draft-lendl-speermint-federations-02 and draft-lendl-speermint-technical-policy-00
    - handling of non-terminal NAPTR records, as well as the DB schema has changed.

  Version 0.3: 
  - based on openser-1.1.0 from 2006-07-14

  Version 0.2: 
  - based on openser-CVS head from 2006-05-22
  - tls patch not needed anymore as applied to CVS head
  - domainpolicy module 0.2 + sql patch
    - supports integer name based AVPs in "attr" column of domainpolicy table
    - supports forcing a send_socket via dp_apply_policy
    - bug fixed (NAPTR lookup need \0 terminated string)

  Version 0.1: initial release
  - based on openser-CVS head from 2006-05-17
  - ienum patch
  - tls patch
  - domainpolicy module 0.1 + sql patch

Compared to openser CVS, this openser has the following differences:
- ienum patch to allow ienum queries
- domainpolicy modul to allow ad-hoc peering

This file decribes how to build your IENUM-openser.

1. You have to get the sources. There a 2 choices. You can either download the patched openser-tarball from www.enum.at or you patch it yourself.

1.1. Download the patched tarball: Go to enum.at, download the patched tarball (currently version 0.4).
     Untar it using the command "tar -xvjf openser-ienum-0.4.tgz"
     cd sip-server

1.2 Checkout openser from sourceforge's CVS and apply the patches manually. (Patches were tested to apply to openser-1.1.0 from 2006-10-02).

checkout openser-cvs
  cvs -d:pserver:anonymous@openser.cvs.sourceforge.net:/cvsroot/openser login
  cvs -z3 -d:pserver:anonymous@openser.cvs.sourceforge.net:/cvsroot/openser co -r rel_1_1_0 -P sip-server

download ienum patch
  wget -O ienum-patch.txt "http://sourceforge.net/tracker/download.php?group_id=139143&atid=743022&file_id=177989&aid=1344272"
download domainpolicy modul und SQL patch from enum.at homepage
  openser-domainpolicy_0.4.tgz
  openser-domainpolicy-sql-patch_0.3.txt

apply patches
  cd sip-server
  patch -p0 <../openser-domainpolicy-sql-patch_0.3.txt
  cd modules
  tar -xvzf ../../domainpolicy_0.4.tgz
  cd ..
  patch -p0 <../ienum-patch.txt

2. Building the ienum-openser

When building openser, you have to install some development libraries, e.g. libssl-dev for TLS and mysql or postgresql development libraries. Further you have to install the libradius-ng-dev package. This must be built from the sources of radiusclient-ng available from berlios.

Depending on your Linux Distribution there are different choices to build:

2.1. Debian

The easiest way is build packages:
 
  make deb
 
This will build TLS enabled openser packages. As this will build all available modules, you need several development libraries installed on the system. E.g. the libmysql-dev, libpg-dev and the radiusclient-ng devel libraries. As the radiusclient-ng is not part of debian, you have to install it manually as described on the openser wiki: http://www.openser.org/dokuwiki/doku.php?id=howto_make_debian_packages

Depending on your setup, and the used DB (mysql or postgresql) install the built debian packages. E.g.:
NOTE: this step replaces existing installed openser packages. Take care as openser-1.1 syntax is not 100% compatible with openser-1.0 syntax.

  cd ..
  su
  dpkg -i openser_1.1.0-0_i386.deb openser-mysql-module_1.1.0-0_i386.deb

Set up the database tables: NOTE: edit the script /usr/sbin/openser_mysql.sh (or set environment variables, e.g. "export DBNAME=ienum_borderproxy") to reflect your DB environment (e.g. to do not overwrite existing openser databases).

  openser_mysql.sh create

Now you can edit the config in /etc/openser/openser.cfg and use the start/stop script /etc/init.d/openser.

For debugging watch syslog logging in /var/log/syslog

2.2. Others

You can install openser manually. First you have to modify the Makefile to remove the needed modules from "exclude_modules", e.g. mysql or postgres. Then build the usual way:

NOTE: this step replaces existing manually installed openser. Take care as openser-1.1 syntax is not 100% compatible with openser-1.0 syntax.

  export TLS=1
  make all
  su
  make install
  
This will install openser in /usr/local/sbin/openser and /usr/local/lib/openser/modules/. The configuration is stored in /usr/local/etc/openser/openser.cfg. There is no startup script installed, thus you have to copy it manually from etc/openser.init to /etc/init.d/openser and adopt it to your paths.

3. Config

If you are used to ser or openser-1.0.x, please the migration info on http://openser.org/dokuwiki/doku.php?id=migrating_openser_v1.0.x_to_v1.1.x