HDP115

Herramientas de
Productividad

INSTALACION Y CONFIGURACION
DEL SISTEMA DE CONTROL
GESTION DE PROTECTOS,
SISTEMA DE CONTROL DE INCIDENCIAS
Y VERSIONES

2013

Contenido
Introduccin ............................................................................................................................ 3
Objetivos: ............................................................................................................................... 4
Objetivo General ................................................................................................................ 4
Objetivo Especfico ............................................................................................................ 4
TUTORIAL DEBIAN ........................................................................................................ 5
Introduccin a tutorial de Debian: .................................................................................. 6
TUTORIAL TODOYU .................................................................................................... 25
Introduccin a tutorial de Todoyu ................................................................................ 26
Pasos de instalacin .................................................................................................... 27
TUTORIAL MANTIS BUG TRACKER ......................................................................... 41
Introduccin a tutorial Mantis Bug Tracker ................................................................. 42
Pasos de instalacin...................................................................................................... 44
TUTORIAL DE BAZAAR ...................................................................................................... 53
Introduccin a tutorial de bazaar ................................................................................. 54
INSTALACIN ........................................................................................................... 55

Introduccin
En el siguiente trabajo presentamos nuestro trabajo de investigacin sobre los sistemas
Gestin de proyecto, Control de versiones y Gestin de Incidencias, todos estos
desarrollados en Debian, gracias al programa Virtual Box.
Cumpliendo con los requerimientos de la Ctedra el lector, ver manuales de instalacin y
configuracin de los diferentes Sistemas junto con el de Debian.
El Lector ser ilustrado con imgenes alusivas al proceso que se est presentando,
anticipando algunos problemas que el usuario pueda encontrar a la hora de comprobar su
funcionamiento.
Nuestro sistema fue desarrollado en LCOM-4 durante sesiones programadas, para luego
detallarlas en procesadores de texto, en donde, quedara constancia de nuestro trabajo.

Objetivos:
Objetivo General

Permitir al usuario la correcta instalacin de los Sistemas; Gestor de Proyectos, de

Incidencias, Control de Versiones, as como, el Sistema Operativo Deban.

Objetivo Especfico

Investigar sobre la instalacin, configuracin y uso de los diferentes Sistemas.

Dar a conocer la forma correcta de instalacin del Sistema Operativo Debian.

Explicar de manera clara el proceso de instalacin del Sistema Gestor de proyectos

Todoyu.

Dar a conocer de forma precisa la instalacin del Sistema control de Incidencias

Mantis Bug tracker.

Mostrar al usuario el uso e instalacin del sistema control de versiones Bazaar.

Mostrar de manera grfica el proceso de instalacin de los sistemas.

TUTORIAL DEBIAN

Introduccin a tutorial de Debian:

Este documento contiene las instrucciones de instalacin del sistema Operativo Debian
versin 7.0 (Wheezy) de la plataforma Linux, el cual ser instalado bajo el sistema de
virtualizacin Oracle VirtualBox.

Debian 7.0 es compatible con dos arquitecturas:

-Basada en Intel x86 kfreebsd-i386
- e Intel 64 kfreebsd-amd64

Este documento cubre la instalacin para la arquitectura 32-bit PC usando el ncleo Linux.
Debian es una comunidad conformada por desarrolladores y usuarios, que mantiene un
sistema operativo GNU basado en software libre. El sistema se encuentra precompilado,
empaquetado y en un formato deb para mltiples arquitecturas de computador y para
varios ncleos.

El instalador de Debian est compuesto por un conjunto de componentes de propsito

especfico para realizar cada tarea de la instalacin. Cada componente realiza una tarea,
formulando al usuario las preguntas que sean necesarias para realizar su trabajo.

Se realiza un proceso de instalacin altamente automatizado y con poca interaccin del

usuario. Los componentes son ejecutados automticamente en una secuencia
predeterminada.

El instalador usar los valores predeterminados para las preguntas que no son formuladas.
Cuando exista un problema, el usuario ver el error en pantalla, y es posible que se
muestre el men del instalador para que elija de ste alguna accin alternativa.

A continuacin se muestra de manera grafica los pasos del proceso de instalacin de

Debian.

INSTALACION

Para comenzar a instalar el Sistema Operativo Debian, debemos primero crear una nueva
mquina virtual, para esto debemos entrar a VirtualBox y elegir la opcin Nueva.

Seguimos los pasos eligiendo los datos de la nueva mquina virtual que vamos a crear:
-el nombre de la maquina virtual
-el sistema operativo a utilizar: en este caso Linux
-el tipo de distribucin de Linux: Debian

Ahora elegimos la cantidad de memoria RAM a utilizar, esto depender de cuanta

memoria dispongamos en nuestro sistema, en este caso le asignaremos 1GB.

Creamos un Disco Duro Virtual que es donde se guardaran todos los archivos de
instalacin

Para crear el disco duro fsico elegimos la opcin de Tamao Fijo, pero para ahorrar
espacio en el disco duro de la mquina anfitrin, se recomienda seleccionar la opcin
Reservado dinmicamente.

Podemos elegir donde guardar y el tamao mximo que ocupa la imagen

Esperamos mientras se crea la unidad de disco duro

Ahora debemos crear la imagen de Debian en la mquina Virtual. Para ello debemos elegir
Iniciar.

Debemos buscar la carpeta donde se encuentra la imagen del DVD o CD de Debian.

Ahora Iniciamos la Maquina y comienza la instalacin de Debian. Podemos elegir la opcin

grafica que nos guiara paso a paso.

Elegimos el idioma para instalar Debian, en nuestro caso Spanish - Espaol

Elegimos la ubicacin: El Salvador, y la configuracin del teclado a Latinoamericano.

El sistema comienza a cargar los componentes necesarios para la instalacin.

Escribimos el nombre que queremos darle a la mquina para que se identifique en el

sistema de red.

Escribimos la clave para el superusuario (Administrador)

Ahora elegimos el nombre de la persona o grupo que usara la Maquina

Elegimos la contrasea

Elegimos el particionado de discos de forma manual

Ahora crearemos las particiones, elegimos la opcin Crear una particin nueva, para crear
la particin Raz.

Elegimos el tamao de las particiones Raz, en nuestro caso 20 GB.

Elegimos para esta particin que sea de tipo Primaria.

Elegimos que la particin se cree al principio del espacio disponible

Ya creada la particin raz podemos ver el espacio disponible para crear nuevas
particiones.

Creamos la particin Home

Le asignamos 10 GB de espacio.

Esta particin ser de Tipo Lgica.

Y se creara al principio del espacio disponible

Ahora creamos la particin Swap.

Le asignamos un espacio de 4.4 GB

Elegimos usar esta particin como rea de intercambio

Ahora podemos ver un resumen de las particiones realizadas

Finalizamos el proceso de particionado de discos, elegir guardar los cambios en el disco.

Esperamos mientras se realiza el particionado de los discos. Luego se instalara el sistema

base. Luego de unos minutos nos informara que la instalacin ha sido terminada

Inicie por primera vez el sistema que acaba de instalar, escribimos nuestra clave y
contrasea para iniciar.

Luego de iniciar sesin ya estamos en el escritorio de Debian para poder trabajar con l.

TUTORIAL TODOYU

Introduccin a tutorial de Todoyu

Un proyecto es el proceso de planear, organizar y administrar tareas y recursos para
alcanzar un objetivo concreto, generalmente con limitaciones de tiempo, recursos o costo.
Por esto mismo necesitamos un software que nos ayude a poder manejar esta
informacin y organizarla de manera fcil para los usuarios.
Ahora tenemos a nuestra disposicin muchas herramientas que nos permitirn realizar
todas estas actividades de manera ms fcil. En este documento mostraremos los pasos
necesarios para realizar la instalacin y el manejo de Todoyu en el Sistema Operativo
Linux distribucin Debian 7.0.
Todoyu es una aplicacin web de negocio para la planificacin, el seguimiento de su
progreso y para la comunicacin con los miembros del equipo. Definir plazos, asignar
tareas y comunicarse con su equipo y clientes del proyecto hasta que se realicen los
proyectos.
Adems permite administrar sus recursos y carga de trabajo de los proyectos teniendo en
cuenta todos los aspectos importantes, como las vacaciones, el empleo a tiempo parcial,
la carga de trabajo interno, etc.
Otro aspecto importante es la creacin de informes de gran alcance sobre la base de sus
proyectos, el tiempo de seguimiento, las facturas, los tipos de trabajo y muchos ms.
Todos los clculos se hacen en tiempo real.
Por ltimo pero no menos importante es que permite que podamos trabajar con nuestro
equipo, clientes y socios outsourcing todos juntos en un formato fcil de usar en la
aplicacin web. Asignar tareas a los miembros del equipo, agregar comentarios, dar
retroalimentacin y compartir documentos.

Pasos de instalacin
PASO 1
Descarga
Para esto ser necesario ir a la siguiente direccin
http://sourceforge.net/projects/todoyu/files/. Al ingresar a este sitio web encontraremos una
pgina como la siguiente:

A continuacin seleccionamos Download Todoyu 2.3 y ya tendremos el archivo .zip en la

carpeta de descargas.

Debemos tener en cuenta que antes de proceder a la instalacin de Todoyu debemos

tener instalado un servidor de base de datos, en nuestro caso, utilizaremos Xampp for
Linux, que es un servidor independiente de la plataforma, que consiste principalmente en
la base de datos MySQL. Por tanto a continuacin veremos brevemente los pasos para la
instalacin de Xampp en Linux distribucin Debian 7.0.
El primer paso es la descarga de la versin de Xampp de nuestra eleccin, en este caso
descargaremos las versin Xampp-linux-1.7.7. Un link de descarga puede ser el siguiente:
http://sourceforge.net/projects/xampp/files/XAMPP%20Linux/1.7.7/xampp-linux1.7.7.tar.gz/download

Ahora que ya hemos esperado que nuestro archivo se descargue abrimos una Terminal en
Debian, a continuacin se muestran los pasos a seguir:
1.- Asegurarnos que estemos como root (Superusuario). Para esto escribiremos el
comando su en la Terminal y luego escribimos la contrasea de superusuario que
asignamos a la hora de instalar Debian.
2.- Descomprimir en el directorio /opt con el comando mostrado a continuacin:

Nota: Si lo tenemos en otra carpeta debemos ubicarnos en dicha carpeta con el

comando cd
3.- Dar permiso al directorio opt/lampp/htdocs ya que aqu es donde se almacenan los
archivos de las pginas webs.

4.- Crear un enlace simblico entre el directorio y una ubicacin en nuestra carpeta
personal, por ejemplo: /home/usuario/Webs, y de esta forma tener nuestros proyectos en
la carpeta personal.

5.- Ya est listo! Ahora inicializamos Xampp

6.- Si hemos hecho todo correctamente al ejecutar el comando anterior obtendremos la

siguiente respuesta del sistema

7.- Slo queda comprobar que corre como debe hacerlo. Abrimos nuestro navegador y en
la barra de direcciones escribimos: http://localhost/xampp

Ahora debemos seleccionar el idioma y veremos la pantalla de bienvenida de Xampp lo

que nos indica que nuestra instalacin ha sido CORRECTA.

PASO 2
Continuando con la instalacin de Todoyu. Ahora contamos con la carpeta Webs (creada
cuando instalamos Xampp).
1.- Descomprimir el archivo Todoyu_3-2-9.zip
2.- Renombrar la carpeta que hemos descomprimido y ponerle por nombre todoyu
3.- Guardar en la carpeta Webs

4.- Ahora damos los permisos correspondientes a la carpeta todoyu. Podemos hacerlo
desde la Terminal, pero en esta ocasin lo haremos dando click derecho sobre la carpeta,
en el men Properties (Propiedades) y en la pestaa Permissions (Permisos)

Paso 3
Ahora que ya tenemos la carpeta en la ubicacin correcta y con los permisos que
necesitamos iniciamos con la instalacin de la aplicacin, abriendo el navegador y
escribiendo en la barra de direccin lo siguiente: http://localhost/todoyu.

1.- Esta pantalla nos permitir

seleccionar el idioma en que vamos a
instalar nuestra aplicacin.

2.- Aceptar la licencia de uso de la aplicacin.

3.- Esta pantalla nos permitir

verificar los permisos de nuestra
aplicacin, si hemos hecho
correctamente
los pasos
anteriores
debera
aparecer
en cada uno de los
servicios, tal como se muestra a
continuacin.

4.- El siguiente paso de la instalacin es la conexin de la base de datos, aqu es donde

nosotros colocamos el nombre del servidor (en este caso localhost ya que no estamos
utilizando un servidor externo), usuario y contrasea. Es importante que tomemos en
cuenta que estos datos son de suma importancia cuando nosotros queremos acceder a la
base de datos por lo tanto tengamos presente siempre los datos asignados.

5.- Seleccionamos la base de datos en la cual vamos a trabajar en nuestro proyecto,

recordemos que al instalar xampp tenemos acceso a la creacin de Bases de Datos en
MySQL si no lo hicimos con anterioridad Todoyu nos da la opcin de crear una nueva Base
de Datos.

6.- A continuacin se nos muestra una pantalla que nos permitir importar las tablas de la
Base de Datos, lo que nos asegura que los cambios que hagamos en Todoyu
automticamente sern reflejados en la Base de Datos que hayamos elegido o creado en
el paso anterior.

7.- Configuracin bsica para nuestro sistema

8.- En este paso ingresamos los datos de la cuenta que tendr los permisos de
administrador en nuestro proyecto.

9.- Si nuestra instalacin

se
ha
hecho
correctamente podremos
visualizar una ventana
donde se nos muestra un
mensaje de xito en la
instalacin.
Y
ahora
podremos trabajar en
Todoyu y administrar
nuestros proyectos con
un sistema web.

10.- Ahora ya
tendremos
la
opcin
de
ingresar a la
aplicacin con el
usuario
y
contrasea que
registramos en
la ventana de
configuracin de
administrador.

11. Finalmente tenemos Todoyu debidamente configurado e instalado, y ahora podemos

disfrutar de una aplicacin que nos permitir manejar y almacenar informacin de
nuestros proyectos de manera fcil y segura.

A manera de ejemplo crearemos un

nuevo proyecto llamado HDP-115
utilizando una base de datos ya creada en
MySQL. Para esto damos click en New
Project, agregamos la informacin en los
campos correspondientes y damos click
en Guardar.

Para agregar una nueva tarea al

proyecto creado iremos al men y
daremos click en New Task, agregamos
la informacin en los campos
requeridos y damos click en Guardar.

Ahora ya tenemos creado nuestro proyecto y podemos observar los cambios realizados en
cuanto a nuevas tareas y sus caractersticas en la siguiente pantalla.

TUTORIAL MANTIS
BUG TRACKER

Introduccin a tutorial Mantis Bug Tracker

En el siguiente tutorial, el lector podr aclarar sus dudas con respecto al uso de este sistema
gestor de incidencias.
Para realizar el tutorial se utiliz el Sistema Operativo de la plataforma Linux: Debian,
versin 7.0 (Wheezy) instalado en una mquina virtual bajo el sistema de virtualizacin
Oracle VirtualBox.
Este Sistema Gestor de Incidencias, es un software que constituye una solucin muy
completa para gestionar las incidencias de un proyecto en un equipo de trabajo. Es una
aplicacin OpenSource escrita en php y mysql, que destaca por su facilidad y flexibilidad
de instalar y configurar. Esta aplicacin se utiliza para monitorear soluciones, hacer un
registro histrico de alteraciones y gestionar equipos remotamente.
El software permite la creacin de diversas cuentas de usuario desde las cuales se pueden
informar de los bugs o incidencias detectadas. Con Mantis Bug Tracker se pueden crear
proyectos en varias categoras, lo cual permite hacer un seguimiento ms exacto de ste. El
flujo de trabajo tambin se puede configurar desde la propia herramienta, de forma que
puede definirse quin puede informar incidencias, quin puede analizarlas y quin puede
atenderlas o resolverlas.
Caractersticas: Una de las caractersticas de Mantis Bug Tracker es su gran abanico de
posibilidades para su configuracin, nombradas a continuacin:
Puede especificar un nmero indeterminado de estados para cada incidencia
(nueva, se necesitan ms datos, aceptada, confirmada, resuelta, cerrada).
Permite configurar la transicin de estados (abierta, encaminada, testeada,
devuelta, cerrada, reabierta).
Permite introducir diferentes perfiles de usuario (administrador, espectador,
informador, actualizador, desarrollador, manager, etc).
Mantis incluye filtros, un sistema de bsqueda, tiene soporte para varios idiomas y
tambin informa por e-mail de la resolucin de los errores de los que se ha
informado.
Las finalidades de esta aplicacin son las siguientes:
Agilizar el proceso de atencin al cliente en las reas de Servicios Informticos,
Redes y cableado telefnico.
Eliminar el uso de papel en cuanto a la recepcin de solicitudes de servicio
corresponde.
Permitir tener un mayor control sobre el tiempo que los tcnicos abarcan en una
orden de servicio.
Optimizar el tiempo de los tcnicos, permitindoles observar sus tareas desde
cualquier lugar.
Proporcionar al usuario la facilidad de observar en qu etapa del proceso se
encuentra el servicio solicitado.
Disminuir las entradas de solicitudes por lnea telefnica.

Mantis Bug Tracker tiene software y requisitos de hardware modestos. Se requiere un

equipo que sea capaz de ejecutar el software de un servidor. Todo el software necesario es
libre o para uso no comercial. El servidor pblico puede ser un servidor web compartido o
co-ubicados en un servidor dedicado. El espacio en disco necesario depende del tamao de
la base de datos, sin embargo, normalmente es manejado por el tamao y nmero de
archivos adjuntos.
Requisitos
Versin
Paquete
Probado con
minima
MySQL

4.1x

5.0.x, 6.0.x

PostgreSQL
(experimental)

7.0

8.0

PHP

5.1.2

5.2x

Servidor web

Apache 1.3.x, Apache 2.2.x, 1.4.x lighttpd, IIS

6.0

Sistema operativo: Windows, Mac OS, OS / 2, Linux, Solaris, BSD.

Pasos de instalacin

A continuacin se presenta de manera grfica, el proceso de instalacin para descargar,

instalar y configurar Mantis Bug Tracker en nuestro Sistema Operativo Debian.
Cabe aclarar que previamente debe estar configurado el servidor de base de datos y
aplicaciones, si no ha realizado este proceso deber hacer los siguientes pasos:
1- Configurar el servidor de base de datos, accesando a su configuracin desde su
navegador, entrando a la direccin http://localhost/phpmyadmin.
2- Una vez dentro deber dirigirse a la seccin de privilegios y ah ubique el
superusuario (root@localhost) de la base de datos para asignarle una contrasea.
3- Luego, en la carpeta contenedora de Mantis Bug Tracker, buscaremos el archivo
config.inc.php (debe abrirse con privilegios de root en algn editor) y
buscaremos la siguiente lnea: $g_db_password = '';
4- Escriba la contrasea entre las comillas simples. Deberemos indicarle al sistema la
misma contrasea que hemos asignado anteriormente desde la configuracin de
phpmyadmin.

Descarga:
Primero debemos descargar la ltima versin, o alguna que estemos buscando en el
siguiente enlace al sitio oficial http://www.mantisbt.org/, al ingresar tenemos una interfaz
como
esta:

Seleccionaremos Download

Descargaremos la versin actualizada, MantisBT 1.2.15

Luego nos redirige al sitio SourceForge, que es donde se aloja el software, esperamos que
la descarga se complete y estaremos listos para la instalacin.

Instalacin:
Para la instalacin seguiremos estos pasos:
Descomprimimos el archivo que hemos descargado, lo renombramos a mantisbt, le
aplicamos permisos de acceso (lectura y escritura) y lo colocamos en la carpeta del
servidor, en nuestro caso, hemos usado un paquete llamado Xampp, el cual genera una
carpeta llamada htdocs, y es ah donde alojaremos las aplicaciones web que vayamos a
utilizar.
Entraremos a http://localhost/mantisbt, y accederemos a la instalacin de Mantis Bug
Tracker:

Llenamos los campos con la informacin de la base de datos, y hacemos clic en el botn
Install/Upgrade Database. En este momento se comenzar a crear la base de datos para
mantis, este proceso puede tardar unos minutos dependiendo de la velocidad del equipo
en el que se est instalando.
Si todo est en orden, se habr instalado exitosamente el sistema y mostrar un listado de
acciones con la leyenda GOOD, indicando que todo se instal correctamente, luego
podemos dar clic al botn create, para iniciar sesin y crear un nuevo proyecto.

En la pantalla de inicio de sesin se observan dos advertencias:

La primera advertencia nos aconseja deshabilitar la cuenta por defecto administrator o al

menos, cambiar su contrasea, mientras que la segunda advertencia se refiere a eliminar
el directorio admin, porque slo se utiliza para entrar al sistema por primera vez.
Para corregir estas advertencias simplemente hacemos lo siguiente: Iniciamos sesin en
Mantis, luego nos dirigimos a la seccin My Account y le cambiamos la contrasea al
usuario administrator.

Llenamos los campos de contrasea, confirmar contrasea, email y un nombre real

(Aunque este es opcional) de la siguiente forma:

Por ltimo, hacemos clic en el botn Update User y nos dar un mensaje de operacin
exitosa. Luego de esto, el sistema solicita iniciar sesin de nuevo.

Para la segunda advertencia, simplemente debemos eliminar el directorio admin, ubicado

en la carpeta de Mantis Bug Tracker.
Ahora se puede iniciar sesin con el usuario y la nueva contrasea que se acaba de
asignar.
Al acceder a la cuenta nos mostrar la pgina principal de Mantis:

Luego de esto podemos agregar un nuevo proyecto, nos dirigimos a Manage

(Administracin) y luego Administrar proyecto, y hacemos clic en el botn para crear un
nuevo proyecto. Llenamos los campos respectivos y elegimos Agregar Proyecto.

Tambin podemos Administrar un proyecto, elegimos la opcin de la vieta Administrar proyecto.

Para reportar una incidencia llenamos los campos del siguiente formulario

Luego de reportar la incidencia, aparecer en el listado de incidencias registradas en Mantis, las

cuales sern monitoreadas por los usuarios que formarn parte del proyecto.

Tambin podemos administrar a dichos usuarios desde la ventana de Administracin. En

la imagen se muestra el formulario para editar la configuracin del usuario administrador,
aqu podemos cambiar la contrasea del mismo, el nombre real, correo electrnico, etc.

TUTORIAL DE BAZAAR

Introduccin a tutorial de bazaar

Bazaar es un sistema de control de versiones distribuido patrocinado por Canonical Ltd., diseado
para facilitar la contribucin en proyectos de software libre y opensource.
Bazaar puede ser usado por un usuario nico trabajando en mltiples ramas de un contenido local,
o por un equipo colaborando a travs de la red.
Bazaar est escrito en lenguaje de programacin Python y tiene versiones empaquetadas para la
mayora de distribuciones GNU/Linux, as como Mac OS X y MS Windows. Bazaar es software libre
y parte del proyecto GNU.
Los comandos de Bazaar son bastante similares a los encontrados en otros sistemas de control de
versiones como CVS o Subversion. Un nuevo proyecto puede ser iniciado y mantenido sin un
servidor remoto de repositorios invocando el comando bzr init en un directorio donde una
persona desea versionar.
En contraste con sistemas de control de versiones puramente distribuidos que no usan un servidor
central, Bazaar soporta trabajar con o sin un servidor central. Es posible usar ambos mtodos al
mismo tiempo con el mismo proyecto. Los sitios web LaunchPad y Sourceforge proveen servicio
gratuito de almacenamiento para proyectos administrados con Bazaar.
Bazaar tiene soporte para trabajar con algn otro sistema de control de versiones. Esto permite a
los usuarios hacer ramas desde otro sistema (por ejemplo Subversion), hacer cambios locales y
confirmarlos en una rama de Bazaar, y luego volver a unirlos en el otro sistema. El acceso de slo
lectura tambin est disponible para Git y Mercurial. Bazaar tambin permite la interoperacin
con muchos otros sistemas (incluyendo CVS, Darcs, Git, Perforce, Mercurial) permitiendo
importar/exportar historiales.
Bazaar soporta archivos con nombres del juego completo de caracteres Unicode. Esto tambin
permite confirmar mensajes, confirmas nombres, etc.
En el presente tutorial, el usuario conocer los pasos necesarios para la instalacin, configuracin,
uso e integracin de Bazaar dentro del sistema operativo Debian 7.0.

INSTALACIN
Bazaar generalmente viene incluido en los sistemas GNU/Linux en los paquetes por
defecto, pero para realizar la descarga puede realizar los siguientes pasos:
-

Instalacin desde terminal:

Para instalar Bazaar desde la lnea de comandos, deber abrir una terminal en Debian,
luego ejecute el comando su para utilizar la terminal como un superusuario, y
posteriormente ejecute apt-get install bzr.

Descarga e instalacin desde el sitio web:

Ingrese al sitio oficial de Bazaar http://wiki.bazaar.canonical.com/Download luego deber
seleccionar su plataforma de sistema operativo, y dependiendo de ste siga las
instrucciones.

Para un uso ms cmodo, puede descargar tambin la aplicacin Bazaar Explorer, que es un
GUI desde el cual se pueden realizar todas las operaciones del sistema de control de
versiones.
El
sitio
para
la
descarga
de
Bazaar
Explorer
es
el
siguiente:
http://doc.bazaar.canonical.com/explorer/en/
Ah selecciona el botn Download it now! y en la pgina que se muestra descargue el
archivo correspondiente (archivo .tar.gz)

Luego descomprima el archivo descargado y copielo en la carpeta de instalacin de Bazaar.

Una forma ms sencilla de instalar los componentes necesarios para la utilizacin de
Bazaar es mediante un gestor de paquetes. Los siguiente pasos indican cmo realizar la
instalacin de Bazaar y Bazaar Explorer utilizando Synaptic.

Primero deber ejecutar el gestor de paquetes, y cuando el sistema lo solicite ingrese la

contrasea de administrador del equipo.

Luego aparecer la ventana principal del gestor de paquetes Synaptic, y en el campo Filtro
rpido, ingrese la palabra bazaar para que filtre las aplicaciones disponibles relacionadas
a bazaar.

Dentro de esa ventana, ubique el paquete bzr, para instalar el sistema general, y
adicionalmente ubique el paquete bzr-explorer para instalar el GUI de Bazaar. Al
seleccionar un paquete para ser instalado, automticamente seleccionar las dependencias
necesarias para llevar a cabo la instalacin. Luego de haber seleccionado los elementos a
instalar, pulse el botn Aplicar ubicado en la parte superior de la ventana, y con esto se dar
inicio al proceso de instalacin.

USO DE BAZAAR
Bazaar es un sistema de control de versiones que puede usarse mediante la lnea de
comandos, o por un cliente GUI, llamado Bazaar Explorer. En este tutorial indicaremos
ambas formas de uso, pero nos centraremos en el uso de Bazaar Explorer. Luego se darn
las instrucciones para poder integrar Bazaar a un IDE de desarrollo, en nuestro caso
usaremos Eclipse.
Primeros pasos en Bazaar.
Una de las primeras cosas que hay que hacer en Bazaar, es configurar el usuario. Bazaar
utiliza el nombre y correo electrnico para identificar a un usuario. Esto es relativamente

necesario para saber qu usuario hizo alguna modificacin a un archivo. Para indicarle a
Bazaar quien es el usuario actual, hacer lo siguiente:
1. Abrir una terminal en Debian.
2. Ejecutar el siguiente comando:
bzr whoami "Alex Contreras <alexcontreras@outlook.com>"

Para consultar el usuario que tiene guardada la configuracin de bazaar, ejecutamos el

siguiente comando:
bzr whoami
Con lo que generar la siguiente salida:
"Alex Contreras <alexcontreras@outlook.com>"

Creando un nuevo proyecto

Para crear un nuevo proyecto en bazaar, realice lo siguiente:
1. Cree una nueva carpeta en donde se guardar todo el trabajo del proyecto.
2. En la terminal, dirjase a la carpeta que ha creado usando el comando cd.
3. Ingrese el siguiente comando:
bzr init-repo proyecto
4. Bazaar generar la siguiente salida:
Shared repository with trees (format: 2a)
Location:
shared repository: proyecto
5. Luego ejecute lo siguiente:
bzr init proyecto/trunk
6. Bazaar generar una salida indicando que se ha creado la rama respectiva para iniciar el
control de versiones.

Agregando archivos al proyecto

Luego de haber creado el trunk para bazaar, es momento de agregar archivos al proyecto.
Dirjase a la carpeta del proyecto y cree un archivo, como ejemplo crearemos un archivo de
texto plano en algn editor como Gedit, que llamaremos test.txt y luego indicaremos a
bazaar que estamos agregando dicho archivo.
Para indicarle a bazaar que queremos agregar un nuevo archivo, utilizamos el siguiente
comando:
bzr add test.txt
Luego de agregar el archivo, realizamos un commit que es la confirmacin para que
bazaar rastree los cambios en dicho archivo:
bzr commit m Agregada primera lnea de texto.
Ahora modifique el archivo test.txt en su editor favorito y guarde dichos cambios.
Luego ejecute los comandos add y commit, mencionados anteriormente para actualizar el
archivo dentro de bazaar.

USANDO BAZAAR EXPLORER

Una forma intuitiva para usar el sistema de control de versiones Bazaar, es mediante el uso
del plugin Bazaar Explorer, el cual facilita el uso del sistema.
La interfaz de Bazaar Explorer es como se muestra en la siguiente figura:

Desde esta ventana podemos hacer todas las operaciones principales del sistema de control
de versiones.

CREAR UN NUEVO PROYECTO

Para crear un nuevo proyecto, pulse el botn Iniciar un nuevo proyecto y luego pulse el
botn Inicializar:

Luego, en la ventana que aparecer, le indicaremos al sistema cual es la carpeta donde se

encuentran los archivos de nuestro proyecto.

Luego hacemos clic en el botn Aceptar y el sistema agregar la carpeta al control de

Bazaar.
Si existen archivos que no son versionados, aparecern en la pantalla. En nuestro caso, el
archivo de prueba test.txt an no est bajo el control de Bazaar, y el sistema nos muestra el
aviso:

Para solucionar esto, basta simplemente con utilizar el comando add, pero en Bazaar
Explorer, nicamente deberemos pulsar sobre el botn Aadir, con lo que el archivo no
versionado ser agregado a Bazaar.

En la ventana aparecen los archivos no versionados. Seleccionamos el que deseemos

versionar con Bazaar y presionamos el botn Aceptar. Luego de esto, el sistema nos indica
que existen diferencias entre los archivos versionados, y para solventar esta situacin es
necesario realizar un commit para confirmar los cambios.

Para ver las diferencias entre la instantnea del archivo en Bazaar, y el archivo original, se
utiliza el comendo diff, en Bazaar Explorer, utilizamos el botn Comparar.

En esta ventana podemos observar ambas versiones, la versin anterior y la nueva versin
del archivo test.txt. El siguiente paso es confirmar los cambios realizados mediante un
commit. En Bazaar Explorer lo hacemos usando el botn Confirmar.

Esta es la ventana de commit, en la

cual se nos muestra la direccin de la
rama del proyecto, y nos da un campo
para agregar un mensaje, as como
otras opciones. Ms abajo se muestra
el archivo que est siendo actualizado.
Para confirmar el commit, hacemos
clic en el botn aceptar.

Si todo sali bien, Bazaar actualizar

la rama del proyecto a la ltima
versin y nos dar el siguiente
mensaje en la ventana principal:

Bsicamente, es todo lo que se necesita saber para utilizar el sistema de control de

versiones Bazaar. Resumiendo los pasos de uso, podemos enumerarlos como sigue:
1.
2.
3.
4.
5.

Inicializar la rama del proyecto.

Aadir archivos para ser versionados.
Realizar cambios en los archivos.
Observar las diferencias entre las versiones de los archivos.
Confirmar los cambios y generar una nueva versin.

En la siguiente seccin, mostraremos los pasos a seguir para la integracin de Bazaar al

IDE de desarrollo Eclipse.
INTEGRACIN DE BAZAAR A ECLIPSE
Para integrar el sistema de control de versiones a nuestro IDE de desarrollo, debe realizarse
lo siguiente:
1. Instale el plugin llamado bzr-xmloutput, mediante el gestor de paquetes de su
preferencia.
2. Inicie el IDE.
3. En el men Help, seleccionar la opcin Install new software

4. Aparecer la siguiente ventana (puede variar dependiendo de la versin de Eclipse a

utilizar):

En el campo work with indicaremos al programa en dnde se encuentra el plugin de

Bazaar para Eclipse. Haga clic en el botn Add para agregar un nuevo repositorio. La
direccin del repositorio donde se ubica dicho plugin es la siguiente:
http://verterok.com.ar/bzr-eclipse/update-site/

Luego de esto, aparecern los plugins disponibles para su instalacin. Seleccionamos el

ms reciente y hacemos clic en next.

El software comenzar a instalarse y luego de reiniciar Eclipse, podremos comenzar la

configuracin del plugin.
Para configurar el plugin de bazaar para Eclipse, simplemente deberemos indicarle dnde
se encuentra el ejecutable de bazaar, y dnde se encuentra el directorio de plugins, adems
de la informacin del usuario. Esta configuracin la podemos acceder desde el siguiente
men:
Window->Preferences->Team->Bazaar
En esta imagen podemos observar los valores de la configuracin del plugin:

Tambin se puede configurar el comportamiento del plugin, como por ejemplo los colores
de la consola entre otros ajustes.
Luego de haber configurado correctamente el plugin, presionamos OK y estaremos listos
para usar Bazaar dentro de Eclipse.

PRUEBAS DE BAZAAR DESDE ECLIPSE

Para realizar las pruebas desde el entorno IDE Eclipse, utilizaremos un proyecto de Java,
con algunas clases de prueba.
El proyecto que utilizaremos, as como sus componentes se pueden observar en la siguiente
imagen:

Para agregar el proyecto completo a Bazaar, hacemos clic derecho sobre la carpeta
principal del proyecto, nos dirigimos a la opcin Team y luego Share Project:

Luego aparecer una ventana en donde indicaremos a Eclipse que queremos compartir el
proyecto a Bazaar, y lo seleccionamos:

Pulsamos Next y luego Finish y el proyecto habr sido agregado a Bazaar. Luego de esto
debemos agregar los archivos del proyecto al repositorio de bazaar para rastrear los
respectivos cambios.
En esta prueba, agregaremos la clase Principal.java de la siguiente manera:

Hacemos clic derecho sobre la clase y nos dirigimos a la opcin Team y luego la opcin
Add:

Luego de agregar el archivo, hacemos el respectivo commit para actualizar la nueva

versin. En este punto, la clase an no contiene instrucciones relevantes. La ventana de
commit es la siguiente:

En esta ventana debemos agregar el

comentario relacionado al commit que
estamos
realizando.
Luego
seleccionamos los archivos que sern
afectados por la nueva versin.
Seleccionamos los archivos a versionar y
pulsamos Ok.

Luego el sistema har el commit y el

rbol de trabajo estar actualizado a su
ltima versin. Para asegurarse que la
rama est actualizada, podemos observar
un cono de color naranja que acompaa
a los archivos de nuestro proyecto en
Eclipse. Este cono cambia con respecto
al estado de actualizacin de la rama.

En la imagen podemos observar que la consola de Eclipse nos dice que se ha confirmado la
revisin 1. Esto quiere decir que hemos actualizado nuestro proyecto a la nueva versin.
Podemos consultar desde el Bazaar Explorer cmo es el estado del proyecto. Para esto
debemos abrir nuestra rama creada en Eclipse en el Bazaar Explorer. Luego nos dir que
existen archivos que no han sido versionados y los agregaremos al control de bazaar.

Podemos agregar estos archivos al proyecto y tambin podemos ignorarlos. En nuestro caso
no haremos nada.
Ahora modificaremos la clase principal y veremos si refleja un cambio en el estado del
proyecto desde Bazaar Explorer.
Agregaremos una lnea de texto que se mostrar en la pantalla al ejecutar la clase.
Guardamos los cambios y nos dirigimos a Bazaar Explorer para ver si refleja dichos
cambios.

Ahora en la ventana de Bazaar Explorer, luego de actualizar la informacin, nos dice que
un archivo ha sido modificado:

Para ver las diferencias entre la versin anterior y la nueva, damos clic en el botn
Comparar y nos muestra la ventana con las diferencias entre las versiones:

En efecto, muestra los cambios recin realizados en la clase principal. En la ventana

podemos ver el nombre del archivo que est siendo monitoreado as como la seccin de
cdigo que ha sido modificada. Para confirmar los cambios, deberemos realizar un commit.
Esta operacin se puede realizar desde el explorer de bazaar, o bien desde el proyecto de
Eclipse. Vamos a realizar el commit desde Eclipse haciendo lo siguiente:
Seleccionamos la clase Principal.java y hacemos clic derecho sobre ella. Elegimos la
opcin Team, y luiego hacemos clic en el botn Commit, y el sistema actualizar la nueva
versin del archivo.

Luego de hacer el commit, volvemos a verificar si lo realiz correctamente desde la

ventana de Bazaar Explorer y nos daremos cuenta que los cambios fueron guardados.
Para ver un registro de cambios, podemos hacer clic en el botn Registro de Bazaar
Explorer, con lo que nos mostrar el historial de revisiones y cambios que hemos realizado
en nuestro proyecto:

En la ventana podemos ver el commit que acabamos de realizar para guardar los cambios
hechos en la clase Principal.java. Para ver explcitamente dichos cambios, hacemos doble
clic en ese componente del registro, es decir, la ltima revisin (2):

De esa manera podemos rastrear los cambios que han sido realizados en los archivos de
nuestro proyecto.