Installation/Source

[edit] Prerequisites

Bongo has a few dependencies that should be available with any recent Linux distribution. To build from source, you'll need the development packages as well.

• Automake >= 1.9
• Autoconf >= 2.53
• Bison 1.875
• gettext
• OpenLDAP
• GNUTLS (don't forget gnutls-bin)
• Popt
• Python >= 2.3
• Python Devel
• Doxygen
• Libtool
• Flex
• LXML Python library

Apache is recommended for Dragonfly and Hawkeye: it's not necessary, but it runs a lot faster under mod_python.

In addition, if you can install the CLucene, SQLite and Curl libraries, and their development headers, you'll find the compilation is a lot quicker, and the resulting binaries will operate against the package libraries.

[edit] Distribution-specific commands for fulfilling dependencies.

[edit] Debian and Ubuntu

$ sudo apt-get install bison build-essential slapd subversion libtool \
automake1.9 gnutls-dev python2.4-dev libpopt-dev flex pkg-config libldap2-dev \
gettext ldapscripts gnutls-bin ldap-utils libclucene0 libclucene-dev sqlite3 \
libsqlite3-dev curl python python-dev libcurl3-gnutls-dev doxygen python-lxml

[edit] Fedora

# yum install subversion autoconf libtool automake gcc-c++ libgcrypt-devel \
gnutls-devel clucene-core-devel sqlite-devel curl-devel gettext flex bison \
python-devel openldap openldap-servers openldap-devel python-lxml

[edit] openSUSE

[edit] 10.2

# yast -i automake autoconf subversion bison python python-devel pkgconfig \
flex doxygen libtool gettext curl curl-devel sqlite sqlite-devel gnutls \
gnutls-devel check gcc make gcc-c++ popt openldap2 openldap2-devel python-lxml

[edit] 10.3

zypper in automake autoconf subversion bison python python-devel pkgconfig \
flex doxygen libtool gettext curl libcurl-devel sqlite sqlite-devel gnutls \
gnutls-devel check gcc make gcc-c++ popt openldap2 openldap2-devel python-lxml

[edit] Get the code

If you want to use a version of the code which is known to be reasonable, check the Releases page and download the latest one.

If you want the absolute latest version (which may not necessarily be stable), run the following command to checkout the latest code from the Subversion repository.

svn checkout http://svn.gna.org/svn/bongo/trunk bongo

This will check out the current development branch of Bongo.

[edit] Create a user

Bongo can be run as root, but for security reasons it is best to run it as its own unprivileged user. You can create a 'bongo' user using your distribution's administration tools, usually by executing the following as root:

useradd bongo

[edit] Build the code

This command line assumes you created a user named 'bongo'. If you want to run as root, leave out the "--with-user=bongo" argument to autogen.sh.

We also recommend that you install to a place such as /usr/local/bongo, so that the installation is self-contained.

$ cd bongo/
$ ./autogen.sh --prefix=/usr/local/bongo --with-user=bongo --enable-debug-cflags
$ make
# make install

Developers may be interested in other Autogen Options.

[edit] Next steps

Once you have installed Bongo, you can continue on to configuring Bongo!