Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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).

Code Block
# Set variables for slave
cat <<EOFF >> /etc/my.cnf.d/jtel-slave.cnf
relay_log                       = mysqld-relay-bin
relay_log_index                 = mysqld-relay-bin.index
relay_log_info_file             = relay-log.info
EOFF


# 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. 

...

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
service mysqld start

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

Start the mysql Server without replication. Important: change the data directory if this is not in the standard location.

Code Block
# Start - IMPORTANT - WITHOUT REPLICATION
# Change the data directory if this is not in the standard location.
systemctl set-environment MYSQLD_OPTS="--skip-slave-start"
systemctl start mysqld.service

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.

...

Next restart the MySQL server.

Code Block
systemctl stop mysqld.service
systemctl set-environment mysqld restartMYSQLD_OPTS=
systemctl start mysqld.service


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.

...

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

Check this file for errors.

Phase

...

4 - Configure Other Components

Update the JBOSS Server

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

...