Versions Compared

Old Version 72

changes.mady.by.user jtel Support

Saved on

compared with

New Version 73

changes.mady.by.user jtel Support

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Content imported from a Scroll Translations translation file.
Sv translation
languageen

The jtel Portal System is moving to use MySQL 8.x instead of the older MySQL 5.6.

Currently, the latest release of the portal 3.15 supports both versions of MySQL, however this is only an interim measure, and this will change in a coming release soon such that MySQL 8.x is required.

This procedure describes how to update the system to MySQL 8.x.

Warning
titleCaution

This is a non trivial operation. Only proceed if you have adequate rollback mechanisms in place, such as snapshots of your virtual machines and a backup of the database.

ALL INSTALLATIONS

  • PORTAL VERSION
    • Make sure the jtel Portal Version is at least 3.15 before starting.

  • OPERATING SYSTEM
    • Make sure the operating system is up to date with all updates on all mysql servers.

INSTALLATIONS WITH REPLICATION

  • Replication Slaves
    • Make sure replication is working before starting

  • Replication Masters
    • Make sure that the binary log format is ROW and not MIXED or STATEMENT
  • PHASE 1
    • Complete phase 1 first for all servers, slaves first, then masters.

  • Master-Master Configurations
    • Stop the other master before updating.
    • Make sure that both masters are 8.x before restarting.

Pre-Requisites

  • The jtel Portal must be updated to the latest version, currently 3.15
  • The operating system must be updated to include all of the latest patches using yum -y update

  • yum-utils must be installed using yum -y install yum-utils

Introduction

This is a multi-stage operation, since the MySQL system does not support missing out updates to versions - to move from 5.6 to 8.0 it is required to first update to 5.7.

Warning
titleCaution

Do not proceed unless the Pre-Requisites are done. The procedure WILL NOT WORK with an earlier version of the jtel Portal installed.

Phase 1 - Ensure existing configuration is good

There are several configuration items which need to be set in the slave configuration before proceeding.

Unfortunately, mysql 5.7 will use a different default binary log and relay log file name during the upgrade process (this is probably a bug), unless these steps are completed. 

Complete this procedure for all slaves (also both masters in master-master replication).

Translations Ignore


Code Block
# Master or slave?
if [ -e /etc/my.cnf.d/jtel-slave.cnf ] 
then
MY_CNF_FILE=/etc/my.cnf.d/jtel-slave.cnf
MASTER_UPDATE=FALSE
fi
if [ -e /etc/my.cnf.d/jtel-master.cnf ] 
then
MY_CNF_FILE=/etc/my.cnf.d/jtel-master.cnf
MASTER_UPDATE=TRUE
fi
if [ ! -z MY_CNF_FILE ] 
then
cat <<EOFF >> $MY_CNF_FILE
relay_log                       = mysqld-relay-bin
relay_log_index                 = mysqld-relay-bin.index
relay_log_info_file             = relay-log.info
EOFF
if [ "$MASTER_UPDATE" == "FALSE" ] 
then
cat <<EOFF >> $MY_CNF_FILE
skip-log-bin
EOFF
fi
fi
MY_CNF_FILE=

# Restart mysql
systemctl restart mysqld.service



Phase 2 - Update MySQL to 5.7

Remember - for replicated installations, start with the slaves first. Then update the masters, one after the other.

Perform clean shutdown of MySQL with innodb_fast_shutdown set to 0

Translations Ignore


Code Block
mysql -u root -p<password> --execute="SET GLOBAL innodb_fast_shutdown=0"
mysqladmin -u root -p<password> shutdown



Remove Old yum repository, and install new yum repository

Remove the old MySQL yum repository.

Translations Ignore


Code Block
yum remove mysql-community-release.noarch



Next, install the new MySQL yum repository, using the command relevant to the OS version being used.

You can determine the OS being used, with the following command:

Translations Ignore


Code Block
cat /etc/centos-release



For CentOS 7:

Translations Ignore


Code Block
yum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm



For CentOS 6:

Translations Ignore


Code Block
yum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el6-3.noarch.rpm



Update MySQL Server to 5.7

This involves clearing the version-lock table, and enabling the 5.7 update path.

Note, the yum command is issued without the -y option. You should check what the system is about to do before confirming this step.

Translations Ignore


Code Block
# Clear versionlock table
yum versionlock clear

# Enable 5.7 
yum-config-manager --disable mysql56-community
yum-config-manager --enable mysql57-community
yum-config-manager --disable mysql80-community

# Update
yum update



Start the MySQL Server (WITHOUT REPLICATION FOR SLAVES AND MASTER-MASTER)

Start the mysql Server without replication.

Translations Ignore


Code Block
titleCentOS 7.x
# Start - IMPORTANT - WITHOUT REPLICATION
systemctl set-environment MYSQLD_OPTS="--skip-slave-start"
systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
# Start - IMPORTANT - WITHOUT REPLICATION
mysqld_safe --skip-slave-start &



Run mysql_upgrade

Either change the password in the following command, or simply use the -p option without specifying a password, and entering it at the prompt.

Translations Ignore


Code Block
mysql_upgrade -u root -p<password>



Check the output from this phase before proceeding - if this procedure is showing non-recoverable error messages, then the procedure has gone wrong, and you must rollback here.

Next restart the MySQL server.

Translations Ignore


Code Block
titleCentOS 7.x
systemctl stop mysqld.service
systemctl set-environment MYSQLD_OPTS=
systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
service mysqld stop
service mysqld start



Check Database and Replication and Version are OK

Translations Ignore


Code Block
mysql -u root -p<password> -e "SHOW SLAVE STATUS\G SELECT VERSION();"



Only proceed if no errors are found.

Warning
titleNote

The jtel Portal is NOT compatible with MySQL 5.7 - you must continue the upgrade path to 8.x at this point.

Upgrade ALL Servers to 5.7 before proceeding.

Phase 3 - Update MySQL to 8.0

Warning
titleCaution

Proceeding after this point without Version 3.15 or later of the jtel Portal installed, will break the database, and a rollback will be necessary.

Remember - first the slaves, then the masters. One after the other.

Perform clean shutdown of MySQL with innodb_fast_shutdown set to 0

Translations Ignore


Code Block
mysql -u root -p<password> --execute="SET GLOBAL innodb_fast_shutdown=0"
mysqladmin -u root -p<password> shutdown



Enable 8.0 repoitories and update the server

Note, the yum command is issued without the -y option. You should check what the system is about to do before confirming this step.

Translations Ignore


Code Block
# Enable 8.x
yum-config-manager --disable mysql56-community
yum-config-manager --disable mysql57-community
yum-config-manager --enable mysql80-community

# Update to 8.x
yum update



Start the MySQL Server

Start the mysql Server.

Translations Ignore


Code Block
titleCentOS 7.x
systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
service mysqld start



Note, that starting the mysql server may take some time. It may even appear to be hung, but wait for a few minutes and let it complete.

Warning
titlemysql_upgrade

mysql_upgrade is run automatically by all current 8.x versions of MySQL Server.

The output of mysql_upgrade can be found in /var/log/mysqld.log and errors will be in /var/log/messages

Check these files for errors.

Check Database and Replication and Version are OK

Translations Ignore


Code Block
mysql -u root -p<password> -e "SHOW SLAVE STATUS\G SELECT VERSION();"



Phase 4 - Configure Other Components

Portal

Run the Portal update script again. This will optimise the scripts for MySQL 8.x.

Translations Ignore


Code Block
sudo /home/jtel/shared/JTELCarrierPortal/Update/update_release.sh



JBOSS Server

EITHER: Install new Version of JBOSS Server

You can simply install the new version of the JBOSS Server, at least jboss-as-7.1.1.FINAL.14.tar.gz from cdn.jtel.de.

This contains the required components, but will require that the hazelcast.xml and standalone-full.xml files are updated as described in the installation of the webserver, see here: Role WEB

OR: Update the JBOSS Server

The JBOSS server requires a new connector to attach to MySQL 8.x.

This can be copied to the JBOSS server instance, using the following command (run for example from /home/jtel/shared/JTELCarrierPortal/Update), as the jtel user:

Translations Ignore


Code Block
./update_jboss.sh



Change stanalone-full.xml

The standalone-full.xml configuration file requires some modifications.

A new connection property must be added to the datasource configurations for MySQL. This must be added to the datasource configurations for JTELWeb, JTELWebSlave, JTELStats, JTELLog and JTELReports.

See the following example:

Translations Ignore


Code Block
...
<datasource jndi-name="java:jboss/datasources/JTELLog" pool-name="JTELLog" enabled="true">
    <connection-url>jdbc:mysql://testdb2:3306/JTELLog</connection-url>
        #
        # THIS SECTION NEEDS TO BE ADDED
        #
        <connection-property name="useSSL">
            false
        </connection-property>
...



In the drivers section, make sure that the driver class line is included for the mysql driver.

This will only be missing on very old jboss installations, if this is the case, it might be better to update the jboss server to a new release completely.

Translations Ignore


Code Block
...
<drivers>
    <driver name="com.mysql" module="com.mysql">
        #
        # MAKE SURE THIS NEXT LINE IS PRESENT.
        #
        <driver-class>com.mysql.jdbc.Driver</driver-class>
        ...



Reconfigure 8-Server ODBC Connections

The Rollback string for MySQL Versions 8.x (in fact MySQL 5.7) and higher has changed, and will need to be reconfigured in 8-Server. 

The new rollback string is:

Translations Ignore


Code Block
DO RELEASE_ALL_LOCKS(); ROLLBACK;



8-Server should be restarted after making this change:

Troubleshooting

jtel Portal DB Script fails with "Failed to load caching_sha2_password authentication plugin"

The DB scripts are being run from a different server than the updated MySQL server(s). 

This is good! You should run them from the role STORE.

However, you will need to update the mysql client on these machines too. Do this (change the second line for CentOS 6.x - see above for the RPM required):

Translations Ignore


Code Block
yum remove mysql-community-release.noarch
yum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
yum update mysql*



Now run the scripts again.

jtel Portal DB Script fails with "Duplicate Entry"

Try running the DB script again.

Authentication Failed with some DB Tools

For example, earlier versions of DB Forge will fail when connecting to MySQL 8.x.

Update the tool.

Slave Fails to Start with Error ERROR 1872 (HY000): Slave failed to initialize relay log info structure from the repository

The following series of commands issed in mysql might sometimes help to restart the slave, without rebuilding replication from scratch:

Translations Ignore


Code Block
RESET SLAVE;
START SLAVE IO_THREAD;
STOP SLAVE IO_THREAD;
RESET SLAVE;
START SLAVE;



Upgrade to MySQL 8.x Fails

If the upgrade to 8.x fails, try rolling back to 5.7 as follows, and resolve the problem in 5.7 before proceeding.

Translations Ignore


Code Block
# Enable 5.7
yum-config-manager --disable mysql56-community
yum-config-manager --enable mysql57-community
yum-config-manager --disable mysql80-community


# Uninstall
yum -y remove mysql-community-server
yum -y remove mysql-community-client
yum -y remove mysql-community-libs
yum -y remove mysql-community-common


# Install
yum -y install mysql-community-server





Sv translation
languagede

Das jtel-Portalsystem geht dazu über, MySQL 8.x anstelle des älteren MySQL 5.6 zu verwenden.

Derzeit unterstützt die neueste Version des Portals 3.15 beide Versionen von MySQL, dies ist jedoch nur eine Übergangsmaßnahme, und dies wird sich in einer kommenden Version bald ändern, so dass MySQL 8.x erforderlich ist.

Diese Prozedur beschreibt, wie Sie das System auf MySQL 8.x aktualisieren.

Warning
titleCaution

Dies ist eine non trivial Operation. Fahren Sie nur fort, wenn Sie über geeignete Rollback-Mechanismen verfügen, wie z.B. Snapshots Ihrer virtuellen Maschinen und ein Backup der Datenbank.

ALLE INSTALLATIONEN

  • PORTAL VERSION
    • Stellen Sie sicher, dass die jtel Portal Version mindestens 3.15 ist, bevor Sie beginnen.

  • Betriebssystem
    • Stellen Sie sicher, dass das Betriebssystem mit allen Aktualisierungen auf allen mysql-Servern auf dem neuesten Stand ist.

INSTALLATIONEN MIT REPLIKATION

  • Replication Slaves
    • Stellen Sie sicher, dass die Replikation funktioniert, bevor Sie beginnen

  • Replication Masters
    • Stellen Sie sicher, dass das binäre Protokollformat ROW und nicht MIXED oder STATEMENT ist
  • PHASE 1
    • Schließen Sie Phase 1 zunächst für alle Server ab, zuerst für die Slaves, dann für die Masters.

  • Master-Master Konfigurationen
    • Halten Sie den anderen Master vor der Aktualisierung an.
    • Stellen Sie sicher, dass beide Master 8.x sind, bevor Sie neu starten.

Voraussetzungen

  • Das jtel-Portal muss auf die neueste Version, derzeit 3.15, aktualisiert werden.
  • Das Betriebssystem muss mit yum -y update auf den neuesten Stand gebracht werden, damit es alle aktuellen Patches enthält

  • yum-utils muss mit yum -y install yum-utils installiert werden

Einführung

Dies ist eine mehrstufige Operation, da das MySQL-System nicht unterstützt, dass Aktualisierungen von Versionen ausgelassen werden - um von 5.6 auf 8.0 zu wechseln, ist es erforderlich, zuerst auf 5.7 zu aktualisieren.

Warning
titleAchtung

Fahren Sie erst fort, wenn die Voraussetzungen erfüllt sind. Das Verfahren WIRD NICHT FUNKTIONIEREN, wenn eine frühere Version des jtel-Portals installiert ist.

Phase 1 - Sicherstellen, dass die bestehende Konfiguration gut ist

Es gibt mehrere Konfigurationselemente, die in der Slave-Konfiguration eingestellt werden müssen, bevor Sie fortfahren können

Leider wird mysql 5.7 während des Upgrade-Prozesses einen anderen Standard-Binär-Log- und Relay-Log-Dateinamen verwenden (dies ist wahrscheinlich ein Bug), es sei denn, diese Schritte werden befolgt. 

Führen Sie dieses Verfahren für alle Slaves durch (auch für beide Master bei der Master-Master-Replikation).

Translations Ignore


Code Block
# Master or slave?
if [ -e /etc/my.cnf.d/jtel-slave.cnf ] 
then
MY_CNF_FILE=/etc/my.cnf.d/jtel-slave.cnf
MASTER_UPDATE=FALSE
fi
if [ -e /etc/my.cnf.d/jtel-master.cnf ] 
then
MY_CNF_FILE=/etc/my.cnf.d/jtel-master.cnf
MASTER_UPDATE=TRUE
fi
if [ ! -z MY_CNF_FILE ] 
then
cat <<EOFF >> $MY_CNF_FILE
relay_log                       = mysqld-relay-bin
relay_log_index                 = mysqld-relay-bin.index
relay_log_info_file             = relay-log.info
EOFF
if [ "$MASTER_UPDATE" == "FALSE" ] 
then
cat <<EOFF >> $MY_CNF_FILE
skip-log-bin
EOFF
fi
fi
MY_CNF_FILE=

# Restart mysql
systemctl restart mysqld.service



Phase 2 - Update MySQL auf 5.7

Denken Sie daran - beginnen Sie bei replizierten Installationen zuerst mit den Slaves. Aktualisieren Sie dann die Master, einen nach dem anderen.

Durchführen eines sauberen Shutdowns von MySQL mit innodb_fast_shutdown auf 0

Translations Ignore


Code Block
mysql -u root -p<password> --execute="SET GLOBAL innodb_fast_shutdown=0"
mysqladmin -u root -p<password> shutdown



Altes yum-Repository entfernen und neues yum-Repository installieren

Entfernen Sie das alte MySQL yum-Repository.

Translations Ignore


Code Block
yum remove mysql-community-release.noarch



Als nächstes installieren Sie das neue MySQL yum-Repository mit dem Befehl, der für die verwendete Betriebssystemversion relevant ist.

Mit dem folgenden Befehl können Sie das verwendete Betriebssystem bestimmen:

Translations Ignore


Code Block
cat /etc/centos-release



Für CentOS 7:

Translations Ignore


Code Block
yum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm



Für CentOS 6:

Translations Ignore


Code Block
yum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el6-3.noarch.rpm



Update MySQL Server auf 5.7

Dazu gehört das Bereinigen der Versionlock-Tabelle und das Aktivieren des 5.7 Update-Pfades.

Beachten Sie, dass der Befehl yum ohne die Option -y ausgeführt wird. Sie sollten prüfen, was das System vorhat, bevor Sie diesen Schritt bestätigen.

Translations Ignore


Code Block
# Versionlock-Tabelle bereinigen
yum versionlock clear

# Enable 5.7 
yum-config-manager --disable mysql56-community
yum-config-manager --enable mysql57-community
yum-config-manager --disable mysql80-community

# Update
yum update



Starten Sie den MySQL-Server (OHNE REPLIKATION FÜR SLAVES und MASTER-MASTER)

Starten Sie den mysql Server ohne Replikation.

Translations Ignore


Code Block
titleCentOS 7.x
# Start - IMPORTANT - WITHOUT REPLICATION
systemctl set-environment MYSQLD_OPTS="--skip-slave-start"
systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
# Start - IMPORTANT - WITHOUT REPLICATION
mysqld_safe --skip-slave-start &



mysql_upgrade ausführen

Entweder ändern Sie das Passwort im folgenden Befehl, oder Sie verwenden einfach die Option -p, ohne ein Passwort anzugeben, und geben es an der Eingabeaufforderung ein.

Translations Ignore


Code Block
mysql_upgrade -u root -p<password>



Überprüfen Sie die Ausgabe aus dieser Phase, bevor Sie fortfahren - wenn dieses Verfahren nicht behebbare Fehlermeldungen anzeigt, dann ist das Verfahren schief gelaufen, und Sie müssen hier ein Rollback durchführen.

Starten Sie als nächstes den MySQL-Server neu.

Translations Ignore


Code Block
titleCentOS 7.x
systemctl stop mysqld.service
systemctl set-environment MYSQLD_OPTS=
systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
service mysqld stop
service mysqld start



Prüfen, ob Datenbank und Replikation und Version in Ordnung sind

Translations Ignore


Code Block
mysql -u root -p<password> -e "SHOW SLAVE STATUS\G SELECT VERSION();"



Fahren Sie nur fort, wenn keine Fehler gefunden werden.

Warning
titleHinweis

Das jtel-Portal ist NICHT mit MySQL 5.7 kompatibel. - Sie müssen den Upgrade-Pfad auf 8.x an dieser Stelle fortsetzen.

Aktualisieren Sie ALLE Server auf 5.7, bevor Sie fortfahren.

Phase 3 - Update MySQL auf 8.0

Warning
titleAchtung

Wenn Sie nach diesem Punkt fortfahren, ohne dass Version 3.15 oder später des jtel-Portals installiert ist, zerstört die Datenbank, und ein Rollback ist erforderlich.

Denken Sie daran - erst die Slaves, dann die Master. Einer nach dem anderen.

Durchführen eines sauberen Shutdowns von MySQL mit innodb_fast_shutdown auf 0

Translations Ignore


Code Block
mysql -u root -p<password> --execute="SET GLOBAL innodb_fast_shutdown=0"
mysqladmin -u root -p<password> shutdown



8.0-Repositorys aktivieren und den Server aktualisieren

Beachten Sie, dass der Befehl yum ohne die Option -y ausgführt wird. Sie sollten prüfen, was das System vorhat, bevor Sie diesen Schritt bestätigen.

Translations Ignore


Code Block
# Enable 8.x
yum-config-manager --disable mysql56-community
yum-config-manager --disable mysql57-community
yum-config-manager --enable mysql80-community

# Update to 8.x
yum update



Starten Sie den MySQL-Server

Starten Sie den mysql Server.

Translations Ignore


Code Block
titleCentOS 7.x
systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
service mysqld start



Beachten Sie, dass das Starten des mysql-Servers einige Zeit dauern kann. Es mag sogar so aussehen, als sei es aufgehangen, aber warten Sie ein paar Minuten und lassen Sie es fertigstellen.

Warning
titlemysql_upgrade

mysql_upgrade wird automatisch von allen aktuellen 8.x-Versionen von MySQL Server ausgeführt.

Der Output von mysql_upgrade befindet sich in /var/log/mysqld.log und Fehler werden in /var/log/messages gefunden

Überprüfen Sie diese Dateien auf Fehler.

Prüfen, ob Datenbank und Replikation und Version in Ordnung sind

Translations Ignore


Code Block
mysql -u root -p<password> -e "SHOW SLAVE STATUS\G SELECT VERSION();"



Phase 4 - Andere Komponenten konfigurieren

Portal

Führen Sie das Portal-Aktualisierungsskript erneut aus. Dadurch werden die Skripte für MySQL 8.x optimiert.

Translations Ignore


Code Block
sudo /home/jtel/shared/JTELCarrierPortal/Update/update_release.sh



JBOSS Server

Entweder: Neue Version von JBOSS Server installieren

Sie können einfach die neue Version des JBOSS-Servers installieren, mindestens jboss-as-7.1.1.FINAL.14.tar.gz von cdn.jtel.de.

Diese enthält die erforderlichen Komponenten, erfordert jedoch, dass die Dateien hazelcast.xml und standalone-full.xml aktualisiert werden, wie bei der Installation des Webservers beschrieben, siehe hier: Role WEB

Oder: Updaten des JBOSS-Servers

Der JBOSS-Server benötigt einen neuen Konnektor, um sich mit MySQL 8.x zu verbinden.

Diese kann mit dem folgenden Befehl (z.B. von /home/jtel/shared/JTELCarrierPortal/Update aus ausführen) als jtel-Benutzer auf die JBOSS-Serverinstanz kopiert werden:

Translations Ignore


Code Block
./update_jboss.sh



Standalone-full.xml ändern

Die Konfigurationsdatei standalone-full.xml erfordert einige Änderungen.

Eine neue Verbindungseigenschaft muss zu den Datasource-Konfigurationen für MySQL hinzugefügt werden. Dies muss zu den Datasource-Konfigurationen für JTELWeb, JTELWebSlave, JTELStats, JTELLog und JTELReports hinzugefügt werden.

Siehe das folgende Beispiel:

Translations Ignore


Code Block
...
<datasource jndi-name="java:jboss/datasources/JTELLog" pool-name="JTELLog" enabled="true">
    <connection-url>jdbc:mysql://testdb2:3306/JTELLog</connection-url>
        #
        # THIS SECTION NEEDS TO BE ADDED
        #
        <connection-property name="useSSL">
            false
        </connection-property>
...



Stellen Sie im Abschnitt drivers sicher, dass die Zeile driver class für den mysql-Treiber enthalten ist.

Dies wird nur bei sehr alten jboss-Installationen fehlen. Wenn dies der Fall ist, ist es vielleicht besser, den jboss-Server komplett auf eine neue Version zu aktualisieren..

Translations Ignore


Code Block
...
<drivers>
    <driver name="com.mysql" module="com.mysql">
        #
        # MAKE SURE THIS NEXT LINE IS PRESENT.
        #
        <driver-class>com.mysql.jdbc.Driver</driver-class>
        ...



8-Server-ODBC-Verbindungen rekonfigurieren

Der Rollback-String für MySQL-Versionen 8.x (eigentlich MySQL 5.7) und höher hat sich geändert und muss in 8-Server neu konfiguriert werden. 

Die neue Rollback-String ist:

Translations Ignore


Code Block
DO RELEASE_ALL_LOCKS(); ROLLBACK;



8-Server sollte nach dieser Änderung neu gestartet werden:

Fehlerbehebung

jtel Portal DB-Skript schlägt fehl mit "Failed to load caching_sha2_password authentication plugin"

Die DB-Skripte werden von einem anderen Server als dem/den aktualisierten MySQL-Server(n) ausgeführt. 

Das ist gut! Sie sollten sie von der Rolle STORE aus ausführen.

Allerdings müssen Sie auch auf diesen Maschinen den mysql-Client aktualisieren. Tun Sie dies (ändern Sie die zweite Zeile für CentOS 6.x - siehe oben für die erforderliche RPM):

Translations Ignore


Code Block
yum remove mysql-community-release.noarch
yum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
yum update mysql*



Führen Sie nun die Skripte erneut aus.

jtel Portal DB-Skript schlägt fehl mit "Duplicate Entry"

Versuchen Sie, das DB-Skript erneut auszuführen.

Authentifizierung bei einigen DB-Tools fehlgeschlagen

Beispielsweise schlagen frühere Versionen von DB Forge beim Verbinden mit MySQL 8.x fehl.

Aktualisieren Sie das Tool.

Sklave startet nicht mit Fehler "ERROR 1872 (HY000): Slave failed to initialize relay log info structure from the repository"

Die folgende Reihe von Befehlen, die in mysql ausgeführt werden, kann manchmal helfen, den Slave neu zu starten, ohne die Replikation von Grund auf neu aufzubauen:

Translations Ignore


Code Block
RESET SLAVE;
START SLAVE IO_THREAD;
STOP SLAVE IO_THREAD;
RESET SLAVE;
START SLAVE;



Upgrade auf MySQL 8.x schlägt fehl

Wenn das Upgrade auf 8.x fehlschlägt, versuchen Sie, wie folgt auf 5.7 zurückzusetzen und das Problem in 5.7 zu lösen, bevor Sie fortfahren.

Translations Ignore


Code Block
# Enable 5.7
yum-config-manager --disable mysql56-community
yum-config-manager --enable mysql57-community
yum-config-manager --disable mysql80-community


# Uninstall
yum -y remove mysql-community-server
yum -y remove mysql-community-client
yum -y remove mysql-community-libs
yum -y remove mysql-community-common


# Install
yum -y install mysql-community-server




Sv translation
languagefr

Le système de portail de jtel utilise désormais MySQL 8.x au lieu de l'ancienne version MySQL 5.6.

Actuellement, la dernière version du portail 3.15 supporte les deux versions de MySQL, mais ce n'est qu'une mesure provisoire, et cela changera dans une prochaine version de sorte que MySQL 8.x sera nécessaire.

Cette procédure décrit comment mettre à jour le système vers MySQL 8.x.

Warning
titleAttention

Il s'agit d'une opération non négligeable. Ne procédez à cette opération que si vous disposez de mécanismes de retour en arrière adéquats, tels que des instantanés de vos machines virtuelles et une sauvegarde de la base de données.

TOUTES LES INSTALLATIONS

  • VERSION PORTAL
    • Assurez-vous que la version du portail jtel est au moins 3.15 avant de commencer.

  • SYSTÈME D'EXPLOITATION
    • Assurez-vous que le système d'exploitation est à jour avec toutes les mises à jour sur tous les serveurs mysql.

INSTALLATIONS AVEC RÉPLICATION

  • Esclaves de la réplication
    • Assurez-vous que la réplication fonctionne avant de commencer

  • Maîtres de la réplication
    • Assurez-vous que le format du journal binaire est LIGNE et non pas MIXTE ou DÉCLARATION
  • PHASE 1
    • Terminer la phase 1 d'abord pour tous les serveurs, les esclaves d'abord, puis les maîtres.

  • Configurations Master-Master
    • Arrêtez l'autre maître avant la mise à jour.
    • Assurez-vous que les deux maîtres sont 8.x avant de redémarrer.

Prérequis

  • Le portail jtel doit être mis à jour avec la dernière version, actuellement 3.15
  • Le système d'exploitation doit être mis à jour pour inclure tous les derniers correctifs utilisant yum -y update

  • yum-utils doit être installé en utilisant yum -y install yum-utils

Introduction

Il s'agit d'une opération en plusieurs étapes, puisque le système MySQL ne prend pas en charge les mises à jour manquantes des versions - pour passer de la version 5.6 à la version 8.0, il faut d'abord mettre à jour la version 5.7.

Warning
titleAttention

Ne procédez pas à l'opération si les conditions préalables ne sont pas remplies. La procédure NE FONCTIONNERA PAS avec une version antérieure du portail jtel installée.

Phase 1 - S'assurer que la configuration existante est bonne

Il y a plusieurs éléments de configuration qui doivent être réglés dans la configuration de l'esclave avant de procéder.

Malheureusement, mysql 5.7 utilisera un nom de fichier journal binaire et de relais par défaut différent pendant le processus de mise à niveau (c'est probablement un bogue), à moins que ces étapes ne soient terminées. 

Complétez cette procédure pour tous les esclaves (également les deux maîtres dans la réplication maître-maître).

Translations Ignore


Code Block
# Master or slave? if [ -e /etc/my.cnf.d/jtel-slave.cnf ] then MY_CNF_FILE=/etc/my.cnf.d/jtel-slave.cnf MASTER_UPDATE=FALSE fi if [ -e /etc/my.cnf.d/jtel-master.cnf ] then MY_CNF_FILE=/etc/my.cnf.d/jtel-master.cnf MASTER_UPDATE=TRUE fi if [ ! -z MY_CNF_FILE ] then cat <<EOFF >> $MY_CNF_FILE relay_log = mysqld-relay-bin relay_log_index = mysqld-relay-bin.index relay_log_info_file = relay-log.info EOFF if [ "$MASTER_UPDATE" == "FALSE" ] then cat <<EOFF >> $MY_CNF_FILE skip-log-bin EOFF fi fi MY_CNF_FILE= # Restart mysql systemctl restart mysqld.service



Phase 2 - Mise à jour de MySQL à 5.7

N'oubliez pas - pour les installations reproduites, commencez par les esclaves. Ensuite, mettez à jour les maîtres, l'un après l'autre.

Effectuer un arrêt propre de MySQL avec innodb_fast_shutdown réglé sur 0

Translations Ignore


Code Block
mysql -u root -p<password> --execute="SET GLOBAL innodb_fast_shutdown=0" mysqladmin -u root -p<password> shutdown



Supprimer l'ancien dépôt Yum et installer le nouveau dépôt Yum

Supprimer l'ancien dépôt MySQL yum.

Translations Ignore


Code Block
yum remove mysql-community-release.noarch



Ensuite, installez le nouveau dépôt MySQL yum, en utilisant la commande correspondant à la version du système d'exploitation utilisée.

Vous pouvez déterminer le système d'exploitation utilisé, avec la commande suivante :

Translations Ignore


Code Block
cat /etc/centos-release



Pour CentOS 7:

Translations Ignore


Code Block
yum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm



Pour CentOS 6:

Translations Ignore


Code Block
yum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el6-3.noarch.rpm



Mettre à jour le serveur MySQL à 5.7

Cela implique d'effacer la table de verrouillage des versions et d'activer le chemin de mise à jour 5.7.

Notez que la commande yum est émise sans l'option -y. Vous devez vérifier ce que le système est sur le point de faire avant de confirmer cette étape.

Translations Ignore


Code Block
# Clear versionlock table yum versionlock clear # Enable 5.7 yum-config-manager --disable mysql56-community yum-config-manager --enable mysql57-community yum-config-manager --disable mysql80-community # Update yum update



Démarrer le serveur MySQL (SANS REPRISE D'ESCLAVES ET DE MASTER-MASTER)

Démarrez le serveur mysql sans réplication.

Translations Ignore


Code Block
titleCentOS 7.x
# Début - IMPORTANT - SANS REPLIQUE systemctl set-environment MYSQLD_OPTS="--skip-slave-start" systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
# Début - IMPORTANT - SANS REPLIQUE mysqld_safe --skip-slave-start &



Lancer mysql_upgrade

Vous pouvez soit changer le mot de passe dans la commande suivante, soit utiliser simplement l'option -p sans spécifier de mot de passe, et le saisir à l'invite.

Translations Ignore


Code Block
mysql_upgrade -u root -p<password>



Vérifiez le résultat de cette phase avant de poursuivre - si cette procédure affiche des messages d'erreur non récupérables, c'est que la procédure s'est mal déroulée, et vous devez revenir en arrière ici.

Ensuite, redémarrez le serveur MySQL.

Translations Ignore


Code Block
titleCentOS 7.x
systemctl stop mysqld.service systemctl set-environment MYSQLD_OPTS= systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
service mysqld stopservice mysqld start



Vérifier que la base de données, la réplication et la version sont correctes

Translations Ignore


Code Block
mysql -u root -p<password> -e "SHOW SLAVE STATUS\G SELECT VERSION();"



Ne procédez que si aucune erreur n'est trouvée.

Warning
titleNote

Le portail jtel n'est PAS compatible avec MySQL 5.7 - vous devez continuer la mise à niveau vers 8.x à ce stade.

Mettre à jour TOUS les serveurs à 5.7 avant de procéder.

Phase 3 - Mise à jour de MySQL à 8.0

Warning
titleAttention

Procéder après ce point sans que la version 3.15 ou plus récente du portail jtel soit installée brisera la base de données, et un retour en arrière sera nécessaire.

Souvenez-vous - d'abord les esclaves, puis les maîtres. L'un après l'autre.

Effectuer un arrêt propre de MySQL avec innodb_fast_shutdown réglé sur 0

Translations Ignore


Code Block
mysql -u root -p<password> --execute="SET GLOBAL innodb_fast_shutdown=0" mysqladmin -u root -p<password> shutdown



Activer les référentiels 8.0 et mettre à jour le serveur

Notez que la commande yum est émise sans l'option -y. Vous devez vérifier ce que le système est sur le point de faire avant de confirmer cette étape.

Translations Ignore


Code Block
# Enable 8.x yum-config-manager --disable mysql56-community yum-config-manager --disable mysql57-community yum-config-manager --enable mysql80-community # Update to 8.x yum update



Démarrer le serveur MySQL

Démarrer le serveur mysql

Translations Ignore


Code Block
titleCentOS 7.x
systemctl start mysqld.service



Translations Ignore


Code Block
titleCentOS 6.x
service mysqld start



Notez que le démarrage du serveur mysql peut prendre un certain temps. Il peut même sembler être suspendu, mais attendez quelques minutes et laissez le tout se dérouler.

Warning
titlemysql_upgrade

mysql_upgrade est exécuté automatiquement par toutes les versions 8.x actuelles du serveur MySQL.

La sortie de mysql_upgrade peut être trouvée dans /var/log/mysqld.log et les erreurs seront dans /var/log/messages

Vérifiez que ces fichiers ne contiennent pas d'erreurs.

Vérifier que la base de données, la réplication et la version sont correctes

Translations Ignore


Code Block
mysql -u root -p<password> -e "SHOW SLAVE STATUS\G SELECT VERSION();"



Phase 4 - Configuration des autres composantes

Portail

Exécutez à nouveau le script de mise à jour du portail. Cela permettra d'optimiser les scripts pour MySQL 8.x.

Translations Ignore


Code Block
sudo /home/jtel/shared/JTELCarrierPortal/Update/update_release.sh



Serveur JBOSS

SOIT: Installateur de la nouvelle version de Serveur JBOSS

Vous pouvez simplement installer la nouvelle version du serveur JBOSS, au moins jboss-as-7.1.1.FINAL.14.tar.gz de cdn.jtel.de.

Il contient les éléments requis, mais exigera que le hazelcast.xml et standalone-full.xml sont mis à jour comme décrit dans l'installation du serveur web, voir ici : Role WEB

OU: Mettre à jour le serveur JBOSS

Le serveur JBOSS nécessite un nouveau connecteur pour se connecter à MySQL 8.x.

Celui-ci peut être copié sur l'instance du serveur JBOSS, en utilisant la commande suivante (exécuter par exemple à partir de /home/jtel/shared/JTELCarrierPortal/Update), comme l'utilisateur de jtel :

Translations Ignore


Code Block
./update_jboss.sh



Changer stanalone-full.xml

La fichier de standalone-full.xml configuration nécessite quelques modifications.

Une nouvelle propriété de connexion doit être ajoutée aux configurations des sources de données pour MySQL. Elle doit être ajoutée aux configurations des sources de données pour JTELWeb, JTELWebSlave, JTELStats, JTELLog et JTELReports.

Voir l'exemple suivant :

Translations Ignore


Code Block
... <datasource jndi-name="java:jboss/datasources/JTELLog" pool-name="JTELLog" enabled="true"> <connection-url>jdbc:mysql://testdb2:3306/JTELLog</connection-url> # # THIS SECTION NEEDS TO BE ADDED # <connection-property name="useSSL"> false </connection-property> ...



Dans la section des conducteurs, assurez-vous que la ligne de la classe du conducteur est incluse pour le conducteur mysql.

Cela ne manquera que sur les très anciennes installations de jboss, si c'est le cas, il pourrait être préférable de mettre à jour le serveur jboss avec une nouvelle version complète.

Translations Ignore


Code Block
... <drivers> <driver name="com.mysql" module="com.mysql"> # # MAKE SURE THIS NEXT LINE IS PRESENT. # <driver-class>com.mysql.jdbc.Driver</driver-class> ...



Reconfigurer les connexions ODBC à 8-Server

La chaîne de Rollback pour les versions MySQL 8.x (en fait MySQL 5.7) et supérieures a changé, et devra être reconfigurée en 8-Server. 

La nouvelle ficelle du rollback est :

Translations Ignore


Code Block
DO RELEASE_ALL_LOCKS(); ROLLBACK;



8-Server doit être redémarré après avoir effectué ce changement :

Dépannage

jtel Portal DB Script échoue avec le "Failed to load caching_sha2_password authentication plugin".

Les scripts de la base de données sont exécutés à partir d'un serveur différent du ou des serveurs MySQL mis à jour. 

C'est bien ! Vous devriez les diriger depuis le rôle STORE.

Cependant, vous devrez également mettre à jour le client mysql sur ces machines. Faites-le (changez la deuxième ligne pour CentOS 6.x - voir ci-dessus pour le RPM requis) :

Translations Ignore


Code Block
yum remove mysql-community-release.noarchyum -y localinstall https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpmyum update mysql*



Maintenant, refaites les scripts.

jtel Portal DB Script échoue avec "Duplicate Entry".

Essayez d'exécuter à nouveau le script DB.

Échec de l'authentification avec certains outils de la base de données

Par exemple, les versions antérieures de DB Forge échoueront lors de la connexion à MySQL 8.x.

Mettre à jour l'outil.

L'esclave ne démarre pas avec l'erreur ERROR 1872 (HY000) : L'esclave n'a pas réussi à initialiser la structure d'information du journal de relais à partir du dépôt

Les séries de commandes suivantes émises dans mysql peuvent parfois aider à redémarrer l'esclave, sans avoir à reconstruire la réplication à partir de zéro :

Translations Ignore


Code Block
RESET SLAVE;START SLAVE IO_THREAD;STOP SLAVE IO_THREAD;RESET SLAVE;START SLAVE;



La mise à niveau vers MySQL 8.x échoue

Si la mise à niveau vers la version 8.x échoue, essayez de revenir à la version 5.7 comme suit, et résolvez le problème dans la version 5.7 avant de continuer.

Translations Ignore


Code Block
# Enable 5.7yum-config-manager --disable mysql56-communityyum-config-manager --enable mysql57-communityyum-config-manager --disable mysql80-community# Uninstallyum -y remove mysql-community-serveryum -y remove mysql-community-clientyum -y remove mysql-community-libsyum -y remove mysql-community-common# Installyum -y install mysql-community-server