Version v1­0

1st Feb 2008

Installation Guide

qaManager v1­0
Table of Contents
qaManager Installation Guide....................................................................................................................3
About this document.............................................................................................................................3
qaManager Overview............................................................................................................................3
Installation and Configuration...............................................................................................................5
Standard Edition....................................................................................................................................6
Starting qaManager...............................................................................................................................6
Logging to qaManager .....................................................................................................................7
Stopping qaManager ........................................................................................................................8
Appendix A : Portlet distribution .........................................................................................................9
Appendix B : Database Configuration ...............................................................................................10

qaManager v1­0
qaManager Installation Guide

About this document

This document guides you through the steps required for Quick Installation and Configuration.
The intended audience of this document are QA Software Testing Professionals and Software Project Managers.

qaManager Overview
qaManager is a web application to manage Software Quality Assurance Projects effectively.
Version v1-0 will support following.
✔ Keep a track of Engineering Releases

✔ Keep a track of QA Releases

✔ Test Case Management

✔ Keep track of Code reviews and document reviews

✔ Keep a track of resource Allocation and Resource Details

✔ Manage QA Projects and Test Cycle Details

✔ Keep Customer informations

✔ Consultation Views for restricted users

✔ Generate Reports in XL and PDF format

✔ Advanced search features

✔ Ability to customize list views

✔ QA Library

✔ Simple Leave Tracking system

✔ Tip of the day feature to encourage knowlede sharing

qaManager v1­0
Following mind map will depicts the project overview. qaManager will continue to improve the existing features
while adding new features.

Special Thanks
qaManager honestly appreciate the continuous help given by Javier Paniza (project lead for OpenXava)

Please send your comments and feedback to qaManager

qaManager v1­0
Installation and Configuration
qaManager installation is very simple!
1) Download qaManager
1. Extract qaManager (unzip or tar -xzvf <fileName>)
2) Install JDK 1.5 and set JAVA_HOME
3) Set CATALINA_HOME={qaManager Installed Directory}/portal
4) Start and access qaManager
1. Change directory to bin (cd bin)
2. Start qaManager. Run script start-qaProjectManager.sh (or .bat)
3. http://localhost:8080
4. user : pm@qamanager.org , password : qamanager

qaManager v1­0
Following section describes the installation in detail.

Standard Edition
Step 1: Download and Install qaManager
Download qaManager (qaManager-v1-0-portal.zip or .tar.gz)
Create installation directory
Extract the file into the installation directory

Step 2: JDK Installation

Download and Install Java JDK 5x
Set JAVA_HOME environmental variable.

Step 3: Set CATALINA_HOME

Set CATALINA_HOME environmental variable to portal directory in your qaManager installation.
e.g : export CATALINA_HOME=/home/janesh/qaManager/portal

Step 4 : Database Configuration

Standard Edition uses an embedded database and you can move Start qaManager
Refer to Appendix B for configuring to your production database (e.g MySQL, Oracle etc).

Starting qaManager
Change directory to bin
Run script start-qaProjectManager.sh (or .bat)

Wait for 30 Seconds to allow qaManager to be started.

qaManager v1­0
Logging to qaManager
Open a web browser and type http://localhost:8080 to access qaManager
Following page will be loaded

Login : pm@qamanager.org
Password : qamanager

Click on the menu items to see the portlets.

qaManager v1­0
Click the menu items as shown in the picture to access qaManager portlets.

Click 1) Welcome to qaManager 2) My Places 3) My Community 4) Private Pages

Stopping qaManager
Start and Stop scripts are available in the bin directory.
Execute stop-qaProjectManager.sh (or .bat) to stop qaManager

qaManager v1­0
Appendix A : Portlet distribution
qaManager can be deployed in a portal (e.g Liferay , JetSpeed2 etc) as a portlet.
Following section briefly describe the steps for the deployment. Please refer to your portal’ s documentation for
details.

Step1 : Download qaManager-v1-0.war ( Download)

Step 2: Download database schema qaManager-v1-0.zip (or tar.gz )

Extract the file into a temporary directory
Create a database qaProjectManager
Execute the SQL qaProjectManager-db-script-<dbName>.sql (e.g qaProjectManager-db-script-
mysql.sql)
Step 3: Configure data source (data source = QaDataSource) as explained in Appendix B
Step 4: Deploy the qaManager-v1-0.war in your portal server

qaManager v1­0
Appendix B : Database Configuration
QaManager standard edition is configured to use Hypersonic as its database.
Hypersonic is an embedded database useful for development and demoing purposes.

QaManager is a J2EE application intended to be deployed in a J2EE application server

You need to configure the data source in your application server.
Please refer to you application server guide for data source configuration.

Database Configuration with Tomcat

Stop tomcat and edit the file context.xml in Tomcat’ s conf directory.

The driverClassName, url , username and password attributes depends on your database

Please refer to your application server documentation to configure a database (data source = QaDataSource)

qaManager v1­0