HDP115 Herramientas de Productividad
INSTALACION Y CONFIGURACION DEL SISTEMA DE CONTROL GESTION DE PROTECTOS, SISTEMA DE CONTROL DE INCIDENCIAS Y VERSIONES
2013
Contenido Introducción .................................................... .......................................................................................................... ........................................................................ .................. 3 Objetivos: ............................................................................................................................... 4 Objetivo General ................................................................................................................ 4 Objetivo Específico ............................................................................................................ 4 TUTORIAL DEBIAN ........................................................................................................ ...................................................................................... .................. 5 Introducción a tutorial de Debian: .............................................. .................................................................................. .................................... 6 TUTORIAL TODOYU .................................................................................................... .................................................................. .................................. 25 ................................................................................ .................................. 26 Introducción a tutorial de Todoyu .............................................. .................................................................................................... ..................................................... 27 Pasos de instalación ............................................... TUTORIAL MANTIS BUG TRACKER ................................................ ......................................................................... ......................... 41 Introducción a tutorial Mantis Bug Tracker ................................................................. 42 ...................................................................................................... ..................................................... 44 Pasos de instalación ................................................. TUTORIAL DE BAZAAR ...................................................................................................... 53 Introducción a tutorial de bazaar ................................................................................. 54 INSTALACIÓN ........................................................................................................... ......................................................................... .................................. 55
Introducción En el siguiente trabajo presentamos nuestro trabajo de investigación sobre los sistemas Gestión de proyecto, Control de versiones y Gestión de Incidencias, todos estos desarrollados en Debian, gracias al programa Virtual Box. Cumpliendo con los requerimientos de la Cátedra el lector, verá manuales de instalación y configuración de los diferentes Sistemas junto con el de Debian. El Lector será ilustrado con imágenes 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 instalación de los Sistemas; Gestor de Proyectos, de Incidencias, Control de Versiones, así como, el Sistema Operativo Debían.
Objetivo Específico
Investigar sobre la instalación, configuración y uso de los diferentes Sistemas.
Dar a conocer la forma correcta de instalación del Sistema Operativo Debian.
Explicar de manera clara el proceso de instalación del Sistema Gestor de proyectos Todoyu.
Dar a conocer de forma precisa la instalación del Sistema control de Incidencias Mantis Bug tracker.
Mostrar al usuario el uso e instalación del sistema control de versiones Bazaar.
Mostrar de manera gráfica el proceso de instalación de los sistemas.
TUTORIAL DEBIAN
Introducción a tutorial de Debian:
Este documento contiene las instrucciones de instalación del sistema Operativo Debian versión 7.0 (Wheezy) de la plataforma Linux, el cual será instalado bajo el sistema de virtualización “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 instalación para la arquitectura 32-bit PC usando el núcleo 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 múltiples arquitecturas de computador y para varios núcleos.
El instalador de Debian está compuesto por un conjunto de componentes de propósito específico para realizar cada tarea de la instalación. Cada componente realiza una tarea, formulando al usuario las preguntas que sean necesarias para realizar su trabajo.
Se realiza un proceso de instalación altamente automatizado y con poca interacción del usuario. Los componentes son ejecutados automáticamente 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 acción alternativa.
A continuación se muestra de manera grafica los pasos del proceso de instalación de
Debian.
INSTALACION
Para comenzar a instalar el Sistema Operativo Debian, debemos primero crear una nueva máquina virtual, para esto debemos entrar a VirtualBox y elegir la opción Nueva.
Seguimos los pasos eligiendo los datos de la nueva máquina virtual que vamos a crear: -el nombre de la maquina virtual -el sistema operativo a utilizar: en este caso Linux -el tipo de distribución de Linux: Debian
Ahora elegimos la cantidad de memoria RAM a utili zar, 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 instalación
Para crear el disco duro físico elegimos la opción de Tamaño Fijo, pero para ahorrar espacio en el disco duro de la máquina anfitrión, se recomienda seleccionar la opción “Reservado dinámicamente”.
Podemos elegir donde guardar y el tamaño máximo que ocupa la imagen
Esperamos mientras se crea la unidad de disco duro
Ahora debemos crear la imagen de Debian en l a máquina 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 instalación de Debian. Podemos elegir la opción grafica que nos guiara paso a paso.
Elegimos el idioma para instalar Debian, en nuestro caso Spanish - Español
Elegimos la ubicación: El Salvador, y la configuración del teclado a Latinoamericano.
El sistema comienza a cargar los componentes necesarios para la instalación.
Escribimos el nombre que queremos darle a la máquina 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 contraseña
Elegimos el particionado de discos de forma manual
Ahora crearemos las particiones, elegimos la opción Crear una partición nueva, para crear la partición Raíz.
Elegimos el tamaño de las particiones Raíz, en nuestro caso 20 GB.
Elegimos para esta partición que sea de tipo Primaria.
Elegimos que la partición se cree al principio del espacio disponible
Ya creada la partición raíz podemos ver el espacio disponible para crear nuevas particiones.
Creamos la partición Home
Le asignamos 10 GB de espacio.
Esta partición será de Tipo Lógica.
Y se creara al principio del espacio disponible
Ahora creamos la partición Swap.
Le asignamos un espacio de 4.4 GB
Elegimos usar esta partición 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 instalación ha sido terminada
Inicie por primera vez el sistema que acaba de instalar, escribimos nuestra clave y contraseña para iniciar.
Luego de iniciar sesión ya estamos en el escritorio de Debian para poder trabajar con él.
TUTORIAL TODOYU
Introducción 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 información y organizarla de manera fácil para los usuarios. Ahora tenemos a nuestra disposición muchas herramientas que nos permitirán realizar todas estas actividades de manera más fácil. En este documento mostraremos los pasos necesarios para realizar la instalación y el manejo de Todoyu en el Sistema Operativo
Linux distribución Debian 7.0. Todoyu es una aplicación web de negocio para la planificación, el seguimiento de su progreso y para la comunicación con los miembros del equipo. Definir plazos, asignar tareas y comunicarse con su equipo y clientes del proyecto hasta que se realicen los proyectos. Además 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 creación de informes de gran alcance sobre la base de sus proyectos, el tiempo de seguimiento, las facturas, los tipos de trabajo y muchos más. Todos los cálculos 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 fácil de usar en la aplicación web. Asignar tareas a los miembros del equipo, agregar comentarios, dar retroalimentación y compartir documentos.
Pasos de instalación
PASO 1 Descarga Para esto será necesario ir a la siguiente dirección http://sourceforge.net/projects/todoyu/files/. Al ingresar a este sitio web encontraremos una
página como la siguiente:
A continuación 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 instalación 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 continuación veremos brevemente los pasos para la instalación de Xampp en Linux distribución Debian 7.0. El primer paso es la descarga de la versión de Xampp de nuestra elección, en este caso descargaremos las versión 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 continuación 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 contraseña de superusuario que asignamos a la hora de instalar Debian. 2.- Descomprimir en el directorio /opt con el comando mostrado a continuación:
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 páginas webs.
4.- Crear un enlace simbólico entre el directorio y una ubicación 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.- Sólo 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 instalación ha sido CORRECTA.
PASO 2 Continuando con la instalación 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 ocasión lo haremos dando click derecho sobre la carpeta, en el menú Properties (Propiedades) y en la pestaña Permissions (Permisos)
Paso 3 Ahora que ya tenemos la carpeta en la ubicación correcta y con los permisos que necesitamos iniciamos con la instalación de la aplicación, abriendo el navegador y escribiendo en la barra de dirección lo siguiente: http://localhost/todoyu.
1.-
Esta
pantalla
nos
permitirá
seleccionar el idioma en que vamos a instalar nuestra aplicación.
2.- Aceptar la licencia de uso de la aplicación.
3.- Esta pantalla nos permitirá verificar los permisos de nuestra aplicación,
si
correctamente anteriores aparecer
hemos
hecho
los pasos debería en cada uno de los
servicios, tal como se muestra a continuación.
4.- El siguiente paso de la instalación es la conexión 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 contraseña. 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 creación de Bases de Datos en MySQL si no lo hicimos con anterioridad Todoyu nos da la opción de crear una nueva Base de Datos.
6.- A continuación 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
automáticamente serán reflejados en la Base de Datos que hayamos elegido o creado en el paso anterior.
7.- Configuración básica 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 instalación se
ha
hecho
correctamente podremos visualizar
una
ventana
donde se nos muestra un mensaje de éxito en la instalación. podremos Todoyu
Y
ahora
trabajar y
en
administrar
nuestros proyectos con un sistema web.
10.-
Ahora
ya
tendremos opción ingresar
la de
a
la
aplicación con el usuario
y
contraseña que registramos
en
la ventana de configuración de administrador.
11. Finalmente tenemos Todoyu debidamente configurado e instalado, y ahora podemos disfrutar de una aplicación que nos permitirá manejar y almacenar información de nuestros proyectos de manera fácil 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 información 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
información
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 características en la siguiente pantalla.
TUTORIAL MANTIS BUG TRACKER
Introducción 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ó utilizó el Sistema Operativo de la plataforma plataforma Linux: Debian, versión 7.0 (Wheezy) instalado en una máquina virtual bajo el sistema de virtualización “Oracle VirtualBox”.
Este Sistema Gestor de Incidencias, es un software que constituye una solución muy completa para gestionar las incidencias de un proyecto en un equipo de trabajo. Es una aplicación OpenSource escrita en php y mysql, que destaca por su facilidad y flexibilidad de instalar y configurar. Esta aplicación se utiliza para monitorear soluciones, hacer un registro histórico de alteraciones y gestionar equipos remotamente. El software permite la creación 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 e n varias categorías, lo cual permite hacer un seguimiento más exacto de éste. El flujo de trabajo también se puede configurar desde la propia herramienta, de forma que puede definirse quién puede informar incidencias, quién puede analizarlas y quién puede atenderlas o resolverlas. Características: Una de las características de Mantis Bug Tracker es su gran abanico de posibilidades para su configuración, configurac ión, nombradas a continuación:
Puede especificar un número indeterminado de estados para cada incidencia (nueva, se necesitan más datos, aceptada, confirmada, resuelta, cerrada).
Permite configurar la transición 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 búsqueda, tiene soporte para varios idiomas y también informa por e-mail de la resolución de los errores de los que se ha informado.
Las finalidades de esta aplicación son las siguientes:
Agilizará el proceso de atención al cliente en las áreas de Servicios Informáticos, Redes y cableado telefónico.
Eliminará el uso de papel en cuanto a la recepción de solicitudes de servicio corresponde.
Permitirá tener un mayor control sobre el tiempo que los técnicos abarcan en una orden de servicio.
Optimizará el tiempo de los técnicos, permitiéndoles 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 línea telefónica.
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 público puede ser un servidor web compartido o co-ubicados en un servidor dedicado. El espacio en disco necesario depende del tamaño de la base de datos, sin embargo, normalmente es manejado por el tamaño y número de archivos adjuntos. Requisitos Versión minima
Paquete
MySQL PostgreSQL (experimental) PHP Servidor web
Probado con
4.1x
5.0.x, 6.0.x
7.0
8.0
5.1.2
5.2x 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 instalación
A continuación se presenta de manera gráfica, el proceso de instalación 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 configuración desde su navegador, entrando a la dirección http://localhost/phpmyadmin. 2- Una vez dentro deberá dirigirse a la sección de privilegios y ahí ubique el superusuario (root@localhost) de la base de datos para asignarle una contraseña. 3- Luego, en la carpeta contenedora de Mantis Bug Tracker, buscaremos el archivo “config.inc.php” (debe abrirse con privilegios de root en algún editor) y
buscaremos la siguiente línea:
$g_db_password = '';
4- Escriba la contraseña entre las comillas simples. Deberemos indicarle al sistema la misma contraseña que hemos asignado anteriormente desde la configuración de phpmyadmin.
Descarga: Primero debemos descargar la última versión, 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 versión 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 instalación.
Instalación: Para la instalación 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 instalación de Mantis Bug Tracker:
Llenamos los campos con la información de la base de datos, y hacemos clic en el botón 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 botón create, para iniciar sesión y crear un nuevo proyecto.
En la pantalla de inicio de sesión se observan dos advertencias:
La primera advertencia nos aconseja deshabilitar la cuenta por defecto ‘administrator’ o al
menos, cambiar su contraseña, mientras que la segunda advertencia se refiere a eliminar el directorio admin, porque sólo se utiliza para entrar al sistema por primera vez. Para corregir estas advertencias simplemente hacemos lo siguiente: Iniciamos sesión en Mantis, luego nos dirigimos a la sección My Account y le cambiamos la contraseña al usuario administrator.
Llenamos los campos de contraseña, confirmar contraseña, email y un nombre real (Aunque este es opcional) de la siguiente forma:
Por último, hacemos clic en el botón Update User y nos dará un mensaje de operación exitosa. Luego de esto, el sistema solicita iniciar sesión de nuevo.
Para la segunda advertencia, simplemente debemos eliminar el directorio admin, ubicado en la carpeta de Mantis Bug Tracker. Ahora se puede iniciar sesión con el usuario y la nueva contraseña que se acaba de asignar. Al acceder a la cuenta nos mostrará la página principal de Mantis:
Luego de esto podemos agregar un nuevo proyecto, nos dirigimos a Manage (Administración) y luego Administrar proyecto, y hacemos clic en el botón para crear un nuevo proyecto. Llenamos los campos respectivos y elegimos Agregar Proyecto.
También podemos Administrar un proyecto, elegimos la opción de la viñeta 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 serán monitoreadas por los usuarios que formarán parte del proyecto.
También podemos administrar a dichos usuarios desde la ventana de Administración. En la imagen se muestra el formulario para editar la configuración del usuario administrador, aquí podemos cambiar la contraseña del mismo, el nombre real, correo electrónico, etc.
TUTORIAL DE BAZAAR
Introducción a tutorial de bazaar
Bazaar es un sistema de control de versiones distribuido patrocinado por Canonical Ltd., diseñado para facilitar la contribución en proyectos de software libre y opensource. Bazaar puede ser usado por un usuario único trabajando en múltiples ramas de un contenido local, o por un equipo colaborando a través de la re d. Bazaar está escrito en lenguaje de programación Python y tiene versiones empaquetadas para la mayoría 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 métodos 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 algún 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 sólo lectura también está disponible para Git y Mercurial. Bazaar también permite la interoperación 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 también permite confirmar mensajes, confirmas nombres, etc. En el presente tutorial, el usuario conocerá los pasos necesarios para la instalación, configuración, uso e integración de Bazaar dentro del sistema operativo Debian 7.0.
INSTALACIÓN Bazaar generalmente viene incluido en los sistemas GNU/Linux en los paquetes por defecto, pero para realizar la descarga puede realizar los siguientes pasos: -
Instalación desde terminal: Para instalar Bazaar desde la línea 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 instalación 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 más cómodo, puede descargar también la aplicación 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 botón Download it now! y en la página que se muestra descargue el archivo correspondiente (archivo .tar.gz)
Luego descomprima el archivo descargado y copielo en la carpeta de instalación de Bazaar. Una forma más sencilla de instalar los componentes necesarios para la utilización de Bazaar es mediante un gestor de paquetes. Los siguiente pasos indican cómo realizar la instalación de Bazaar y Bazaar Explorer utilizando Synaptic.
Primero deberá ejecutar el gestor de paquetes, y cuando el sistema lo solicite ingrese la contraseña de administrador del equipo.
Luego aparecerá la ventana principal del gestor de paquetes Synaptic, y en el campo Filtro rápido, 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, automáticamente seleccionará las dependencias necesarias para llevar a cabo la instalación. Luego de haber seleccionado los elementos a instalar, pulse el botón Aplicar ubicado en la parte superior de la ventana, y con esto se dará inicio al proceso de instalación.
USO DE BAZAAR
Bazaar es un sistema de control de versiones que puede usarse mediante la línea 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 darán 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 electrónico para identificar a un usuario. Esto es relativamente
necesario para saber qué usuario hizo alguna modificación 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
"
Para consultar el usuario que tiene guardada la configuración de bazaar, ejecutamos el siguiente comando: bzr whoami
Con lo que generará la siguiente salida: "Alex Contreras "
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, diríjase 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 r ama 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. Diríjase a la carpeta del proyecto y cree un archivo, como ejemplo crearemos un archivo de texto plano en algún 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 confirmación para que bazaar rastree los cambios en dicho archivo: bzr commit –m “Agregada primera línea 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 botón Iniciar un nuevo proyecto y luego pulse el botón “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 botón Aceptar y el sistema agregará la carpeta al control de Bazaar. Si existen archivos que no son versionados, aparecerán en la pantalla. En nuestro caso, el archivo de prueba test.txt aún 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 botón Añadir, 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 botón Aceptar. Luego de esto, el sistema nos indica que existen diferencias entre los archivos versionados, y para solventar esta situación es necesario realizar un “commit” para confirmar los cambios.
Para ver las diferencias entre la instantánea del archivo en Bazaar, y el archivo original, se utiliza el comendo “diff”, en Bazaar Explorer, utilizamos el botón Comparar.
En esta ventana podemos observar ambas versiones, la versión anterior y la nueva versión del archivo test.txt. El siguiente paso es confirmar los cambios realizados mediante un “commit”. En Bazaar Explorer lo hacemos usando el botón “Confirmar”.
Esta es la ventana de commit, en la cual se nos muestra la dirección de la rama del proyecto, y nos da un campo para agregar un mensaje, así como otras opciones. Más abajo se muestra el archivo que está siendo actualizado. Para confirmar el commit, hacemos clic en el botón aceptar.
Si todo salió bien, Bazaar actualizará la rama del proyecto a la última versión y nos dará el siguiente mensaje en la ventana principal:
Básicamente, 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. Inicializar la rama del proyecto. 2. Añadir archivos para ser versionados. 3. Realizar cambios en los archivos. 4. Observar las diferencias entre las versiones de los archivos. 5. Confirmar los cambios y generar una nueva versión.
En la siguiente sección, mostraremos los pasos a seguir para la integración de Bazaar al IDE de desarrollo Eclipse. INTEGRACIÓN 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 opción Install new software…
4. Aparecerá la siguiente ventana (puede variar dependiendo de la ver sión de Eclipse a utilizar):
En el campo “work with” indicaremos al programa en dónde se encuentra el plugin de
Bazaar para Eclipse. Haga clic en el botón Add para agregar un nuevo repositorio. La dirección del repositorio donde se ubica dicho plugin es la siguiente: http://verterok.com.ar/bzr-eclipse/update-site/
Luego de esto, aparecerán los plugins disponibles para su instalación. Seleccionamos el más reciente y hacemos clic en next.
El software comenzará a instalarse y luego de reiniciar Eclipse, podremos comenzar la configuración del plugin. Para configurar el plugin de bazaar para Eclipse, simplemente deberemos indicarle dónde se encuentra el ejecutable de bazaar, y dónde se encuentra el directorio de plugins, además de la información del usuario. Esta configuración la podemos acceder desde el siguiente menú: Window->Preferences->Team->Bazaar
En esta imagen podemos observar los valores de la configuración del plugin:
También 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 opción 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 opción Team y luego la opción Add:
Luego de agregar el archivo, hacemos el respectivo commit para actualizar la nueva versión. En este punto, la clase aún 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 serán afectados por la nueva versión. Seleccionamos los archivos a versionar y pulsamos Ok.
Luego el sistema hará el commit y el árbol de trabajo estará actualizado a su última versión. Para asegurarse que la rama está actualizada, podemos observar un ícono de color naranja que acompaña a los archivos de nuestro proyecto en Eclipse. Este ícono cambia con respecto al estado de actualización de la rama.
En la imagen podemos observar que la consola de Eclipse nos dice que se ha confirmado la revisión 1. Esto quiere decir que hemos actualizado nuestro proyecto a la nueva versión. Podemos consultar desde el Bazaar Explorer cómo 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 también 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 línea 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 información, nos dice que un archivo ha sido modificado:
Para ver las diferencias entre la versión anterior y la nueva, damos clic en el botón Comparar y nos muestra la ventana con las diferencias entre las versiones:
En efecto, muestra los cambios recién realizados en la clase principal. En la ventana podemos ver el nombre del archivo que está siendo monitoreado así como la sección de código que ha sido modificada. Para confirmar los cambios, deberemos realizar un commit. Esta operación 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 opción Team, y luiego hacemos clic en el botón Commit, y el sistema actualizará la nueva versión 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 botón Registro de Bazaar Explorer, con lo que nos mostrará el historial de revisiones y cambios que hemos realizado en nuestro proyecto:
