Unix and Mac OS Setup steps

Background

Before beginning, be sure that:

• You know what user you want FogBugz to run as (and that the user account has been created)
• (MySQL users only) The MySQL database server you want to use is running

The installer can operate in two modes, basic and advanced. Advanced asks a few more questions, whereas basic uses the defaults. Most users will be satisfied with the defaults. You can exit the installer at any time by pressing ^C or ^D.

Many times, when the installer asks a question, it will provide a list of valid responses and a default. For example:

What do you want to eat? (pizza burgers chili) [pizza]

For this question, any of pizza, burgers, or chili are acceptable. Pressing enter without providing an answer selects the default, pizza. The question will be repeated until a valid answer is provided.

The installer will inquire on the following topics:

1. User: It's most secure to run FogBugz as a distinct user, but you can run it as just about anybody. The user account must exist before running the installer.
2. Location: You can install FogBugz in just about any folder. FogBugz can only be installed into a new or empty directory, unless you're upgrading an existing installation.
3. Apache configuration: [This section may be confusing. You will likely be happy just pressing enter when you get here.] FogBugz uses its own webserver to avoid interference with other web sites you are serving, but it can be integrated into the main server via a simple redirect. (Integrated doesn't mean that FogBugz actually runs in your webserver, just that a redirect is added to give the illusion of such.) Standalone means that this redirect is not added. For very special setups, you can also select a manual install, in which case install.sh leaves the work up to you. (You almost certainly want to pick integrated or standalone.)
4. Database configuration: FogBugz can use either MySQL or SQLite as a database backend. SQLite is a very simple zero configuration database ideal for users who don't want to learn to be database administrators, too.
   • MySQL: FogBugz requires a connection to a running MySQL database server. The installer can take care of creating the necessary user and database, as long as the server is running.
   • SQLite: Nothing to do. FogBugz and the installer do all the work.
5. Startup scripts: If you're running as root, FogBugz can insert itself into the system's startup scripts so that it starts automatically after a reboot.

The Steps

To install FogBugz for Unix on your server:

1. Uncompress the tar.gz file in a temporary location, not the directory where it will be installed:
   
   $ tar xzvf fogbugz-unix-7.1.1.tar.gz
   $ cd fogbugz-unix-7.1.1
   
   
2. Run the install.sh script:
   
   $ sudo ./install.sh
   
   
3. The installer will take you through a short series of questions and either upgrade an existing FogBugz or install a fresh FogBugz 7, and automatically download an appropriate set of tools for your platform.
   
   If you're upgrading an existing FogBugz installation, be sure to specify the previous install directory as the location you'd like to install to (when prompted to do so).
   
   
4. install.sh will ask if you want to start FogBugz. You can always start it manually by running bin/start-fogbugz.
   
   
5. When setup is complete, launch your web browser and navigate to
   
   http://localhost/fogbugz/