Configurando MySQL y MariaDB

Nota

MariaDB es una bifurcación de MySQL desarrollada por la comunidad, pensada para seguir siendo libre bajo la GNU GPL. Como bifurcación de un sistema de software de código abierto líder, destaca por estar liderada por los desarrolladores originales de MySQL. Se creó por las dudas en torno a la adquisición de Oracle.

MariaDB ha soportado secuencias de base de datos desde la v10.3, pero recomendamos usar la v10.6 o más reciente actualmente. Vea MariaDB Server Releases.

Preliminares

Precaución

Realice todos los cambios con la aplicación detenida.

Compruebe si su instalación de MySQL tiene habilitado el motor InnoDB:

$ MySQL -h localhost -u root -p
> show engines;

Consejo

Debería mostrar algo como esto:

| InnoDB | DEFAULT | Supports transactions, row-level locking, and foreign keys | YES | YES | YES |

Si se está usando otro motor por defecto, hay dos opciones:

1. Usar el dialecto com.openkm.db.dialect.MySQL5InnoDBDialect y evitar cambiar el motor de almacenamiento por defecto de MySQL.
2. Cambiar el motor por defecto.

Cambiar el motor por defecto

Modifique el fichero de configuración de MySQL llamado my.cnf

Después, bajo [mysqld], añada

default-storage-engine = innodb

Precaución

Tras cambiar el valor por defecto en MySQL, el servicio debe reiniciarse para que surta efecto.

Cambiar el charset por defecto

En Ubuntu 16.04, el charset configurado por defecto en MariaDB y MySQL es utf8mb4, pero recomendamos cambiar a utf8. Para obtener el charset recomendado, debe modificar estos ficheros:

/etc/mysql/mariadb.conf.d/50-server.cnf

character-set-server = utf8
collation-server = utf8_general_ci

/etc/mysql/mariadb.conf.d/50-client.cnf

default-character-set = utf8

/etc/mysql/mariadb.conf.d/50-MySQL-clients.cnf

default-character-set = utf8

Una vez modificado, debe reiniciar el servidor de base de datos.

Creación de la base de datos

Crear una base de datos y un usuario

DROP DATABASE IF EXISTS okmdb;
CREATE DATABASE okmdb DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_bin;
CREATE USER openkm@localhost IDENTIFIED BY '*secret*';
GRANT ALL ON okmdb.* TO openkm@localhost WITH GRANT OPTION;

Puede comprobar el motor de la base de datos con lo siguiente:

$ MySQL show -h localhost -u root -p --status okmdb;

Más información en MySQL: Case Sensitivity in String Searches

Crear una base de datos en persa

Establezca el collation y charset persa en el fichero de configuración my.ini (requiere reiniciar el servicio):

collation_server = utf8mb4_persian_ci
character_set_server = utf8mb4

Establezca el collation y charset persa en la sesión actual de MySQL (tras reiniciar el servicio, se usarán los valores por defecto de my.ini):

SET collation_server = 'utf8mb4_persian_ci';
SET character_set_server = 'utf8mb4';

Base de datos:

CREATE DATABASE okmdb CHARACTER SET utf8mb4 COLLATE utf8mb4_persian_ci;

CREATE USER openkm@localhost IDENTIFIED BY 'k4M0j4lBi#ed';

GRANT ALL ON okmdb.* TO openkm@localhost WITH GRANT OPTION;

Configurar su openkm.properties

Precaución

Esta propiedad de configuración debe establecerse antes de crear la base de datos. Una vez inicializada la base de datos, no la modifique, porque hacerlo puede dañar su instalación.

Si su instalación de OpenKM ya se ha configurado con otra base de datos, no puede cambiar a otra base de datos simplemente modificando esta propiedad.

Elija el dialecto correcto según la versión de su motor de base de datos.

Dialectos MySQL:

• com.openkm.db.dialect.MySQL55Dialect
• com.openkm.db.dialect.MySQL57Dialect
• com.openkm.db.dialect.MySQL8Dialect

Dialectos MariaDB:

• com.openkm.db.dialect.MariaDBDialect
• com.openkm.db.dialect.MariaDB53Dialect
• com.openkm.db.dialect.MariaDB10Dialect
• com.openkm.db.dialect.MariaDB102Dialect
• com.openkm.db.dialect.MariaDB103Dialect
• com.openkm.db.dialect.MariaDB106Dialect

Dialectos obsoletos:

• com.openkm.db.dialect.MySQL5InnoDBDialect
• com.openkm.db.dialect.MySQL57InnoDBDialect

Edite el fichero $TOMCAT_HOME/openkm.properties

spring.jpa.hibernate.ddl-auto=create-only
spring.jpa.properties.hibernate.dialect=com.openkm.db.dialect.MySQL5InnoDBDialect

Zona horaria de MySQL

Si quiere establecer su zona horaria en la conexión JDBC para que coincida con la configurada en su sistema, primero puede ver los mapeos tanto para MySQL como para MariaDB así:

SELECT * FROM MySQL.time_zone_name

Así, por ejemplo, podría configurar su conexión JDBC de esta forma si la zona horaria de su sistema es UTC+1:

spring.datasource.url=jdbc:mysql://localhost:3306/okmdb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8&nullNamePatternMatchesAll=true&serverTimezone=Europe/Madrid

Donde Europe/Madrid es un valor válido tomado de la tabla time_zone_name.

Configurar los orígenes de datos de Tomcat

Edite el fichero $TOMCAT_HOME/openkm.properties y habilite el recurso llamado JDBC/OpenKMDS

MySQL:

spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/okmdb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8&nullNamePatternMatchesAll=true&serverTimezone=Europe/Madrid
spring.datasource.username=openkm
spring.datasource.password=*secret*

MariaDB:

spring.datasource.driver-class-name=org.mariadb.jdbc.Driver
spring.datasource.url=jdbc:mariadb://localhost:3306/okmdb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8&nullNamePatternMatchesAll=true&serverTimezone=Europe/Madrid
spring.datasource.username=openkm
spring.datasource.password=*secret*

Nota

MariaDB puede usar estos valores de driverClassName:

• com.mysql.jdbc.Driver
• org.mariadb.jdbc.Driver

En versiones recientes de MySQL, debe añadir useSSL=false a la URL de conexión.

Precaución

Configure los valores de los atributos llamados:

• Username.
• Password.
• URL (cámbielo por su host y puerto).

Solo puede usarse el recurso llamado JDBC/OpenKMDS.

Configurar el login de la aplicación

Edite el fichero $TOMCAT_HOME/openkm.properties

authentication.openkm.database=true

Ejecutar la aplicación

Al arrancar OpenKM, la aplicación creará automáticamente una estructura de base de datos vacía.

Nota

Una vez creadas las tablas, OpenKM cambiará automáticamente la propiedad hibernate.hbm2ddl de create-only a none.

Información adicional

• InnoDB Performance Tuning Tips
• InnoDB - High disk write I/O on ibdata1 file and ib_logfile0

Eliminar y crear el servicio de MySQL en Windows.

Precaución

Asegúrese de que su carpeta MySQL\bin está en la variable de entorno PATH.

Por ejemplo, en MySQL 5.7, la carpeta bin se encuentra en C:\Program Files\MySQL\MySQL Server 5.7\bin

Si tiene un servicio de MySQL en Windows, puede eliminarlo con una de estas líneas de comando:

c:\> mysqld --remove MySQL57

o

c:\> sc delete MySQL57

Crear el servicio:

c:\> "C:\Program Files\MySQL\MySQL Server 5.7\bin\mysqld.exe" --install MYSQL57 --defaults-file="C:\ProgramData\MySQL\MySQL Server 5.7\my.ini"

Nota

Más información en http://dev.mysql.com/doc/refman/5.7/en/windows-start-service.html

Migrar de Windows a Linux

Precaución

Por defecto, los nombres de tabla en Windows son en minúsculas y en Linux en mayúsculas.

Cuando migre de Windows a Linux, debe convertir los nombres de tabla en minúsculas a mayúsculas. El siguiente script ayuda a hacerlo:

select concat('rename table ', table_name, ' to ' , upper(table_name) , ';') from information_schema.tables where table_schema = 'okmdb';

Nombres de nodo insensibles a mayúsculas/minúsculas

Por defecto, la base de datos distingue entre mayúsculas y minúsculas. Sin embargo, ejecutando:

ALTER TABLE OKM_NODE_BASE MODIFY NBS_NAME varchar(256) COLLATE utf8mb3_general_ci;

se modifica la columna NBS_NAME de forma que los nombres de nodo se tratan de forma insensible a mayúsculas/minúsculas. Este collation también ignora las diferencias de acentuación, por lo que los nombres con y sin acentos se consideran equivalentes.

Como consecuencia, no será posible tener dos documentos como “Más temas.txt” y “mas temas.txt”, ya que para el índice de la tabla se interpretan como la misma cadena y la restricción de unicidad fallará.

Si esto ocurre, el sistema puede lanzar un error como:

ERROR 1062 (23000): Duplicate entry '483ab139-9c20-44a9-8534-ed124a8f37ba-NULL' for key 'IDX_NODE_BASE_PARNAM'

Esto significa que ambos valores se consideran idénticos y el índice único los detecta como duplicados.

Para identificar los nodos problemáticos, puede ejecutar la siguiente consulta:

SELECT NBS_PARENT, NBS_NAME, COUNT(*) FROM OKM_NODE_BASE
GROUP BY NBS_PARENT, LOWER(NBS_NAME) HAVING COUNT(*) > 1;

Los duplicados encontrados deben renombrarse para que dejen de tratarse como iguales.

Resolución de problemas

Error “ASCII ‘\\0’ appeared in the statement” al importar un volcado de base de datos.

Es posible que el error esté causado por la codificación del fichero SQL. Debería comprobar el formato del fichero. Por ejemplo, con el comando:

> file okmdb.sql
okmdb.sql: Little-endian UTF-16 Unicode text, with very long lines, with CRLF line terminators

Si el fichero está en formato UTF-16, conviértalo a UTF-8. Por ejemplo, use el comando:

> iconv -f utf-16 -t utf-8 okmdb.sql > okmdb-good.sql