Setting up Dispatcho on Unix or Macintosh

Dispatcho is a daemon which should be running at all times. It is used to forward email from a POP3 server into the FogBugz database, and to perform certain routine maintenance tasks. (Dispatcho errors are logged to the syslog).

Certain php.ini settings may affect Dispatcho's ability to correctly handle messages with attachments. We recommend that you increase the following settings to these values. Note: If these settings conflict with the settings required by any other PHP-based applications on your web server, please see the PHP documentation for alternatives - you may be able to edit these in fogbugz/fogbugz.conf.

Certain MySQL settings may also affect Dispatcho's ability to correctly handle messages. You should increase the MySQL max_allowed_packet setting to "50M". You can change this setting in the my.cnf file usually located in your mysql/data directory. See the MySQL site for more info.

Lastly, on some machines (RedHat 9 notably), PHP files are set to limit uploads to 500k. Look for a file called php.conf in your httpd/conf.d directory. If there is a value called LimitRequestBody, set it to 0 (meaning unlimited). If you cannot upload files over 500k, this is why.

In the FogBugz/Accessories folder, there is a shell script named dispatchod which can be used to start and stop the Dispatcho daemon:

$ dispatchod start
$ dispatchod stop

To set up dispatcho:

1. Log on as root or issue the su command
2. Start dispatcho now:
   
   $ cd (your FogBugz directory)
   $ cd Accessories
   $ ./dispatchod start
   
   
3. Add it to your server's startup scripts so it starts automatically when your server is rebooted. The way to do this is different on virtually every variety of Unix.

Macintosh OS X (Installer AUTOMATICALLY does this part):

Look in the Accessories folder inside your FogBugz directory. There is a folder there called MacDispatcho. As root, copy this folder into the /Library/StartupItems directory:

$ sudo cp MacDispatcho /Library/StartupItems

Red Hat or Mandrake Linux:

Add a line to the bottom of your /etc/rc.local file:
(your FogBugz directory)/Accessories/dispatchod start

Debian Linux:

Create this short shell script in your /etc/rc.boot directory, named dispatchod.sh:

#!/bin/sh
(your FogBugz directory)/Accessories/dispatchod start

Make the script executable:

$ chmod +x dispatchod.sh

SuSE Linux:

Add a line to the bottom of your /etc/init.d/boot.local file:
(your FogBugz directory)/Accessories/dispatchod start

FreeBSD:

Create this short shell script in your /usr/local/etc/rc.d directory, named dispatchod.sh:

#!/bin/sh
(your FogBugz directory)/Accessories/dispatchod start

Make the script executable:

$ chmod +x dispatchod.sh