Installing Bamboo 1.0 on Tomcat 5.x under Linux (or any generic UNIX)

1. Download the bamboo-1.0.war file from the download site.
2. Install PostgreSQL setup a database, username, and password

   PostgreSQL:

   # createuser -P bamboouser
   
   ... give no permissions unless needed (not needed by default) ...
   
   # createdb bamboo

3. At this point there are two steps one can take:
   1. Install the WAR in an existing Tomcat server
      • just drop the WAR in the webapps directory

        # cp bamboo-1.0.war <tomcat_install>/webapps/forum.war

   2. or download and extract a new install of Tomcat
      • extract the Tomcat 5.x binary package:

        # tar xfvz jakarta-tomcat-5.0.28.tar.gz

      • drop the WAR in the webapps directory

        # cp bamboo-1.0.war <tomcat_install>/webapps/forum.war

4. If you're using Java 5, then you must delete all files from the endorsed directory, this is because of an interaction between the bundled Xerces and Bamboo

   # rm -f <tomcat_install>/common/endorsed/*

5. Start the server by executing:

   # <tomcat_install>/bin/startup.sh

6. Open a web browser and goto http://localhost:8080/, unless Bamboo has been installed on a different server. In which case, you should go to that servers FQDN (fully qualified domain name)
7. Upon loading this page you will be presented with the interactive setup guide. Please follow the instructions, at the end of which Bamboo will be fully installed.
8. Congratulations! Now the only thing left to do is communicate with your users.