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.1.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