Getting Your Server Ready for FogBugz for Unix/Mac
Fog Creek Software has collected a list of tips, tutorials, and links to help you install the software packages that are required by FogBugz for Unix. In some cases we provide links to outside web sites, for which we cannot be responsible. Please email us if you find any broken links or if you have any additional tips we can add to this page.
One way to install the required packages is to download the source code and compile it all. For detailed instructions on how to download and install Apache, SSL, MySQL, and PHP from source code, check out this article at DevShed:
The Soothingly Seamless Setup of Apache, SSL, MySQL, and PHP
By Israel Denis Jr. and Eugene Otto
http://www.devshed.com/Server_Side/PHP/SoothinglySeamless/
There's often an easier way, though: many varieties of Unix include their own proprietary package managers, such as "apt" on Debian, "rpm" on Red Hat and Mandrake, or the Ports Collection on FreeBSD. The rest of this page is organized by supported operating system:
Red Hat Linux 8.0 and 9.0, and Fedora Core 3
Mandrake Linux 9.2 - Mandriva Linux 2005
SuSE Linux 9.0
Debian Linux 3.0r1
FreeBSD 5.1
Macintosh OS X 10.3 Panther
Solaris 8, 9, and 10 on SPARC
Red Hat Linux 8.0 and 9.0, and Fedora Core 3
Red Hat Linux provides a graphical Package Management Tool which allows you to install and uninstall groups of related packages. To run the Package Management Tool, type the command redhat-config-packages at the command prompt.
You can also install packages individually using the tool rpm, available on all Red Hat systems. It takes a single file ending with the extension .rpm which corresponds to a chunk of precompiled functionality and installs it on your system. A good place to find the rpm files you need is on the site http://rpmfind.net, a search engine for rpm files.
As of Fedora Core 3, you can use yum, the graphical Fedora package management tool, to get the latest versions of all necessary packages.
Mandrake Linux 9.2 - Mandriva Linux 2005
Mandrake Linux 9.2 allows you to install software packages using the tool rpm. It takes a single file ending with the extension .rpm which corresponds to a chunk of precompiled functionality and installs it on your system. A good place to find the rpm files you need is on the site http://rpmfind.net, a search engine for rpm files.
With Mandrake 10 and Mandriva distributions, you can use the urpmi tool to install packages easily from distribution CDs or "cooker" sites.
SuSE Linux 9.0
Please see the SuSE website for details.
Debian Linux 3.0r1
Debian Linux uses a system called APT. By issuing the apt-get command you can download and install any packages you are missing. Before starting, issue the command apt-get update so that APT can figure out the latest version of every package is.
For a tutorial on APT:
APT distinguishes between "stable" versions of software, which are usually a bit old, and "unstable" versions, which are the latest. At the time of this writing, the "stable" version of PHP was only 4.1, although FogBugz requires PHP 4.3.10. Therefore, you need to set up APT to use unstable releases to make sure you get PHP 4.3.10 or later. To do this:
- Run dselect
- With the arrow keys, choose [A]ccess
- Choose the "apt" access method and press Enter
- You will be prompted to change your source list. Type Y and press enter
- Accept the default location
- When you see the Distribution [stable] prompt, type unstable and press enter
- Accept all the other defaults and quit the program.
In setting up the test system at Fog Creek Software, we installed the following apt packages:
apt-get install curl
apt-get install php4-pear
apt-get install php4 php4-cgi php4-imap php4-mysql
apt-get install mysql-server mysql-clientFor Apache you need:
apt-get install apache-common
apt-get install apache
FreeBSD 5.1
Before installing any other software, you'll want to make sure you have the Ports Collection installed. For more information on obtaining the Ports Collection, see this topic in the FreeBSD Handbook:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html
Once you have the Ports Collection on your server, you can install many software components (including everything you need for FogBugz) just by going into the appropriate directory and typing the appropriate "make" commands.
An excellent tutorial on setting up a FreeBSD server to run Apache, MySQL, and PHP is located here:
Macintosh OS X 10.3 Panther
The Apache web server comes with OS X. Other things you will have to install are listed below.
A great source of Unix server software for OS X:
You'll need to download and install the PHP Apache Module:
http://www.entropy.ch/software/macosx/php/
NOTE: FogBugz does not currently run on PHP5, so do not install the PHP 5 modules from entropy, you want the PHP 4 versions.
The PHP Apache Module includes support for the following PHP components that FogBugz will need: PHP Scripting Language, PHP Command Line Interpretor (CLI), MySQL, IMAP, cURL, XML, and PEAR.
After installing this version of PHP you may also still have the default Apple install of PHP on your system. Please make sure that when you type 'which php' in a Terminal window it is using the entropy-installed PHP (under /usr/local/php) and that your httpd.conf is using the entropy-installed libphp4.so (under /usr/local/php).
And also download and install MySQL here:
An article about using OS X as a web server:
http://www.macdevcenter.com/pub/a/mac/2001/12/07/apache.html
Solaris 8, 9, and 10 on SPARC
Solaris ships with Apache and Mysql.
PHP builds are currently GNU and Linux-centric. A short guide to building and installing PHP and mod_php on Solaris can be found here:
http://www.bolthole.com/solaris/php+solaris.html
NOTE: Remember to build PHP with xml, imap, mysql, and iconv
Binary packages for other necessities, such as Curl and libiconv, can be found here:
