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.
3. A partir de  BitNami Opina Stack, un instalador para las plataformas Linux, Windows y Mac OSX.
4. A partir de  BitNami Opina Virtual Machine, una máquina virtual basada en VMWare lista para ser usada.
5. A partir de  BitNami Opina Cloud Image, una imagen lista para ser usada en Amazon EC2.

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.4.4.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://DB_HOSTNAME:DB_PORT/DB_NAME
   hibernate.connection.driver_class=org.gjt.mm.mysql.Driver
   hibernate.connection.username=DB_USER
   hibernate.connection.password=DB_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.4.0
   application.adminMail=ADMIN_MAIL
   application.defaultUrlRedirection=URL
   
   application.manual.version=Martes 1, noviembre 2005
   
   application.smtp.hostname=SMTP_HOST
   application.smtp.auth=false
   application.smtp.count.username=SMTP_USER
   application.smtp.count.password=SMTP_PASSWORD
   application.smtp.debug=false
   #application.smtp.SSLPort=
   #application.smtp.emaislByConection=
   #application.smtp.conectionFrequency=
   
   application.proxy.enabled=${proxy.enabled}
   application.proxy.host=${proxy.host}
   application.proxy.port=${proxy.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