Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
Pre-Requisites
IntroductionThis 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.
Phase 1 - Ensure existing configuration is goodThere 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).
Phase 2 - Update MySQL to 5.7Remember - 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
Remove Old yum repository, and install new yum repositoryRemove the old MySQL yum repository.
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:
For CentOS 7:
For CentOS 6:
Update MySQL Server to 5.7This 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.
Start the MySQL Server (WITHOUT REPLICATION FOR SLAVES AND MASTER-MASTER)Start the mysql Server without replication.
Run mysql_upgradeEither change the password in the following command, or simply use the -p option without specifying a password, and entering it at the prompt.
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.
Check Database and Replication and Version are OK
Only proceed if no errors are found.
Phase 3 - Update MySQL to 8.0
Perform clean shutdown of MySQL with innodb_fast_shutdown set to 0
Enable 8.0 repoitories and update the serverNote, the yum command is issued without the -y option. You should check what the system is about to do before confirming this step.
Start the MySQL ServerStart the mysql Server.
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.
Check Database and Replication and Version are OK
Phase 4 - Configure Other ComponentsPortalRun the Portal update script again. This will optimise the scripts for MySQL 8.x.
JBOSS ServerEITHER: Install new Version of JBOSS ServerYou 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: Rolle WEB OR: Update the JBOSS ServerThe 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:
Change stanalone-full.xmlThe 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:
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.
Reconfigure 8-Server ODBC ConnectionsThe 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:
8-Server should be restarted after making this change: Troubleshootingjtel 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):
Now run the scripts again. jtel Portal DB Script fails with "Duplicate Entry"Try running the DB script again. Authentication Failed with some DB ToolsFor 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 repositoryThe following series of commands issed in mysql might sometimes help to restart the slave, without rebuilding replication from scratch:
Upgrade to MySQL 8.x FailsIf the upgrade to 8.x fails, try rolling back to 5.7 as follows, and resolve the problem in 5.7 before proceeding.
|
Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
Pre-Requisites
IntroductionThis 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.
Phase 1 - Ensure existing configuration is goodThere 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).
Phase 2 - Update MySQL to 5.7Remember - 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
Remove Old yum repository, and install new yum repositoryRemove the old MySQL yum repository.
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:
For CentOS 7:
For CentOS 6:
Update MySQL Server to 5.7This 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.
Start the MySQL Server (WITHOUT REPLICATION FOR SLAVES AND MASTER-MASTER)Start the mysql Server without replication.
Run mysql_upgradeEither change the password in the following command, or simply use the -p option without specifying a password, and entering it at the prompt.
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.
Check Database and Replication and Version are OK
Only proceed if no errors are found.
Phase 3 - Update MySQL to 8.0
Perform clean shutdown of MySQL with innodb_fast_shutdown set to 0
Enable 8.0 repoitories and update the serverNote, the yum command is issued without the -y option. You should check what the system is about to do before confirming this step.
Start the MySQL ServerStart the mysql Server.
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.
Check Database and Replication and Version are OK
Phase 4 - Configure Other ComponentsPortalRun the Portal update script again. This will optimise the scripts for MySQL 8.x.
JBOSS ServerEITHER: Install new Version of JBOSS ServerYou 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: Rolle WEB OR: Update the JBOSS ServerThe 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:
Change stanalone-full.xmlThe 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:
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.
Reconfigure 8-Server ODBC ConnectionsThe 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:
8-Server should be restarted after making this change: Troubleshootingjtel 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):
Now run the scripts again. jtel Portal DB Script fails with "Duplicate Entry"Try running the DB script again. Authentication Failed with some DB ToolsFor 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 repositoryThe following series of commands issed in mysql might sometimes help to restart the slave, without rebuilding replication from scratch:
Upgrade to MySQL 8.x FailsIf the upgrade to 8.x fails, try rolling back to 5.7 as follows, and resolve the problem in 5.7 before proceeding.
|