Proceso de instalación de MySQL Server. Obviamente requieren tener en el equipo el permiso para instalar software y haber seguido los pasos en la instalación de servidor base para configurar el gestor de paquetes.
Los servicios de MySQL para Helpcom se instalan usando por defecto el motor MariaDB, que es la versión “community” de MySQL con licencia para poder distribuirla a los clientes.
Para ser usable con Helpcom, se debe ajustar el servicio de BDD con ciertas configuraciones. Las más importantes incluyen:
La paquetería de Helpcom incluye un archivo de configuración que ve la mayoría de estas variables.
Descarga Oficial:
Para habilitar un servidor de MySQL = 5.5, ver MySQL Server Legacy.
Se asume aquí que se parte desde Instalación Linux Servidor y que se ha completado la instalación, posinstalación y primer inicio, incluyendo tener activado el repositorio de Helpcom.
Instalar desde el gestor de paquetes de la distribución. El proceso por defecto instala MariaDB:
# Debian 10 en adelante paquetería base de Helpcom apt install helpcom-servidor-mysql # Si se queja de ambigüedades, se puede usar: apt install helpcom-servidor-base mariadb-server mariadb-client # Ubuntu 20.04 en adelante apt install helpcom-servidor-mysql
El archivo de configuración resultante es por defecto /etc/mysql/my.cnf
, y habrá un árbol de directorios con archivos de configuración en /etc/mysql/mariadb.conf.d/
(MariaDB 10.3 en adelante) o /etc/mysql/mysql.conf.d/
(MySQL; MariaDB hasta 10.2). Un archivo de configuración /etc/mysql/my.helpcom.cnf
de prueba se agrega a la carpeta base que puede copiarse al destino decuado y modificarse.
El árbol de la base de datos está guardado por defecto en /var/lib/mysql
. Ante cualquier duda de cómo configurar los archivos necesarios que esta guía no resuelva, leer la documentación oficial de MariaDB / MySQL.
Los siguientes elementos deben configurarse en el servidor antes de crear las primeras bases de datos e ingresar datos. Como root
:
1.- Detener el servicio.
service mysql stop
2.- Copiar el archivo my.helpcom.cnf
a la carpeta adecuada. Por ejemplo:
# como root ( cd /etc/mysql; cp my.helpcom.cnf ./maradb.conf.d/ )
3.- Editar el archivo resultante con las configuraciones que deseamos.
nano /etc/mariadb.conf.d/my.helpcom.cnf
Esto debe mostrar algunas configuraciones base para el servidor. Podemos aprovechar de configurar lo que necesitemos.
Guardar y salir.
3.- Reiniciar el servicio:
service mysql start
Si se ha seguido la paquetería de Helpcom, es bastante fácil cargar las credenciales por defecto (los usuarios “helpcom_db” y “helpcom-admin”). Para esto, aún como root:
mysql < /usr/local/etc/helpcom/mysql-permisos0.sql
Descarga Oficial:
Para instalar se usa uno de los instaladores de MariaDB Server.
Se escogen en general las siguientes opciones de instalación:
Una vez que el servidor esté instalado, el software ofrece la opción de configurarlo vía la herramienta de configuración del servicio (“Service Wizard”). Opciones de configuración:
[✔] Iniciar Servicio con Windows
.MySQL5
viene por defecto, se puede escoger otro nombre si por cualquier razón es necesario instalar más de un servicio MySQL en un servidor (por ejemplo, dos o tres versiones de MySQL diferentes).[✔] Agregar ruta de ejecutables del servicio al %PATH%
.[ ] Habilitar acceso anónimo
.
El archivo de configuración resultante es por defecto %PROGRAMFILES%\MySQL Server\(versión)\my.ini
y el árbol de la base de datos está guardado por defecto en %PROGRAMDATA%\MySQL Server
.
Los siguientes elementos deben configurarse en el servidor antes de crear las primeras bases de datos e ingresar datos:
1.- Detener el servicio.
Ejecutar → services.msc MySQL → menú contextual → Detener
2.- Editar my.ini
o el archivo de configuración equivalente (depende de la versión de MySQL; revisar las documentaciones oficiales correspondientes) y agregar las siguientes directivas a la sección [mysqld]
:
[mysqld] # Agregar los siguientes campos: # Permitir conexión desde fuera: # (chequear también Firewall de Windows) bind-address = * # Puerto de conexión: port = 3306 # Modelo de almacenamiento de binarios innodb_file_per_table = 1 # Modelo de sincronización en disco innodb_flush_method = normal
Poder guardar los cambios en el archivo puede requerir iniciar el editor de texto o el explorador con privilegios de Administrador de Sistema.
3.- Reiniciar el servicio:
Ejecutar → services.msc MySQL → menú contextual → Iniciar
A este punto, antes de continuar, conviene chequear las Notas para ver si alguna de ellas aplica a la configuración actual. En particular para MySQL 5.7 es necesario chequear la sección “Usuario no puede hacer login a root”.
Completados estos pasos y ya andando el servicio de MySQL lo que queda es establecer los usuarios y permisos. Esto permite:
root
.La carga de credenciales en Windows debe hacerse manualmente, ya que Windows no tiene una gestión de paquetes que lo permita.
Para desinstalar correctamente ver los pasos en .MySQL Server Desinstalar, o seguir la documentación oficial.
mysqldump
o un MySQL ODBC de una versión diferente.
En MySQL 5.5, algunas tablas pueden insertar o leer información en el COLLATION
incorrecto cuando uno se conecta desde clientes de MySQL más nuevos, incluyendo conectores como los conectores de Eclipse o DBeaver que usan un conector más nuevo que el ODBC 5.1.
Para asegurarse que las tablas se generan en el sistema con el COLLATION correcto por defecto, es necesario editar my.cnf
y agregar a la sección [mysqld]
una de las dos siguientes opciones:
collation-server = utf8_general_ci collation-server = latin1_general_ci
Cuál collation por defecto debe usarse depende del caso a caso; en general para Crux y Alerce debe usarse el utf8
, para servidores de producción de Facturación Electrónica debe usarse el latin1
, y para todo lo demás se puede escoger cualquiera mientras se sea consecuente entre clientes y servidores.