Versions Compared

Key

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

Common Installation Tasks

These tasks are performed on all DB servers, no matter what role (master or slave) they are to perform.

Attach STORE

First of all, the STORE is connected to the machine, as described here: Mounting STORE - All Linux except for STORE (CentOS8/Win2019)

Install MySQL

Configure Repositories and Install mysql-community-server

CentOS 8.x comes with some default repositories, which we do not want. These are disabled, and the MySQL repository is installed. Then the MySQL Server is installed.

Translations Ignore


Code Block
languagebash
# Make sure liibaio is on
dnf -y install libaio

# Disable some default stuff
dnf config-manager --disable mysql-connectors-community
dnf config-manager --disable mysql-tools-community
dnf -y module disable mysql

# Install the Oracle MySQL repo and the client
dnf -y install https://dev.mysql.com/get/mysql80-community-release-el8-1.noarch.rpm
dnf -y install mysql-community-server


Start MySQL

Next, the MySQL server is configured to autostart on boot, and started up:

Translations Ignore


Code Block
languagebash
systemctl enable mysqld.service
systemctl start mysqld.service


Configure Firewall

Access to the MySQL Server is configured in the firewall:

Translations Ignore


Code Block
languagebash
firewall-cmd --zone=public --add-port=3306/tcp --permanent
firewall-cmd --reload


Configure MySQL

Configuration Files

MySQL 8.x creates a configuration directory /etc/my.cnf.d when it installs. The jtel configuration files are stored here, but a reference must be added to this directory so that mysql loads the configuration files.

This is added with the following command:

Translations Ignore


Code Block
languagebash
cat <<EOFF >> /etc/my.cnf
#
# * IMPORTANT: Additional settings that can override those from this file!
# The files must end with '.cnf', otherwise they'll be ignored.
#
!includedir /etc/my.cnf.d/
EOFF


The next command downloads the main configuration file for the mysql server. This file contains a lot of well commented settings which can be tweaked if required. The main parameter to be changed is the RAM usage of the sever. See below.

Translations Ignore


Code Block
languagebash
wget -P /etc/my.cnf.d http://cdn.jtel.de/downloads/configs/jtel-enhanced-8.cnf


Restart Server

Now, the MySQL must be restarted:

Translations Ignore


Code Block
languagebash
systemctl restart mysqld.service


Configure Users

After the first restart, user access must be setup.

MySQL 8.x saves a generated random password for the root user in the file /var/log/mysqld.log

This password must be extracted. Often, it contains special characters which cannot be input on the command line within a script. For the following command the password is input manually. Note, that <password> refers to the NEW password you want to assign to the root account.

Status
colourRed
titleCaution Password

Translations Ignore


Code Block
languagebash
mysqladmin -u root -p password '<password>'


The following commands configure the further users required:

Status
colourRed
titleCaution Password

Translations Ignore


Code Block
languagebash
mysql -u root -p<password> -v -e"CREATE USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '<password>'"
mysql -u root -p<password> -v -e"GRANT ALL ON *.* TO 'root'@'%' WITH GRANT OPTION"
mysql -u root -p<password> -v -e"FLUSH PRIVILEGES"


Install UDP Plugin

Next, the UDP plugin is installed. This is required for the communication with further software modules in the system, when certain DB changes are made.

The installation is slightly different for master and slave servers.

Installation

Master Server

Translations Ignore


Code Block
languagebash
cp /home/jtel/shared/JTELCarrierPortal/Libraries/jtel_udf_udpsend/jtel_udf_udpsend.so /usr/lib64/mysql/plugin/
chown root:root /usr/lib64/mysql/plugin/jtel_udf_udpsend.so
chmod 755 /usr/lib64/mysql/plugin/jtel_udf_udpsend.so
chcon system_u:object_r:lib_t:s0  /usr/lib64/mysql/plugin/jtel_udf_udpsend.so


Slave Server


Translations Ignore


Code Block
languagebash
cp /home/jtel/shared/JTELCarrierPortal/Libraries/jtel_udf_udpsend/dummy/jtel_udf_udpsend.so /usr/lib64/mysql/plugin/
chown root:root /usr/lib64/mysql/plugin/jtel_udf_udpsend.so
chmod 755 /usr/lib64/mysql/plugin/jtel_udf_udpsend.so
chcon system_u:object_r:lib_t:s0  /usr/lib64/mysql/plugin/jtel_udf_udpsend.so


Configuration

To configure the plugin, the following commands are executed:

Status
colourRed
titleCaution Password

Translations Ignore


Code Block
languagebash
mysql -u root -p<password> -v -e"DROP FUNCTION IF EXISTS udpsend"
mysql -u root -p<password> -v -e"CREATE FUNCTION udpsend RETURNS STRING SONAME 'jtel_udf_udpsend.so'"




Note
titleImportant

The configuration of the UDP plugin must be performed before the server is included in any replication between servers, otherwise replication will fail. The UDP plugin must be installed on all servers.

Configure Server RAM

In order that the server makes the best use of the RAM available, the configuration file /etc/my.cnf.d/jtel-enhanced-8.cnf must be adapted.

The setting innodb_buffer_pool_size should be adapted to about 3/4 of the available RAM, but a minimum of 3-4 GB should remain for the use of other processes. For Servers with 4 GB RAM, this should not exceed 2 GB. 

Translations Ignore


Code Block
languagebash
# For 4 GB RAM
innodb_buffer_pool_size = 2048M

# For 8 GB RAM
innodb_buffer_pool_size = 5120M
 
# For 12 GB RAM
innodb_buffer_pool_size = 8192M
 
# For 16 GB RAM
innodb_buffer_pool_size = 12288M

...
# From 16 GB simply take 3/4 of the RAM


Restart MySQL

Finally, the MySQL server is restarted for the last time, to load all configuration settings.

Translations Ignore


Code Block
languagebash
titleRestart the MySQL server
systemctl restart mysqld.service




Sv translation
languagede

Status
colourRed
titleTHIS PAGE IS ONLY AVAILABLE IN ENGLISH

Sv translation
languagefr

Tâches d'installation communes

Ces tâches sont effectuées sur tous les serveurs de la base de données, quel que soit le rôle (maître ou esclave) qu'ils doivent jouer.

Joindre MAGASIN

Tout d'abord, le STORE est connecté à la machine, comme décrit ici : Mounting STORE - All Linux except for STORE (CentOS8/Win2019)

Installer MySQL

Configuration des dépôts et installation de mysql-community-server

CentOS 8.x est livré avec quelques dépôts par défaut, dont nous ne voulons pas. Ceux-ci sont désactivés et le dépôt MySQL est installé. Ensuite, le serveur MySQL est installé.

Translations Ignore


Code Block
languagebash
# Assurez-vous que liibaio est sur dnf -y install libaio # Désactivez certains trucs par défaut dnf config-manager --disable mysql-connector-community dnf config-manager --disable mysql-tools-community dnf -y module disable mysql # Install the Oracle MySQL repo et le client dnf -y install https://dev.mysql.com/get/mysql80-community-release-el8-1.noarch.rpm dnf -y install mysql-community-server


Démarrer MySQL

Ensuite, le serveur MySQL est configuré pour démarrer automatiquement au démarrage, et démarré :

Translations Ignore


Code Block
languagebash
systemctl enable mysqld.service systemctl start mysqld.service


Configurer le pare-feu

L'accès au serveur MySQL est configuré dans le pare-feu :

Translations Ignore


Code Block
languagebash
firewall-cmd --zone=public --add-port=3306/tcp --permanent firewall-cmd --reload


Configurer MySQL

Fichiers de configuration

MySQL 8.x crée un répertoire de configuration /etc/my.cnf.d lorsqu'il s'installe. Les fichiers de configuration de jtel sont stockés ici, mais une référence doit être ajoutée à ce répertoire pour que mysql charge les fichiers de configuration.

Il est ajouté avec la commande suivante :

Translations Ignore


Code Block
languagebash
cat << EOFF >> /etc/my.cnf # # * IMPORTANT: paramètres supplémentaires pouvant remplacer ceux de ce fichier! # Les fichiers doivent se terminer par '.cnf', sinon ils seront ignorés. #! includedir /etc/my.cnf.d/ EOFF 


La commande suivante télécharge le fichier de configuration principal pour le serveur mysql. Ce fichier contient de nombreux paramètres bien commentés qui peuvent être modifiés si nécessaire. Le principal paramètre à modifier est l'utilisation de la RAM du serveur. Voir ci-dessous.

Translations Ignore


Code Block
languagebash
wget -P /etc/my.cnf.d http://cdn.jtel.de/downloads/configs/jtel-enhanced-8.cnf


Redémarrer le serveur

Maintenant, le serveur MySQL doit être redémarré :

Translations Ignore


Code Block
languagebash
systemctl restart mysqld.service


Configurer les utilisateurs

Après le premier redémarrage, l'accès de l'utilisateur doit être configuré.

MySQL 8.x enregistre dans le fichier un mot de passe aléatoire généré pour l'utilisateur root /var/log/mysqld.log

Ce mot de passe doit être extrait. Souvent, il contient des caractères spéciaux qui ne peuvent pas être saisis sur la ligne de commande dans un script. Pour la commande suivante, le mot de passe est saisi manuellement. Notez que <mot de passe> fait référence au NOUVEAU mot de passe que vous souhaitez attribuer au compte root.

Status
colourRed
titleMot de passe de précaution

Translations Ignore


Code Block
languagebash
mysqladmin -u root -p password '<password>'


Les commandes suivantes permettent de configurer les autres utilisateurs requis :

Status
colourRed
titleMot de passe de précaution

Translations Ignore


Code Block
languagebash
mysql -u root -p<password> -v -e"CREATE USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '<password>'" mysql -u root -p<password> -v -e"GRANT ALL ON *.* TO 'root'@'%' WITH GRANT OPTION" mysql -u root -p<password> -v -e"FLUSH PRIVILEGES"


Installer le plug-in UDP

Ensuite, le plugin UDP est installé. Il est nécessaire pour la communication avec d'autres modules logiciels du système, lorsque certaines modifications sont apportées à la base de données.

L'installation est légèrement différente pour les serveurs maître et esclave.

Installation

Serveur maître

Translations Ignore


Code Block
languagebash
cp /home/jtel/shared/JTELCarrierPortal/Libraries/jtel_udf_udpsend/jtel_udf_udpsend.so /usr/lib64/mysql/plugin/ chown root:root /usr/lib64/mysql/plugin/jtel_udf_udpsend.so chmod 755 /usr/lib64/mysql/plugin/jtel_udf_udpsend.so chcon system_u:object_r:lib_t:s0 /usr/lib64/mysql/plugin/jtel_udf_udpsend.so


Serveur esclave


Translations Ignore


Code Block
languagebash
cp /home/jtel/shared/JTELCarrierPortal/Libraries/jtel_udf_udpsend/dummy/jtel_udf_udpsend.so /usr/lib64/mysql/plugin/ chown root:root /usr/lib64/mysql/plugin/jtel_udf_udpsend.so chmod 755 /usr/lib64/mysql/plugin/jtel_udf_udpsend.so chcon system_u:object_r:lib_t:s0 /usr/lib64/mysql/plugin/jtel_udf_udpsend.so


Configuration

Pour configurer le plugin, les commandes suivantes sont exécutées :

Status
colourRed
titleMot de passe de précaution

Translations Ignore


Code Block
languagebash
mysql -u root -p<password> -v -e"DROP FUNCTION IF EXISTS udpsend" mysql -u root -p<password> -v -e"CREATE FUNCTION udpsend RETURNS STRING SONAME 'jtel_udf_udpsend.so'"




Note
titleImportant

La configuration du plugin UDP doit être effectuée avant que le serveur ne soit inclus dans toute réplication entre serveurs, sinon la réplication échouera. Le plugin UDP doit être installé sur tous les serveurs.

Configurer la mémoire vive du serveur

Afin que le serveur utilise au mieux la mémoire vive disponible, le fichier de configuration /etc/my.cnf.d/jtel-enhanced-8.cnf doit être adapté.

Le réglage innodb_buffer_pool_size devrait être adaptée à environ 3/4 de la mémoire vive disponible, mais il devrait rester au moins 3-4 Go pour l'utilisation d'autres processus. Pour les serveurs disposant de 4 Go de RAM, cela ne devrait pas dépasser 2 Go. 

Translations Ignore


Code Block
languagebash
# For 4 GB RAM innodb_buffer_pool_size = 2048M # For 8 GB RAM innodb_buffer_pool_size = 5120M   # For 12 GB RAM innodb_buffer_pool_size = 8192M   # For 16 GB RAM innodb_buffer_pool_size = 12288M ... # From 16 GB simply take 3/4 of the RAM


Démarrer MySQL

Enfin, le serveur MySQL est redémarré pour la dernière fois, afin de charger tous les paramètres de configuration.

Translations Ignore


Code Block
languagebash
titleRedémarrer le serveur MySQL
systemctl restart mysqld.service