Instalación

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.

A continuación se presentan distintas opciones para instalar la aplicación.

Desde los binarios

1. Descargar la última versión estable:
   1. opina-bin-1.0.11.zip [9,3 Mb]
   2. .tar.gz
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=1800
   hibernate.c3p0.max_statements=50
   hibernate.dialect=
   hibernate.show_sql=false
   hibernate.connection.autocommit=false
   hibernate.hbm2ddl.auto=update
   hibernate.cglib.use_reflection_optimizer=true
   

   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.connection.autocommit=false
   hibernate.hbm2ddl.auto=update
   hibernate.cglib.use_reflection_optimizer=true
   

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

Desde el instalador

Como resultado de la colaboración entre Opina y BitRock se encuentra disponible un instalador de Opina para multiples plataformas. El instalador incluye un contenedor JSP/Servlet (Apache Tomcat), un gestor de bases de datos (MySQL) y la propia aplicación. El instalador está disponible en BitNami, una excelente iniciativa de BitRock.