How-to Install

Estimated Time Required

30 minutes

Business Value

One-time installation preparing the way for customer satisfaction.

Prerequisites

  1. Installation and configuration of a supported issue tracking system (e.g. Bugzilla)
  2. Installation and configuration of a Servlet container (e.g. Tomcat)
  3. Addition of a role to the Servlet container to allow access to the Bugs Dashboard Wizard -or- removal of the security on the Wizard. If using Tomcat, the tomcat-users.xml file should be updated to include the following roles: 
      <role rolename="bugs_wizard"/>
  <role rolename="bugs_administration"/>

    At least one user should be assigned each role to allow that person to configure Bugs Dashboard, e.g.

      <user username="bhamilton" password="34c2fbe131e7d9b8ae9871f6d3590054c8cabb23" fullName="" roles="bugs_administration,bugs_wizard"/>

    Alternatively, you can remove the security protection from Bugs Dashboard. Open the /bugs/WEB-INF/web.xml file and search for 

    <security-constraint>

    There are two instances. Comment out both by surrounding them with <!– and –>

Process

  1. Download and unzip the bugs.zip file
  2. Open the directory that was created by unzipping the files.
  3. You can either (a) move the bugs.war file into your Servlet container’s deployment directory (e.g. webapps) and restart your Servlet container or (b) deploy the bugs.war using the Tomcat Manager.
  4. After the deployment is complete (i.e. Tomcat has restarted or the Tomcat Manager has successfully deployed the war file), open the Installation Wizard from /bugs/wizard (assuming you deployed “bugs”).
  5. Follow the onscreen steps to complete the Installation Wizard (see the Installation Guide which ships with each version and is located in the /docs directory of the folder created when you unzipped the files for explanations of each step).
  6. After you have clicked Submit on the last step of the Installation Wizard, you will be presented with a button which you can click to login to Bugs Dashboard. Alternatively, you can also use /bugs/login.
  7. To configure unique dashboards for your use, use the Admin interface (e.g. /bugs/admin) and see the Administrator’s Guide which also ships with each version.