Next Previous Contents

2. Compiling and Installing

2.1 Compiling the Gatekeeper

To build the gatekeeper you need at least PWLib 1.2 and OpenH323 1.8 or later. The development version of the gatekeeper usually needs the most recent OpenH323 version available. These libraries are available at OpenH323 Download Page. See the instructions on how to compile the OpenH323 code.

Order of compiling:

  1. PWLib (release + debug version)
  2. OpenH323
  3. OpenH323 test application (not needed, just to make sure everything works so far)
  4. The Gatekeeper

On Unix do a make debug or make opt in the gatekeeper directory to build debug or release version, respectively. Use make both to build both versions. Note you have to use GCC 2.95.2 or later. The older version may not work.

On Windows just open and compile the provided project (gk.dsw) for Microsoft Visual C++ 6.0 or 7.0 (Visual C++ 5.0 is too old).

Since version 2.0, the Gatekeeper supports MySQL and LDAP backend databases. If you don't want MySQL support, you may set NO_MYSQL environment before making:

$ NO_MYSQL=1 make both

To leave out LDAP support:

$ NO_LDAP=1 make both

Or disable both with

$ NO_MYSQL=1 NO_LDAP=1 make both

Since version 2.0.1 the Gatekeeper has implemented an extended fd_set structure that enables the Gatekeeper to support thousands of concurrent calls in routed mode. To enable this feature, export LARGE_FDSET environment variable to the maximum number of file descriptors. For example,

$ LARGE_FDSET=16384 make opt

2.2 Installing the Gatekeeper

There is no special installation procedure needed. Just copy the executable to the directory you like and create a config file for it. There are several config examples in the etc/ subdirectory of source tree. See section Configuration File for detailed explanations.

For example, in Linux x86 platform, the optimized executable gnugk is produced in obj_linux_x86_r/ subdirectory. You may copy it to /usr/sbin/, create a config in /etc/gnugk.ini and start it by

$ /usr/sbin/gnugk -c /etc/gnugk.ini -o /var/log/gnugk.log -ttt
See section Command Line Options for details.

2.3 Pre-Built Binaries

If you do not wish to compile the gatekeeper from source, there are several pre-built `packages' available from SourceForge. Not all versions will be made available as binaries - check what is avilable.

Red Hat packages (.rpm)

Download the RPMs and enter the following command as root, substitute in the name of the file you downloaded.

$ rpm -Uvh gnugk-x.x.x.rpm

Debian packages (.deb)

If you are using the `stable' (woody) branch of Debian, you can install the gatekeeper by using the following command as root:

$ apt-get install openh323gk


Next Previous Contents