How To Install Under Ubuntu 7.10 – Method 1

Posted by Bill on February 24th, 2008

Hello there! If you are new here, you might want to subscribe to the RSS feed for updates on this topic.

The following are steps we take in deploying the Bugs Dashboard to a test platform running Ubuntu 7.10. Under this method, we do not use the Tomcat Manager to deploy; we'll look at that in another post.

Prerequisites

Tomcat has been successfully installed (see Installing Tomcat 6 on Ubuntu at the How-to Geek)
MySQL (see the Ubuntu Guide) or PostgreSQL (see the Ubuntu Guide and supriyadisw dot net) have been successfully installed
Bugzilla has been successfully installed in one of the above databases and can be reached via a JDBC connection from the Tomcat server

Steps

Download the latest Developer or Enterprise version of Bugs Dashboard and either a) save it to disk or b) open it with the Archive Manager and then Extract the contents. We chose to save the zip file to the desktop.
If you did not use the Archive Manager in step 1, navigate to the downloaded file, right-mouse click on the file and select Extract Here.
Extracting the file locally will result in a new directory named "bugs".
Open the bugs directory. Inside, you will find the README (read it, please!), the documentation (under the docs directory), the license, and the bugs.war file.
Right mouse cick on the bug.war file and choose Extract Here.
This will create another 'bugs' directory and this is the directory you will deploy.
Open the bugs directory. In it are the css, images, javascript and WEB-INF directories. Much of the modification which you must do to configure the Bugs Dashboard will be done in the WEB-INF directory.
Follow the steps at the Quick Start post or the How-to Configure pages to configure your copy of the Bugs Dashboard.
When your configuration is complete, move the second bugs directory (the one we stated you would deploy above) with the WEB-INF directory in it to the Tomcat webapps directory. In our case, this was under /opt/apache-tomcat-6.0.16/webapps.
In our testing, we found that it was not necessary to bounce the Tomcat server for the Bugs Dashboard to deploy. Open a browser and navigate to your local installation (this might be http://localhost or your domain name, in our case, it was http://localhost:8080/bugs/portal) and open the portal page (it will open to the first portal in the portals_en_US.properties file). If, for any reason, the page does not come right up, review the troubleshooting tips in the Quick Start guide.
Should you need to change your configuration, it may be necessary to stop and restart (i.e. bounce) Tomcat. You can do this by opening a terminal window, switching to root (sudo -s) and navigating to the Tomcat bin directory. Execute the shutdown script (./shutdown.sh), make any necessary changes, and then execute the startup script (./startup.sh).