E.1.1 Installing GnuGK for H.350 Directory Service

E.1.1.1 Notes

The installation has been successfully tested using GnuGK 2.0.8 running on Linux/Unix using the underlying libraries OpenH323 1.14.4.2 (Pandora release) and pwlib 1.7.5.2 (Pandora release). Updated ldaplink.cxx files are also necessary. A template gnugk-h350.conf (http://metric.it.uab.edu/vnet/documents/gnugk/gnugk-h350.conf) file for configuring GnuGK with H.350 is available.

E.1.1.2 Requirements

• Unix (or UNIX-like system; see also http://www.gnugk.org/gnugk-manual-2.html)
• A running H.350 Directory Service (see http://metric.it.uab.edu/vnet/cookbook/)

E.1.1.3 Components

• GnuGK
  • This is a Gatekeeper (including a Proxy)

E.1.1.4 Installation

(1) Download the source files from the Sourceforge repositories;

http://sourceforge.net/projects/openh323/ for the openh323 and pwlib libraries;

http://sourceforge.net/projects/openh323gk/ for the GnuGK

(2) Expand the pwlib installation file

Example: tar -xvfs pwlib-Pandora_release-src-tar.gz

(3) Export a the pwlib path variable

Example: export PWLIBDIR=~/pwlib

(4) Change to the <path_to_pwlib> directory

Example: cd ~/pwlib

(5) View and choose the configuration options for the pwlib library

./configure -help

(6) Run the configuration utility for pwlib specifying the configuration option, that

you do not want sasl (Simple Authentication and Security Layer) support

./configure -disable-sasl

(7) Build the pwlib library

make

(8) Change back to the download directory

Example: cd ..

(9) Expand the openh323 installation file

Example: tar -xvfs openh323-Pandora_release-src-tar.gz

(10) Export the openh323 path variable

Example: export OPENH323DIR=~/openh323

(11) Change to the openh323 directory

Example: cd ~/openh323

(12) View and choose the configuration options for the openh323 library

./configure -help

(13) Run the configuration utility without any specific configuration option

./configure

(14) Build the openh323 library

make

(15) Change back to the download directory

Example: cd ..

(16) Expand the GnuGK installation file

Example: tar -xvfs gnugk-2.0.8.tar.gz

(16a) If you use GnuGK 2.0.8 please replace the ldaplink.cxx file the the openh323gk

directory

Example: cp ldaplink.cxx ~/openh323gk/

(17) There are several options available for the compilation of GnuGK. A detailed

description is avaialable at http:://www.gnugk.org. The following example

shows how to compile GnuGK with LDAP support and Accounting. Other options

suchs as mysql support or Radius are disabled. Notice: Everything is ONE

command line option.

Example: NO_MYSQL=1 NO_PGSQL=1 NO_RADIUS=1 HAS_ACCT=1 HAS_LDAP=1 make both

(18) GnuGK should now be installed

(19) Download the sample configuration file gnugk-h350-sample.conf and place it

in a directory of your choice. NOTICE: The configuration file is only a sample

and also just configures a minimal Gatekeeper. Additional features such as

the proxy and so forth needs to be adjusted individually. A full description

of the configuration is available at http://www.gnugk.org

Example: /etc/gnugk-h350-example.conf

(20) Open the configuration file with an editor of your choice, and adjust the

configuration to your needs. NOTICE: Only 'adjustable' lines will be

explained

[Gatekeeper::Main]

...

Name=example.com // This line represent the name of the Gatekeeper

// The DNS name or the Zone name could be used

Home=10.10.1.10 // The IP address of the Gatekeeper

[GkLDAP::Settings]

ServerName=example.com // The DNS name or IP address

// of the H.350 Directory service

SearchBaseDN=dc=example,dc=com

BindUserDN=cn=manager,dc=example,dc=com // LDAP User to bind with

(21) You should now have configured GnuGK using the H.350 Directory Service

for endpoint authorization.