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

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

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

Ponga en marcha YasT y vaya a Install and remove software. Escriba en el campo search:

mysql

... y seleccione los paquetes:

mysql
mysql-shared
mysql-client
mysql-connector-java

Haga clic en Accept y complete el proceso.

Para poner en marcha el servidor mySQL deberá ir a la ventana principal de YasT, grupo System, y de aquí a System services (runlevel).

Seleccione la línea mysql, en la que seguramente aparecerá el valor “no”. Haga clic en Enable y después en Finish. Le pedirán permiso para guardar los cambios. Responda afirmativamente.

A continuación deberá efectuar dos operaciones para mejorar la seguridad de mySQL: impedir que usuarios anónimos (sin identificador ni contraseña) puedan acceder al sistema, y fijar una contraseña para el usuario “root” de mysql, que inicialmente la tiene en blanco. Para ello abra una consola y escriba:

%> mysql -u root
mysql> USE mysql;
mysql> DELETE FROM user WHERE User='';
mysql> SET PASSWORD FOR 'root'@'localhost' = PASSWORD('xxxx');
mysql> FLUSH PRIVILEGES;
mysql> exit;

... donde “xxxx” será la contraseña del usuario de mySQL administrador de la base de datos. No tiene porqué coincidir con la del administrador del Linux.

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:

%> 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> GRANT ALL PRIVILEGES ON JClicReports.*
-> TO jclic_user
-> IDENTIFIED BY 'jclic_pwd'
-> WITH GRANT OPTION;

Cierre la consola de mySQL con:

mysql> exit

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

%> wget http://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:

%> 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 necesitaremos un conector JDBC. Al instalar mySQL ya hemos indicado a YasT que instalara también el paquete mysql-connector-java. Ahora deberemos hacerlo visible para el sistema Java:

Abra una consola y hágase root:

%> su

Para instalar la biblioteca JDBC habrá que crear un enlace simbólica al conector (que YasT ha dejado en /usr/share/java) desde la carpeta de extensiones de Java:

%> cd /usr/lib/jvm/jre/lib/ext
%> ln -s /usr/share/java/mysql-connector-java.jar

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

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.