lunes, abril 25, 2011

Gestion de Proyectos OpenSource - Plandora

Tomado de: Proyecto Plandora

PROCESO DE INSTALACIÓN

En este capítulo se detallara el proceso para instalar el Plandora. Plandora es una herramienta web, cliente-servidor y por esta razón, exige una configuración poco más complejo, pero en definitiva no representa ser un gran problema.
En primer lugar, se debe tener dos cosas: un servidor web y una base de datos. En tiempo de desarrollo, el Plandora utiliza el Tomcat y MySQL, respectivamente, pero se puede utilizar en produccion cualquier servidor web (servlets compatible). Tomar en cuenta que se puede elegir otro servidor web, solo debe tener en cuenta que es posible que tenga dificultades al configurarlo, especialmente en la configuración de fuente de datos, ya que este "paquete de instalación 'sólo contiene la configuración de Tomcat. No obstante, no dude en elegir otra base de datos, pero recuerde que Plandora fue probado sólo en MySQL.

Este paquete de prensa contiene:


  • plandora-vX.X.X.zip: El archivo empaquetado ZIP contiene lo siguiente:
    • pandora.war: Archivo que se publicará en el servidor web, contiene toda la aplicación web.
    • MYSQL.sql: NO UTILICE ESTE SCRIPT si usted tiene en produccion una version previa de Plandora. Este archivo contiene sentencias SQL para la creación de las tablas y datos basicos. Se puede utilizar este script solamente cuando usted tiene una nueva instalación.
    • server.xml or context.xml: Este archivo debe ser utilizado para configurar la fuente de datos de PLANDORA en el Tomcat.
    • release_notes.txt: Notas donde se explica la novedades de la ultima versión.  

    • plandoraInterface.jar: Desde la versión 1.2.0, el paquete de instalación también incluye este archivo, que puede ser utilizado por los desarrolladores con el fin de ampliar las características de Plandora o personalizar puntos específicos del sistema (por ejemplo: notificator, base de conocimiento, la aparición de proyectos, etc )
    •  plandora-source-XXX: Los archivos de origen de la herramienta
    •  READ_ME_XXX.txt


    PRIMER PASO: Obtener el Tomcat y MySQL. 
    • Ambas herramientas son de código abierto y por esta razón, se puede descargar libremente de Internet. Estas herramientas están fuertemente consolidados y son de aplicación estable. Le recomendamos que utilice la versión 5.5.30 de Tomcat y 5.0 de MySQL. Estas versiones se destacó y utilizado con éxito durante las pruebas.
    • El enlace para realizar la descarga de Tomcat es el sitio web de Yakarta (comunidad que forma parte del Grupo Apache, que implementa y controla el Tomcat, además de muchas otras herramientas interesantes): Descargar Tomcat 5 y Descargar Tomcat 6
    • El enlace para realizar la descarga de MySQL MySQL es el sitio web de MySQL: Descargar MYSQL
    • Después de la descarga, debe instalar todo en la máquina que será el servidor Plandora. 
    • Puede instalar la Base de Datos y el Servidor Web en la misma máquina o por separado. Esta decisión debe basarse en sus necesidades. Siéntase libre.
    • Para la instalación de Windows, el Tomcat es un simple archivo zip. Para realizar la instalación, descomprimir el archivo en su sistema de archivos de la máquina.
    • MySQL para Windows, hay una aplicación de configuración, que después de su ejecución, requiere un poco de información: base de datos de usuario y la contraseña y el tipo de base de datos (seleccione el tipo "WebApplication")
    • Obs:. Después de la instalación de Windows, el MySQL se instala como un servicio de Windows. Esta característica hace que el apagado de inicio, la gestión, registros, etc, más fácil.


    SEGUNDO PASO: Ejecutar el script de base de datos.
    • Abrir la "pantalla de cliente de MySQL. 
    • Si ha utilizado la instalación de Windows, esta "pantalla de cliente es accesible a través del botón" Start "(" MySQL Command Line Client "). 
    • Después de abrirla, la "pantalla de cliente le pedirá una contraseña de base de datos. 
    • Debe introducir la misma contraseña que ha creado anteriormente. 
    • Entonces, la base de datos mostrará un mensaje ("mysql>").
    • A continuación, escriba: create database plandora; 
    • Es posible que reciba la respuesta: Query OK, 1 fila afectada (0,01 segundos), con este comando, que acaba de crear un nuevo objeto 'base de datos', y está listo para la inserción de datos.
    • A continuación, escriba: use plandora; 
    • Es posible que reciba la respuesta: Base de datos ha cambiado
    • Esta línea significa que usted está diciendo a la base de datos que todo lo que vas a hacer de ahora en adelante, se hará sobre la base de datos llamada 'plandora ", que se creó anteriormente.
    • Para completar el proceso que debe crear las tablas Plandora e insertar algunos datos básicos, pero, al descubierto en cuenta que si va a actualizar la versión de Plandora NO USAR EL SCRIPT 'mysql.sql'. Debe utilizar el script apropriado para realizar la migración de la versión y preservar los datos actuales. En cambio, si va a realizar una nueva instalación, utilice el script 'mysql.sql' descomprimiendo el archivo  'Plandora-vX.XXzip a un lugar conocido y escribir este comando en el cliente de MySQL: fuente [path_donde_esta_el_archivo_descomprimido] / mysql.sql ;
    • Espere hasta que todos los datos de población se realice. 
    • Después de eso, escriba el comando: quit.


    TERCER PASO: Puesta en marcha del Tomcat.
    • Copie el archivo mysql-connector-java-5.1.10-bin a la carpeta common / lib / del Tomcat.  Esta es la biblioteca para el acceso de MySQL base de datos utilizados por Tomcat. Esto se llama lib ConnectorJ y podría ser descargado en Conector Mysql- Java (JDBC).
    • El siguiente paso es configurar el origen de datos. Tomcat necesita esta información para fines de conexión y para suministrar una conexión a la aplicación. En realidad, el Tomcat toma el control de la "agrupación de conexiones" de la base de datos.
    • Para Tomcat 5.0.x debería copiar el server.xml (que viene con el paquete de instalación) a la carpeta conf / del Tomcat.
    • Para Tomcat 5.3.x o superior no debe copiar el archivo server.xml, pero se debe modificar el context.xml (obtener el archivo de ejemplo que viene con el paquete de instalación) de archivos en la carpeta conf / del Tomcat.
    • Nota 1: En ambos casos, es necesario cambiar los campos de usuario y contraseña a la configuración de usuario adecuada que ha creado durante la instalación de la Base de Datos. Después de descomprimir el archivo 'plandora-vX.XXzip', 'pandora.war' el archivo se creará. Copiar a la carpeta  / webapps de Tomcat. Después de esto, inicie el Tomcat a través de 'startup.bat' (Windows) o '. / Startup.sh' (Linux) que se coloca en bandeja de Tomcat / carpeta. Después de unos segundos (y muchos mensajes de la pantalla), el mensaje de abajo debe emergente en la consola de Tomcat: "INFO: Servidor de inicio en ms xxxx '.Cuando aparezca esta mensaje, significa que Tomcat ya está en marcha y el equipo es ahora un servidor Web. Para probar, abra un navegador y escriba en "barra de direcciones:" http://localhost:8080 ". Tenga en cuenta que se excluyeron "www" del fragmento, porque estamos accediendo a nivel local. Si un sitio web estándar de Tomcat emergente, que funciona!
    • Nota 2: Si está ejecutando Plandora en CentOS 5.4 considerar también para comprobar los parámetros JAVA_OPTS de Tomcat (ver más al respecto aquí ).
    • Nota 3: Si está ejecutando Plandora en Tomcat 6.0.14 en cuenta el tiempo, para colocar el context.xml en / carpeta META-INF. (Ver más al respecto aquí ).




    ÚLTIMO PASO: Puesta en marcha del Plandora.
    • Si todo funciona perfecto el Tomcat, debería haber sido explotado la pandora.war archivo (que se han puesto en carpeta de aplicaciones web) , el mismo crea una carpeta 'Pandora' en el webapps /. Este compartimiento se llama "despliegue de la aplicación.  Asegúrese de que el despliegue Plandora sucedido y a continuación, abra un navegador y escriba: http://localhost:8080/pandora/do/login?operation=prepareLogin.
    • Se debe mostrar el formulario de entrada de Plandora. El uso de 'root' el usuario sin contraseña para crear nuevos usuarios y proyectos.
    • Hay algunos usuarios para la prueba. Todos ellos no tienen contraseña. Puede quitar o cambiar si lo desea. 
    • Recuerde que, en este momento (hasta que cierre su Tomcat ;-)) el equipo es un servidor web que se puede acceder a otras máquinas en la red (o incluso por Internet, dependiendo de la configuración de red) a través de la dirección IP o el nombre del equipo.
    • Para ello, escriba la siguiente dirección en otra máquina (la máquina del cliente) para poder acceder a Plandora: http://servidor:8080/pandora/do/login?operation=prepareLogin

    Gracias

    Queremos que todo el mundo gracias a que ayuda o apoya este proyecto de ninguna manera (tecnically o no).Un agradecimiento especial a nuestras familias, ELUMAR de Sá, BETO Figueiredo, gargitter Kléber, Rodrigo Campusano, Lucas Godoy, MAX Rozenson, Greg Harris, los chicos del grupo VeriSoft, el equipo de COMPERA, el equipo de UNISOMA y el equipo de SourceForge.

    No hay comentarios: