Troubleshooting

First things first

1. You must run a '''2.6 version of the kernel'''. This is because Bongo requires NPTL support. Run "uname -r" at the command line to see what version you're running if you don't know.
2. Are you running Xen? If you don't know the answer to that, you're probably not, but some virtual hosting setups (like Linode, Bytemark, etc.) use Xen. Bongo needs TLS enabled to run under Xen. Run "uname -a" at the command line - if this affects you, it will usually (but not always!) have "xenU" in there somewhere.
3. You should attempt to use '''managed-ldap''', configured in bongo-setup.

Dragonfly

If your Dragonfly isn't letting you log in then read on for potential solutions:

1. Your username and password should be correct. The default administration username is admin, and password is bongo.
2. Your '''Apache configuration''' must be correct. If you're running Dragonfly through Apache, you need to get the configuration right before it will even come close to running. In general, if you're using something close to the configuration that comes with Bongo, the following won't work:
   1. Accessing by IP - usually, the setup relies on accessing the Bongo config by server name. If you access by IP, you may not be getting the config from the correct virtual host.
   2. Accessing by http://localhost/bongo/ or similar - this usually means you're not accessing the correct virtual host, but the default host.
3. Another common one is that '''Apache always needs to be properly restarted''' if you (re)start Bongo. There's like some LDAP connectivity reason, and I guess it's a bug, but it holds for now.
4. If you're '''not getting 404s''', it's likely your error log has something else fairly common. A line like:

   1. [Fri Oct 13 06:06:06 2006] [error] [client 127.0.0.1] PythonHandler bongo.dragonfly.Server: Traceback (most recent call last):

   2. ... followed by other stuff is a Python error, and indicates a problem either with the libraries or an error not being checked in the code. The problem really depends on the output, but it could be things like:
      • Python setup in Apache wrong;
      • incorrect version of Python, or missing libraries;
      • missing dependency of some sort;
      • a bug in Bongo

Xen

Bongo won't work if you have disabled Xen TLS (mv /lib/tls /lib/tls.disabled like often said into Xen installation guides).

You will be able to connect to the login page but authentication will fail. Try enabling the TLS support back (mv /lib/tls.disabled /lib/tls) and try again. It causes Xen to run slower, but sadly Bongo needs this functionality.