viernes, abril 29, 2011

Instalar Gestor de Encuestas - OPINA Licencia GNU

Tomado de: Gestor de Encuestas

Instalación y descarga

En esta página encontrarás información sobre las distintas opciones que existen para instalar esta aplicación. En la actualidad están disponibles:
  1. A partir del código fuente, compilando y generando el artefacto (WAR).
  2. A partir de un binario sobre el aplicar la configuración que se desee.
Para aquellos que lo necesiten (especialmente opción 1 y 2), a continuación se detallan algunos requisitos propios de este tipo de aplicaciones JEE.

Requisitos

La instalación de Opina requiere, para su puesta en marcha, el siguiente software:
  1. J2SE v.1.5.x Software Development Kit (SDK) o superior. Se puede descargar del sitio web de Sun Microsystem.
  2. Contenedor que implemente las especificaciones 2.3/1.2 de Servlet/JSP respectivamente. Algunas posibilidades:
    1. Apache Tomcat 5.x o superior.
    2. Caucho Resin.
    3. JBoss Application Server
    4. Sun Java System Application Server
  3. Sistema gestor de bases de datos (SGBD). Dado que se hace uso de Hibernate, son múltiples los SGBD que se pueden usar. Hasta la fecha se han realizando pruebas con MySQL, PostgreSQL y Oracle.
Consulte los entornos en los que la aplicación ha sido probada.

Instalación desde el binario

  1. Descargar la última versión estable ( versiones previas):  opina-bin-1.5.0.zip [14 Mb]
  2. Descomprimir el archivo.
  3. La configuración ( Hibernate) de acceso a base de datos se realiza en el archivo opina/WEB-INF/classes/hibernate.properties.
    hibernate.connection.url=
    hibernate.connection.driver_class=
    hibernate.connection.username=
    hibernate.connection.password=
    hibernate.c3p0.min_size=5
    hibernate.c3p0.max_size=0
    hibernate.c3p0.timeout=300
    hibernate.c3p0.max_statements=50
    hiberante.c3p0.acquire_increment=1
    hibernate.dialect=
    hibernate.show_sql=false
    hibernate.format_sql=true
    hibernate.connection.autocommit=false
    hibernate.hbm2ddl.auto=update
    hibernate.bytecode.use_reflection_optimizer=true
    hibernate.cache.use_second_level_cache=false
    hibernate.current_session_context_class=thread
    
    Una descripción detallada de cada uno de los parámetros de configuración se encuentra publicada en el  sitio web de Hibernate. Un ejemplo de configuración usando MySQL es:
    hibernate.connection.url=jdbc:mysql://HOST:PORT/DB
    hibernate.connection.driver_class=com.mysql.jdbc.Driver
    hibernate.connection.username=USER
    hibernate.connection.password=PASSWORD
    hibernate.c3p0.min_size=5
    hibernate.c3p0.max_size=0
    hibernate.c3p0.timeout=300
    hibernate.c3p0.max_statements=50
    hiberante.c3p0.acquire_increment=1
    hibernate.dialect=org.hibernate.dialect.MySQLDialect
    hibernate.show_sql=false
    hibernate.format_sql=true
    hibernate.connection.autocommit=false
    hibernate.hbm2ddl.auto=update
    hibernate.bytecode.use_reflection_optimizer=true
    hibernate.cache.use_second_level_cache=false
    hibernate.current_session_context_class=thread
    
  4. El resto de parámetros de configuración los encontraremos en el archivo opina/WEB-INF/classes/application.properties donde encontraremos las siguientes entradas:
    application.name=Opina: gestor de encuestas
    application.skin=/gui
    application.version=1.5.0
    application.buildNumber=2685
    application.adminMail=EMAIL
    application.defaultUrlRedirection=URL
    application.changelog=http://www.klicap.es/opina/opina-changelog.xml
    application.copyright=Copyright © 2010 klicap - ingeniería del puzle
    
    application.manual.version=Martes 1, noviembre 2005
    
    application.smtp.hostname=HOST
    application.smtp.auth=false
    application.smtp.count.username=USER
    application.smtp.count.password=PASSWORD
    application.smtp.debug=false
    application.smtp.tls.enabled=true
    application.smtp.emailsByConnection=5
    application.smtp.connectionDelay=30
    
    application.proxy.enabled=false
    application.proxy.host=HOST
    application.proxy.port=PORT
    # Autenticación no implementada
    #application.proxy.authenticated=false
    #application.proxy.user=
    #application.proxy.password
    
    application.administrator.usernameByDefault=opina
    application.administrator.passwordByDefault=qwerty.opina
    application.administrator.nameByDefault=Administrador
    
  5. Una vez configurada la aplicación, debemos colocar el directorio opina/ en el webapp de nuestro contenedor JSP/Servlet. En el caso de estar usando  Apache Tomcat, tendremos que copiar el directorio opina/ en $TOMCAT_HOME/webapp/.
  6. Dependiendo del contenedor (o servidor de aplicaciones) que estemos usando será necesario, o no, reiniarlo.
  7. Para comprobar que la aplicación se ha desplegado correctamente, accedemos a la siguiente URL: http://hostname:port/opina, donde deberemos encontrar una página de login.
  8. Si la configuración (credenciales, etc.) de base de datos es correcta, accedemos a la siguiente URL: http://hostname:port/opina/instalar.jsp. Esta página se encargará de crear el esquema de base de datos y dar de alta al usuario administrador, que por defecto, tendrá las siguientes credenciales:
    1. Nombre de usuario: opina
    2. Contraseña: qwerty.opina

No hay comentarios: