REVER readme

Releases Tracking

URL:	http://rever.sourceforge.net
Developer:	M. Laura Soldo, mlsoldodev@users.sourceforge.net
Collaboration:	Dario Lanati, lanatidario@openware.biz Gabriel Ascencao, gascencao@openware.biz
Idea and support:	http://www.openware.biz
Documentation: REVER Installation Guide	Table of Contents Introduction Installation System Requirements File Unpacking Database Database Access Configuration Create users Load Data to the System Licence Glossary
New features for features releases:	See REVER. http://rever.sourceforge.net

REVER Installation Guide

REVER Version: 0.6.5

Introduction

REVER is a release manager for products. It's a tool that allows users to follow product releases, even hard or software. Depending what kind of user you are and your permissions, you will have a particular vision about the product. If you are a product coordinator, you can order, approve or reject requests or suggestions for those releases.

Features:

As a product coordinator, through Roadmap you can have a particular overview about the current stage of the product development and allow reflect and organize the steps to follow.
This is make through requests or suggestions submitted by the product coordinator or users of the product. The request, once approved and asigned by the coordinator, if it wasn't submitted by him, it's located in a release and follow by the assigned person.
In more detail:

As a user, you can:
- Submit new request.
- Consult how many request has a particular product.
- Consult how many releases has been published.
As a coordinator and as an administrator, you can:
- See your pending requests, requests assigned to other developers, and your requests in development.
- Inicialize a request of your own or one assigned to other developers.
- Add a status report to a request..
- End a request.
As a coordinator and as administrator, you can:
- Aprove or reject a request.
- Assign a request.
- Have the data for all the releases of the product, details of the request, status stage, person in charge, etc.
- Change request from one release to other, publish releases, delete them or charge order.

^ top

System Requirements

PHP 4 (PHP 5 not yet tested)
Database: MySQL
PHP must be compiled with MySQL packet (which is the default setting when installing PHP). See www.php.net for more information.
Browser that support:

JavaScript.
CSS.
Cookies.

^ top

File Unpacking

Unpacking REVER in its own directory, somewhere where your web server will find it. (See your web server docs for infomation).
By default, REVER should create its own directory when you unpack it. The new directory name will contain the version name (rever-0.6.5). You can rename this directory after unpacking the files if you prefer another name for the directory.

^ top

Database

We will create the Database from command line. To do this, you have to follow this steps:

Create the database. The following command will create a database called "versiones".
```
mysqladmin -u root create versiones
```
Create the tables using the script db_rever.sql, that will be copied in server. Command to execute this script:
```
mysql versiones < db_rever.sql
```

^ top

Database Access Configuration

include directory. You will need to modify modify the file func.php, located in the includes. You will have to fill in the values of the beginning of the file.
The following show that part of the file:

$const_ODBC = "versiones"; $const_host = "localhost"; $const_port = "3306"; $const_user = "root"; $const_pass = ""; $const_serverURL = "http://xxxx.xxxxx";

and you must to complete with values:

$const_ODBC =	"versiones" Or the name you have chosen for the database.
$const_host =	Hostname o IP where is istalled the database. (Use localhost if it's the same machine of the web server).
$const_port =	"3306" Port that is configured in MySQL, by default is 3306.
$const_user =	"root" Or the name you have chosen for the user.
$const_pass =	" " If you put a password to login to the database, you will need to fill up this field.
$const_serverURL =	"http://xxxx.xxxxx"

^ top

Create Users

Any user can access to the system home page. At the top of the page, it shows a set of links. To access other pages, you must be logged as a user with the right permissions. To create new users and give them their permissions, you must:

Click in link "Personas" at the top of the page.
Login to REVER as:
user: administrador, password: administrador.
Fill up data about the new user.
Click in button "Agregar".

^ top

Load Data in the System

To obtain the correct functionality of the system, you should keep in mind certain concepts, and load certain data in the tables of database "versiones".

Persons: Persons who are involucrated with products (coordinators, developers, administrators, etc.).
Products Types: Categorization of products.
Products: The hardware or software product.
Group of person: people's group It a forms of containing different people involved with the products. For example, Administrators, project Agents, developers of the product, etc.
Also, these groups are good to assign or non permits access to the products.
Persons in groups: People that are part of the groups mentioned previously.
Groups by products: It indicates each product and the groups of people that can access to those products.
Areas: General and open categorization about different parts in which a product is divided.
Types of requests: Different kind of requests or suggestions that a product can have.
Requests states: The different moments a request goes passing, since it is entered until it is finished.

^ top

License

REVER is distributed under open source license GNU General Public License . In this package you receive a copy of the General GNU Public License.
You can redistribute and/or modify it under the General GNU Public License terms.
If you have questions about this license, please readGPL FAQ .

^ top

Glossary

RoadMap: Map of the versions.
Tracking de requerimientos: Developer planning.

^ top