====== Actualización de MySQL 5.7 a MySQL 8 ======

{{indexmenu_n>19}}

===== Prerrequisitos =====

<WRAP center round important 60%>

Para migrar de MySQL 5.7 a MySQL 8 debe estar actualizado como mínimo a la **versión NG 760 MR 52 de Pandora FMS**.

</WRAP>

  * Abrir una ventana terminal con el usuario **root**  e introduzca el siguiente comando:
<code>

mysql --version

</code>

Obtendrá una respuesta parecida a la siguiente:

<code>
mysql  Ver 14.14 Distrib 5.7.33, for Linux (x86_64) using  EditLine wrapper

</code>

  * Realice un procedimiento de respaldo de datos. Consulte "[[:es:documentation:pandorafms:technical_annexes:07_backup_and_restore_procedures|Backup y procedimientos de recuperación]]" para más detalles.

===== Rocky Linux 8/AlmaLinux 8/RHEL 8 =====

  * Detenga el servidor PFMS y el Agente Software PFMS:

<code>
/etc/init.d/pandora_server stop
/etc/init.d/pandora_agent_daemon stop

</code>

  * Detenga el servidor Apache web:

<code>
systemctl stop httpd.service

</code>

O bien:

<code>
/etc/init.d/httpd stop

</code>

  * Haga un respaldo especial de la base de datos que sea compatible con MySQL 8:

<code>
mysqldump -u root -p pandora \
  --skip-add-drop-table \
  --complete-insert \
  --no-create-info> backup_pandora.sql

</code>

  * Haga un respaldo tal cual está hecho en MySQL 5.7 (un seguro adicional si tiene que volver a esta versión):

<code>
mysqldump -u root -p pandora> backup_pandora_5.7.sql

</code>

  * Haga un respaldo del fichero de configuración de MySQL (''my.cnf''):

<code>
cp /etc/my.cnf /tmp/my.cnf.BACK

</code>

  * Borre los repositorios de Percona 5:

<code>
rpm -qa | grep Percona-Server | xargs rpm -e --nodeps

</code>

  * Instale los repositorios de Percona 8:
<code>

dnf install https://repo.percona.com/yum/percona-release-latest.noarch.rpm -y

</code>

  * Habilite los repositorios del paso anterior:

<code>
percona-release setup ps80

</code>

  * Instale Percona 8

<code>
dnf install percona-server-server

</code>

  * Restablezca el fichero ''my.cnf'':

<code>
mv /tmp/my.cnf.BACK /etc/my.cnf

</code>

  * Modifique el fichero ''my.cnf''  para prescindir de ''query_cache_*'':

<code>
sed -i -e "s/^query_cache_type.*/#query_cache_type/g" /etc/my.cnf
sed -i -e "s/^query_cache_size.*/#query_cache_size/g" /etc/my.cnf
sed -i -e "s/^query_cache_min_res_unit.*/#query_cache_min_res_unit/g" /etc/my.cnf
sed -i -e "s/^query_cache_limit.*/#query_cache_limit/g" /etc/my.cnf

</code>

  * Si **no tiene un entorno con HA**, deshabilite los //log//  binarios con la siguiente instrucción en la sección ''[mysqld]'':

<code>
skip-log-bin

</code>

<WRAP center round tip 60%>

Véase también "[[:es:documentation:pandorafms:complex_environments_and_optimization:08_optimization#comprobacion_del_fichero_mycnf|Optimización y solución de problemas]]" para la comprobación del fichero ''my.cnf''.

</WRAP>

  * Inicie el servicio MySQL:
<code>

systemctl start mysql

</code>

o bien

<code>
service mysqld start

</code>

  * Verifique la versión instalada con:

<code>
mysql --version

</code>

Obtendrá una respuesta parecida a la siguiente:

<code>
mysql  Ver 8.0.28-19 for Linux on x86_64 (Percona Server (GPL), Release 19, Revision 31e88966cd3)

</code>

Ahora utilice la línea de comando propia de MySQL y:

  * Borre la base de datos ''pandora''.
  * Cree una nueva base de datos ''pandora''.
  * Abra la base de datos ''pandora''  e importe el esquema que se encuentra en la Consola web PFMS.
  * Importe los datos que respaldo especial compatible con MySQL 8.

<code>
mysql -u root -p pandora

</code>

<code>
drop database pandora;
create database pandora;
use pandora;
source /var/www/html/pandora_console/pandoradb.sql;
source backup_pandora.sql;

</code>

  * Se debe agregar de nuevo los permisos (//grants//) necesarios; //si no está conectado//  a ''mysql''  como usuario **root**  (sustituya ''<password>''  con la contraseña correspondiente) ejecute:

<code>
mysql -uroot -p<password>

</code>

  * **Una vez conectado como root ejecute los siguientes comandos**:
  * Desactive el //plugin//  de de validación de //password//  (**opcional**).

<code>
UNINSTALL COMPONENT 'file://component_validate_password';

</code>

  * Crear el usuario de conexión **si no existe**:

<code>
CREATE USER "<DBUSER>"@'%' IDENTIFIED BY "<DBPASS>";

</code>

<WRAP center round tip 60%>

//**Nota**//  : si se quiere restringir la dirección IP de conexión a la base de datos, debe cambiar el ''%''  por la dirección IP de la fuente de conexión.

</WRAP>

  * Asignar la //password//  nativa para ''mysql'':

<code>
ALTER USER "<DBUSER>"@'%' IDENTIFIED WITH mysql_native_password BY "<DBPASS>";

</code>

  * Otorgue los //grants//  sobre la base de datos de Pandora FMS (''pandora''):

<code>
GRANT ALL PRIVILEGES ON pandora.* TO "<DBUSER>"@'%';

</code>

  * Guarde los cambios y salga:

<code>
flush privileges;
exit

</code>

Un vez finalizado el trabajo con la base de datos, realice los siguientes pasos:

  * Inicie el servidor PFMS y el Agente Software PFMS:

<code>
/etc/init.d/pandora_server start
/etc/init.d/pandora_agent_daemon start

</code>

  * Inicie el servidor Apache web:

<code>
systemctl start httpd.service

</code>

O bien:

<code>
/etc/init.d/httpd start

</code>

<WRAP center round tip 60%>

Véase también "[[:es:documentation:pandorafms:complex_environments_and_optimization:08_optimization#comprobacion_del_fichero_mycnf|Optimización y solución de problemas]]" para la comprobación del fichero ''my.cnf''.

</WRAP>


===== CentOS 7 =====

<WRAP center round info 60%>

CentOS 7 pronto alcanzará su fin de ciclo de vida (**EOL**). //Esta documentación se conserva por propósitos históricos.//</WRAP>

  * Detenga el servidor PFMS y el Agente Software PFMS:
<code>

/etc/init.d/pandora_server stop
/etc/init.d/pandora_agent_daemon stop

</code>

  * Detenga el servidor Apache web:

<code>
systemctl stop httpd.service

</code>

O bien:

<code>
/etc/init.d/httpd stop

</code>

  * Haga un respaldo especial de la base de datos que sea compatible con MySQL 8:

<code>
mysqldump -u root -p pandora \
  --skip-add-drop-table \
  --complete-insert \
  --no-create-info> backup_pandora.sql

</code>

  * Haga un respaldo tal cual está hecho en MySQL 5.7 (un seguro adicional si tiene que volver a esta versión):

<code>
mysqldump -u root -p pandora> backup_pandora_5.7.sql

</code>

  * Haga un respaldo del fichero de configuración de MySQL (''my.cnf''):

<code>
cp /etc/my.cnf /tmp/my.cnf.BACK

</code>

  * Borre los repositorios de Percona 5:

<code>
rpm -qa | grep Percona-Server | xargs rpm -e --nodeps

</code>

  * Instale los repositorios de Percona 8:
<code>

yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm -y

</code>

  * Habilite los repositorios del paso anterior:

<code>
percona-release setup ps80

</code>

  * Instale Percona 8

<code>
yum install percona-server-server

</code>

  * Restablezca el fichero ''my.cnf'':

<code>
mv /tmp/my.cnf.BACK /etc/my.cnf

</code>

  * Modifique el fichero ''my.cnf''  para prescindir de ''query_cache_*'':

<code>
sed -i -e "s/^query_cache_type.*/#query_cache_type/g" /etc/my.cnf
sed -i -e "s/^query_cache_size.*/#query_cache_size/g" /etc/my.cnf
sed -i -e "s/^query_cache_min_res_unit.*/#query_cache_min_res_unit/g" /etc/my.cnf
sed -i -e "s/^query_cache_limit.*/#query_cache_limit/g" /etc/my.cnf

</code>

  * Si **no tiene un entorno con HA**, deshabilite los //log//  binarios con la siguiente instrucción en la sección ''[mysqld]'':

<code>
skip-log-bin

</code>

<WRAP center round tip 60%>

Véase también "[[:es:documentation:pandorafms:complex_environments_and_optimization:08_optimization#comprobacion_del_fichero_mycnf|Optimización y solución de problemas]]" para la comprobación del fichero ''my.cnf''.

</WRAP>

  * Inicie el servicio MySQL:
<code>

systemctl start mysql

</code>

o bien

<code>
service mysqld start

</code>

  * Verifique la versión instalada con:

<code>
mysql --version

</code>

Obtendrá una respuesta parecida a la siguiente:

<code>
mysql  Ver 8.0.28-19 for Linux on x86_64 (Percona Server (GPL), Release 19, Revision 31e88966cd3)

</code>

  * Ahora utilice la línea de comando propia de MySQL, introduzca la contraseña de usuario **root**  y:
      * Borre la base de datos ''pandora''.
      * Cree una nueva base de datos ''pandora''.
      * Abra la base de datos ''pandora''  e importe el esquema que se encuentra en la Consola web PFMS.
      * Importe los datos que respaldó de manera especial, compatible con MySQL 8.

<code>
mysql -u root -p pandora

</code>

<code>
drop database pandora;
create database pandora;
use pandora;
source /var/www/html/pandora_console/pandoradb.sql;
source backup_pandora.sql;

</code>

  * Se debe agregar de nuevo los permisos (//grants//) necesarios; //si no está conectado//  a ''mysql''  como usuario **root**  (sustituya ''<password>''  con la contraseña correspondiente) ejecute:

<code>
mysql -uroot -p<password>

</code>

  * **Una vez conectado como root ejecute los siguientes comandos**:
  * Desactive el //plugin//  de de validación de //password//  (opcional).

<code>
UNINSTALL COMPONENT 'file://component_validate_password';

</code>

  * Crear el usuario de conexión si no existe:

<code>
CREATE USER "<DBUSER>"@'%' IDENTIFIED BY "<DBPASS>";

</code>

<WRAP center round tip 60%> //**Nota**//  : si se quiere restringir la dirección IP de conexión a la base de datos, debe cambiar el ''%''  por la dirección IP de la fuente de conexión. </WRAP>

  * Asignar la //password//  nativa para ''mysql'':

<code>
ALTER USER "<DBUSER>"@'%' IDENTIFIED WITH mysql_native_password BY "<DBPASS>";

</code>

  * Otorgue los //grants//  sobre la base de datos de Pandora FMS (''pandora''):

<code>
GRANT ALL PRIVILEGES ON pandora.* TO "<DBUSER>"@'%';

</code>

  * Guarde los cambios y salga:

<code>
flush privileges;
exit

</code>

Un vez finalizado el trabajo con la base de datos, realice los siguientes pasos:

  * Inicie el servidor PFMS y el Agente Software PFMS:

<code>
/etc/init.d/pandora_server start
/etc/init.d/pandora_agent_daemon start

</code>

  * Inicie el servidor Apache web:

<code>
systemctl start httpd.service

</code>

O bien:

<code>
/etc/init.d/httpd start

</code>

[[:es:documentation:start|Volver al Índice de Documentación Pandora FMS]]