Sambayón Group

SambayónPlan de Despliegue

Versión 3.0

Sambayón Versión: 3.0Plan de Despliegue Date: 19/05/2008

Historial de RevisionesFecha Versión Descripción Autor

31/03/2008 1.0 Versión inicial Ezequiel González Busquin

15/04/2008 1.1 Puesta en formato Oscar L. Álvarez Imaz

21/04/2008 2.0 Se agregan los detalles de direcciones, descargas y versiones de los elementos a utilizar.

Ezequiel González Busquin

19/05/2008 3.0 Se agregan instrucciones para el build de los prototipos.

A.E.Aguilar

Confidencial Sambayón Group, 2023 Página 2 de 7

Sambayón Versión: 3.0Plan de Despliegue Date: 19/05/2008

Tabla de Contenidos

1. Introducción 4

1.1 Propósito 41.2 Alcance 4

2. Planificación del Despliegue 4

2.1 Responsabilidades 4

3. Recursos 4

3.1 La unidad de despliegue 43.1.1 Software de soporte 4

3.1.1.1 Eclipse 43.1.1.2 NetBeans 53.1.1.3 Plugins 53.1.1.4 Tortoise SVN (Cliente SVN para Windows) 53.1.1.5 Configuración SVN en Assembla 53.1.1.6 Grupo de Google 53.1.1.7 Grupo Assembla (Wiki + Bug tracker) 53.1.1.8 MySQL 5

3.1.2 Documentación de soporte 53.1.3 Personal de soporte 6

4. Entrenamiento 6

5. Configuración de la plataforma de desarrollo 6

Confidencial Sambayón Group, 2023 Página 3 de 7

Sambayón Versión: 3.0Plan de Despliegue Date: 19/05/2008

Plan de Despliegue1.Introducción

El propósito del presente documento es establecer cómo se llevará a cabo la instalación de la solución propuesta en su ámbito de producción final.

1.1Propósito

El software de exámenes del PMI permitirá a quienes deseen obtener una certificación concurrir a un centro habilitado y efectuar el examen en el lugar, haciendo uso de una aplicación propiedad del PMI uniforme para todos los centros.

1.2Alcance

Este documento es de interés para el cliente y para los involucrados en el desarrollo y puesta en producción del producto. Se refiere a la primera puesta en marcha de la solución en determinados centros de evaluación a determinar por el cliente, por única vez.

2.Planificación del DespliegueSe proveerá como producto final un instalador que permitirá hacer funcionar al producto en una PC con determinados sistemas operativos, a definirse. Se harán pruebas antes de la entrega final al cliente en ambientes similares. No habrá entrenamiento alguno, no se considera necesario. Se habilitará un canal de soporte vía correo electrónico para evacuar dudas o reportar problemas que puedan surgir.

2.1Responsabilidades

Es responsabilidad del cliente que los centros de evaluación cuenten con las PCs listas para instalar, con sus correspondientes especificaciones contempladas dentro de las plataformas soportadas por este software. El cliente será quien instalará en esas máquinas el software, no será responsabilidad de la empresa hacerlo.

3.Recursos

3.1La unidad de despliegue

Se brindará un instalador para hacer funcionar al sistema. Incluirá la base de datos (de instalación opcional) donde se almacenarán los datos. El software, una vez instalado, permitirá configurar la ubicación de esta base de datos en caso de querer un centro de evaluación centralizarla o ubicarla en un servidor distinto a la terminal donde se evaluará.

Los usuarios administradores recibirán un manual del usuario donde se indicará cómo se administra el sistema.

3.1.1Software de soporte

Se utilizará los entornos Eclipse y NetBeans, con algunos plug-ins, para desarrollar la solución, haciendo uso del lenguaje de programación Java. Para las interfases gráficas se utilizará Swing. El equipo utilizará un repositorio SVN y un bug tracker en el sitio web Assembla y un grupo Google para comunicación interna. Para acceder al repositorio SVN se utilizán clientes freeware como TortoiseSVN para Windows. La base de datos a utilizar será MySQL.

3.1.1.1Eclipse

Versión: EuropaSitio: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-java-europa-winter-win32.zip

Confidencial Sambayón Group, 2023 Página 4 de 7

Sambayón Versión: 3.0Plan de Despliegue Date: 19/05/2008

3.1.1.2NetBeans

Versión: 6.1Sitio: http://download.netbeans.org/netbeans/6.1/final/ Nota: debe descargarse e instalarse la opción identificada como “All”.

3.1.1.3 Plugins

Plug-in: Hibernate y relacionados.Sitio:En NetBeans, los plug-ins relacionados con Hibernate se bajan y descargan desde la opción Tools-> Plugins del propio IDE. Se seleccionarán los plugins “Hibenate Support” y Hibernet 3.2.5 Library”.

Plug-in: Hibernate Annotations 3.3.1 GASitio: http://sourceforge.net/project/showfiles.php?group_id=40712&package_id=139933

Plug-in: Hibernate Entity Manager 3.3.2 GASitio: http://sourceforge.net/project/showfiles.php?group_id=40712&package_id=156160

Plug-in: Hibernate Validator 3.0.0 GASitio: http://sourceforge.net/project/showfiles.php?group_id=40712&package_id=225206

Plug-in: jfreechartSitio: http://www.jfree.org/jfreechart/

3.1.1.4Tortoise SVN (Cliente SVN para Windows)

Versión: 1.4.8 (última disponible a la fecha)Sitio: http://tortoisesvn.net/downloads

3.1.1.5Configuración SVN en Assembla

Sitio: http://svn2.assembla.com/svn/tdp2Usuario y contraseña: Deberá pertenecer al grupo, hablar con alguno de los integrantes para ser dado de alta.

3.1.1.6Grupo de Google

Para enviar un mail al grupo: tdp2@googlegroups.com Para desuscribirse: tdp2-unsubscribe@googlegroups.com Para visitar el grupo: http://groups.google.com/group/tdp2

3.1.1.7Grupo Assembla (Wiki + Bug tracker)

Sitio: http://www.assembla.com/spaces/show/tdp2 Usuario y contraseña: Deberá pertenecer al grupo, hablar con alguno de los integrantes para ser dado de alta.

3.1.1.8 MySQL

Versión: 5.0Sitio: http://dev.mysql.com/downloads/mysql/5.0.html#win32

3.1.2Documentación de soporte

Se tendrá en cuenta el enunciado de relevamiento del problema, minutes de reunión con el cliente (ayudante) y comunicación por medio del grupo oficial de la materia.

Confidencial Sambayón Group, 2023 Página 5 de 7

Sambayón Versión: 3.0Plan de Despliegue Date: 19/05/2008

3.1.3Personal de soporte

Los cuatro integrantes del grupo, cumpliendo los roles establecidos en el equipo de trabajo, serán los encargados del desarrollo del proyecto, implementación y despliegue.

4.EntrenamientoLos usuarios finales del producto no serán capacitados puesto que lo utilizarán eventualmente al presentarse a rendir examen. Es por esto que el software contendrá ayudas contextuales y será los más simple posible para evitar confundir a estos usuarios.

El personal de administración del sistema no será capacitado personalmente.

5.Configuración de la plataforma de desarrolloA continuación se detallan los pasos para que los desarrolladores involucrados en el proyecto puedan construir la aplicación.

5.1Configuración de la BackApplication

1.- Instale MySQL 5.0.52a2.- Abra NetBeans 6.1.3.- Selecciones Tools->Plugins, en la pestaña “Available Plugins” seleccione “Hibenate Support” y “Hibernet 3.2.5 Library” y presione “Install”. Si no están disponibles, verifique que estos plugins se encuentran en la pestaña “Installed”.4.- Seleccione File->Open Project. Abra el proyecto “BackApplication2” del directorio “Codigo”, dentro del directorio “trunk” del SVN. Es normal que al hacerlo NetBeans le avise que hay referencias rotas, por el momento ignore el mensaje y cierre el pop-up.5.- Selecciones Tools->Libraries. Presione “New Library” para crear una nueva librería. Escriba como nombre “HibernateExtras” y verifique que sea del tipo “Class Libraries”. Una vez hecho esto, seleccione la librería recién creada y presione el botón “Add/JAR Files”. Seleccione desde el directorio “lib” del BackApplication2 los siguientes .jar:

ejb3-persistence.jar hibernate-annotations.jar hibernate-commons-annotations.jar hibernate-entitymanager.jar hibernate-validator.jar javassist.jar

Estos .jar son los que se indicó fueran descargados previamente. En este caso se los dispuso en el directorio “lib”.6.- Selecciones Tools->Libraries. Presione “New Library” para crear una nueva librería. Escriba como nombre “jFreeChart” y verifique que sea del tipo “Class Libraries”. Una vez hecho esto, seleccione la librería recién creada y presione el botón “Add/JAR Files”. Seleccione desde el directorio “lib” del BackApplication2 los siguientes .jar:

jfreechart-1.0.9.jar jcommon-1.0.12.jar

Estos .jar son los indicados previamente para poder crear los gráficos. En este caso se los dispuso en el directorio “lib”.7.- Si los proyectos Business y Model no fueron abiertos automáticamente en la ventana “Projects” de NetBeans, ábralos desde File->Open Project.8.- En este punto, BackApplication2 ya no debería tener problemas de referencias no resueltas. Abriendo el menú contextual sobre este proyecto, elija la opción “Clean and Build”. En la consola OUTPUT debe verse el resultado como BUILD SUCCESSFUL.

Confidencial Sambayón Group, 2023 Página 6 de 7

Sambayón Versión: 3.0Plan de Despliegue Date: 19/05/2008

9.- Creación de la base de datos. Hibernate hará esto automáticamente, para lo cual deben hacerse ciertos cambios sobre el archivo Model->Source Package->Meta-inf->persistence.xml. Ábralo. Este archivo le indica a Hibernate qué base de datos crear y en base a qué clases. Usted debe configurar dos propiedades aquí: hibernate.connection.username y hibérnate.connection.password con los valores que necesite para su base de datos. Si es necesario, adecue el valor del puerto de modo que coincida con su servidor MySQL, el cual utiliza el 3306 por defecto.10.- El este archivo pesistence.xml hay también un tag comentado:

<!-- Uncomment to create database Schema -><property name="hibernate.hbm2ddl.auto" value="create-drop"/><!- -->

Hibérnate.hbm2ddl.auto es la herramienta que creará la base de datos con todas las tablas. Descomente esta línea y corra la aplicación una vez. Lo que hace “create-drop” es borrar la base sambayón (si existe) y volver a crearla. Una vez creada la base, comente nuevamente esta línea.11.- En este momento la aplicación back debería permitir leer, escribir y actualizar preguntas.12.-Hay JUnits listos, disponibles en el proyecto Model, en Test Package -> ar.uba.fi.tdp.gr3.sambayon.controller. Cada uno de los .jar que allí se encuentran es una prueba unitaria diferente, que puede ejecutarse seleccionando “Run File” desde el menú contextual. La prueba corre en la consola de output, mostrando detalles e indicando si pasó o no la prueba.

Confidencial Sambayón Group, 2023 Página 7 de 7