home | JClic | JClic reports | Configuración MySQL - Windows

JClic reports server
Configuración estándar con mySQL en Windows

MySQL (http://www.mysql.com) es un sistema de bases de datos profesional, con licencia de software libre y disponible en diversos tipos de ordenadores y entornos operativos. Tiene unas prestaciones superiores a MS-Access, tanto en eficiencia de las consultas como en la gestión de usuarios y permisos, pero tiene un proceso de instalación, mantenimiento y explotación algo más complejo.

Para efectuar las operaciones que se detallan a continuación es necesario operar con un usuario de Windows que tenga derechos de administración del sistema.

1. Creación de la base de datos

Si no tiene mySQL instalado puede ir a http://www.mysql.com/downloads y descargar la versión más reciente. De todas maneras, es mucho mas interesante descargar el paquete EasyPHP (http://www.easyphp.org), que instala mySQL acompañado del servidor web Apache, el interprete de páginas dinámicas PHP y la aplicación phpMyAdmin. En este documento supondremos que tiene EasyPHP instalado y en funcionamiento.

• Con el EasyPHP funcionando, ponga en marcha phpMyAdmin (normalmente llegará con un navegador escribiendo la dirección http://localhost/mysql/)
• Escriba en el campo Crear una nueva base de datos el nombre: JClicReports
• Haga clic en Crear. PhpMyAdmin creará la base de datos y la seleccionará.
• Haga clic en el enlace localhost que aparece en la parte superior y entre en Privilegios. Desde aquí, vaya a Agregar nuevo usuario.
• Escriba en el campo Nombre de usuario: jclic_user
• Escriba una contraseña en Contraseña y en Re-escriba. Por ejemplo: jclic_pwd
• Confirme con el botón Continúe que hay en la parte inferior. Irá a la pagina Editar los privilegios.
• Busque la sección Privilegios específicos para la base de datos y seleccione en la lista desplegable la entrada JClicReports.
• Se encontrará en la página Usuario jclic_user@% - Base de datos JClicReports. Seleccione todas las casillas de permisos (Revisar todos/as) y haga clic en Continúe.

Con esto estará ya creada la base de datos. Ahora podría cargar un conjunto de datos de demostración que le servirán para probar su funcionamiento. Estos datos se pueden borrar más adelante desde el mismo JClic reports.

• Empiece por descargar este archivo:
  
  jclic_test_mysql.zip (65 Kb)
• Guárdelo en cualquier carpeta temporal, ábralo y extraiga su contenido. Obtendrá un archivo llamado jclic_test_mysql.sql.
• Desde phpMyAdmin, seleccione la base de datos JClicReports en la columna de la izquierda y active la pestaña SQL.
• Busque la sección Localización del archivo de texto, haga clic en Navega... y busque el archivo jclic_test_mysql.sql que ha obtenido en el paso anterior.
• Si aparece la lista desplegable Juego de caracteres del archivo seleccione en ella el valor latin1.
• Haga clic en Continúe.

Tardará un tiempo en procesar los datos. Para verificar que se hayan cargado correctamente seleccione la tabla jclic_users en la lista de la izquierda y haga clic en la pestaña Navega.

2. Configuración del conector

Para que JClic reports pueda acceder a la base de datos mySQL necesitará un conector JDBC, que se puede obtener en la misma web de mySQL. Para instalarlo basta con copiar un archivo en la carpeta de extensiones de Java.

• Primero deberemos averiguar donde se encuentra esta carpeta de extensiones. Lo más fácil es poner en marcha un applet JClic, hacer clic en el botón JClic y mirar en la pestaña Sistema la líneaUbicación de Java. La carpeta de extensiones se encuentra añadiendo "lib\ext" a la expresión que ahí aparece. Normalmente es:
  C:\Archivos de programa\Java\jre_x.x.x\lib\ext

• Con el navegador web vaya a la dirección:
  http://dev.mysql.com/downloads/connector/j
• Descargue y abra el archivo ZIP que ahí se indica. Seguramente deberá seleccionar un mirror.
• Dentro de este archivo ZIP hay otro llamado mysql-connector-java-x.x.x-bin.jar. Extráigalo a la carpeta de extensiones de Java que ha localizado en el paso anterior. No lo confunda con otro archivo que tiene un nombre similar pero acabado en "-b.jar". Las cifras (x.x.x) pueden variar según cual sea la última versión publicada.

Con eso queda el sistema Java preparado para utilizar la base de datos mySQL.

3. Configuración de JClic reports

Para poner en marcha JClic reports puede optar entre hacer clic en el icono situado en la página de descarga de JClic o en alguno de los iconos que se crearán en el escritorio y en el menú Inicio después de haberlo utilizado un par de veces. También puede descargar y ejecutar el instalador, que copiará el programa en su ordenador y creará un icono en el menú Inicio. Esta segunda opción tiene el inconveniente de que la aplicación no se actualiza automáticamente al publicarse nuevas versiones, a diferencia de lo pasa con Java WebStart.

• Haga clic en Configuración...
• Active la pestaña Base de datos.
• Escriba en Controlador la expresión: com.mysql.jdbc.Driver
• Escriba en URL la expresión: jdbc:mysql://localhost/JClicReports
  
  Es importante escribirlo tal como se indica, teniendo en cuenta los puntos, sin espacios y distinguiendo entre mayúsculas y minúsculas.
• Escriba el nombre de usuario de la base de datos y la contraseña. En el ejemplo se han utilizado los siguientes datos:
  • Usuario: jclic_user
  • Contraseña: jclic_pwd
• Deje marcada la casilla Crear tablas si no existen, y deje también el prefijo JCLIC_ para los nombres de tablas.
• Confirme la operación en Aceptar.

Con eso tendrá JClic reports preparado para trabajar con la base de datos.

Para comprobar el funcionamiento haga clic en Iniciar el navegador. Si todo ha ido correctamente se pondrá en marcha Firefox, Explorer o cualquier otro navegador (se puede selecciona en Opciones) donde se mostrará una primera página en la que se pide una contraseña, que inicialmente hay que dejar en blanco. Si ha cargado los datos de demostración puede entrar en los informes de grupo y de usuario, y visualizar los diversos tipos de tablas y gráficos que ofrece el programa.

En este momento puede ser conveniente navegar hacia la sección Administración de la base de datos y realizar dos operaciones:

• Establecer una contraseña, que impedirá que personas no autorizadas tengan acceso a la aplicación.
• Decidir la política de altas de nuevos usuarios. Hay tres opciones:
  
  1. Dejar que cualquier usuario pueda crear grupos y darse de alta con el nombre que desee.
  2. Crear manualmente los grupos, y dejar que los alumnos lo seleccionen y se den de alta por si mismos la primera vez que utilicen JClic.
  3. Crear manualmente todos los grupos y usuarios, o importarlos de alguna otra base de datos. Para efectuar importaciones le resultará útil consultar el esquema de tablas de JClic reports.
  En la mayoría de casos lo mas recomendable es empezar por la segunda opción, impidiendo más adelante la creación de nuevos usuarios, cuando todos los alumnos se hayan dado ya de alta.

4. Configuración de los clientes JClic

Es necesario configurar los clientes JClic para que se conecten con el servidor JClic reports y le envíen información sobre las actividades realizadas.

Los pasos a seguir son:

1. Asegúrese de que JClic reports esté funcionando en algún ordenador de la red.
2. Haga clic en Configuración de JClic reports y vaya a la pestaña Servidor web. Anote el valor del Puerto de comunicaciones, que normalmente es 9000.
3. Averigüe también el nombre o la dirección IP del ordenador en el que funciona JClic reports. Puede utilizar su nombre de red (por ejemplo, “servidor”) o su dirección IP (cuatro números separados por puntos, como por ejemplo “192.168.1.10”). Una manera rápida de averiguar la dirección IP es abrir una ventana del indicador de órdenes (o "ventana MS-DOS", en el grupo Accesorios) y escribir: "ipconfig".
4. Ponga en marcha JClic desde cualquier ordenador de la red. Puede hacerlo mediante el botón que se muestra en la página de descarga de JClic, o desde los iconos que se crearán en el escritorio y en el menú Inicio cuando lo haya activado un par de veces. En la sección de preguntas frecuentes encontrará más información sobre l creación de accesos directos para poner en marcha JClic.
5. En JClic, vaya a Herramientas - Configuración y seleccione la pestaña Informes.
6. Marque la casilla Guardar los resultados de las actividades en una base de datos.
7. Seleccione la opción Conectarse a un servidor de informes JClic, y escriba en el campo Servidor el nombre o la IP del ordenador en el que está funcionando JClic reports, seguido de dos puntos y el número de puerto. Será una expresión similar a una de estas:

   192.168.1.10:9000
   servidor:9000

8. Confirme los cambios, cierre JClic y vuelva a ponerlo en marcha. Si todo va bien debería aparecer la pantalla de identificación, y JClic reports empezará a registrar los resultados de todas las actividades que realice.
9. Repita los pasos 4, 5, 6 y 7 en todos los ordenadores en los que desee activar el sistema de informes de JClic.

Consejos

• Recuerde realizar copias de seguridad de la base de datos con regularidad. Basta con guardar en algún lugar seguro un duplicado del directorio data\JClicReports que se encuentra dentro de la carpeta en la que esté instalado mySQL. También puede utilizar la opción Exportar de phpMyAdmin.
• La contraseña de acceso a la base de datos permite efectuar todo tipo de operaciones, desde consultar resultados hasta borrar usuarios y grupos enteros. En futuras versiones mejoraremos este sistema creando diversos perfiles de administración y acceso, pero actualmente hay una única llave de acceso al sistema. Manténgala en lugar seguro.
• Si necesita más seguridad (acceso restringido a la base de datos, monitorización de accesos, etc.) instale la modalidad avanzada, que utiliza la base datos mySQL y el servidor de aplicaciones Apache Tomcat, preferiblemente bajo Linux.