home | JClic | JClic reports | Configuración mySQL - Debian

JClic reports server
Configuración estándar con mySQL en Linux (Debian, Ubuntu)

Página actualizada el 6 de noviembre de 2013
Las instrucciones se han probado en Linkat Ubuntu 12.04

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.

La modalidad estándar de funcionamiento del servidor de informes de JClic necesita un escritorio gráfico (Gnome o KDE), una máquina virtual Java actualizada y el sistema de arranque de aplicaciones Java WebStart. En la página de instalación del motor Java se explica como configurar estos componentes en diversos entornos operativos.

1. Creación de la base de datos

Dividiremos esta operación en dos fases: instalar MySQL y crear una base de datos para el sistema de informes de JClic. Si en su sistema ya está MySQL instalado puede pasar directamente al paso 1.2.

1.1. Instalación de MySQL

Para instalar y configurar MySQL será necesario abrir una consola (Ctrl+Alt+T) y ejecutar las ordenes que se indican a continuación. Es necesario que el usuario que las ejecute tenga permisos de administración (que sea "sudoer") y que introduzca su contraseña cuando el sistema se lo solicite:

Instale mySQL escribiendo:

%> sudo apt-get install mysql-server mysql-client libmysql-java

Si todo funciona correctamente de descargarán los archivos y aparecerá una pantalla en la que le preguntaran qué contraseña desea establecer para el usuario "root" de mySQL. Introduzca la contraseña que crea más conveniente (no tiene porqué coincidir con su contraseña de usuario) y repítala cuando se le solicite confirmación.

1.2 Creación de la base de datos de JClic reports

A continuación crearemos la base de datos de informes de JClic, y un nuevo usuario de mySQL que tendrá plenos derechos sobre ella. También cargaremos un conjunto de datos de demostración, que nos permitirán comprobar el funcionamiento del sistema.

Sitúese en cualquier directorio donde tenga derechos de escritura (por ejemplo, “cd $HOME”) y haga:

%> sudo mysql -u root -p

El sistema le pedirá la contraseña del usuario root de mySQL. Cuando haya entrado, cree la base de datos:

mysql> CREATE DATABASE JClicReports;

Para comprobar que todo haya ido bien, escriba:

mysql> SHOW DATABASES;

... y la base de datos JClicReports debería aparecer en la lista.

Ahora crearemos un usuario (jclic_user) con una contraseña (la que desee: aquí se propone jclic_pwd) y le daremos plenos derechos sobre la base de datos que acabamos de crear:

mysql> CREATE USER 'jclic_user'@'localhost' IDENTIFIED BY 'jclic_pwd'

mysql> GRANT ALL PRIVILEGES ON JClicReports.*
-> TO 'jclic_user'@'localhost'
-> WITH GRANT OPTION;

Cierre la consola de mySQL con:

mysql> exit

A continuación descargue y descomprima el paquete de datos de prueba:

%> wget https://clic.xtec.cat/pub/reports/jclic_test_mysql.zip
%> unzip jclic_test_mysql.zip

Con eso obtendrá el archivo jclic_test_mysql.sql

Para cargar los datos entre en mySQL con el usuario jclic_user:

%> sudo mysql -u jclic_user -p

Le pedirá la contraseña del usuario jclic_user que ha creado hace un momento. Si ha seguido la sugerencia será jclic_pwd.

Para cargar los datos puede utilizar la orden “\.”:

mysql> use JClicReports;
mysql> \. jclic_test_mysql.sql

Atención al espacio entre el “\.” y el nombre del archivo, y atención también a la extensión (“.sql”) del nombre del archivo.

Para comprobar que los datos se hayan cargado correctamente haga:

mysql> SELECT * FROM JCLIC_USERS;

.. y deberían aparecer los datos de los usuarios.

Para acabar salga de mySQL con:

mysql> exit

2. Configuración del conector JDBC

Para que JClic reports pueda acceder a la base de datos mySQL será necesario instalar un conector JDBC. Dado que en el paso 1 hemos instalado el paquete "libmysql-java", el conector se encuentra ya en nuetro ordenador. Se trata del archivo "mysql-connector-java.jar", que se encuentra en el directorio "/usr/share/java". Ahora será necesario que el motor Java reconozca de manera automática esta extensión. Para conseguirlo hay que copiar o crear un enlace simbólico del conector al directorio de extensiones del entorno de ejecución de Java.

Las órdenes a dar son:

%> sudo mkdir -p /usr/java/packages/lib/ext
%> cd /usr/java/packages/lib/ext
%> sudo ln -s /usr/share/java/mysql-connector-java.jar .

Atención: El punto final es importante.

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.
• En la pestanya Servidor web indique un número de puerto superior a 1024. Por ejemplo, el 9000 (los puertos inferiores a 1024 solo los puede utilizar el usuario root)
• 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 Mozilla, Firefox 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. Haga clic en los botones "Enviar datos" para ver los resultados.

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”).
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

• Haga copias de seguridad de la base de datos con regularidad. Basta con guardar en algún lugar seguro un duplicado del directorio /var/lib/mysql, o utilizar alguna utilidad como la exportación de datos que ofrece 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.