Ins­tal­la­tion de MariaDB

Pré­re­quis

Avant de com­men­cer, assu­rez-vous de dis­po­ser des élé­ments suivants :

• IBM i (ver­sion com­pa­tible avec MariaDB 10.6.x).
• ACS (IBM i Access Client Solu­tions) ins­tal­lé et configuré.
• Droits spé­ci­fiques : L’u­ti­li­sa­teur doit avoir les droits *ALLOBJ pour gérer les modules open source.
• Espace disque : Véri­fiez que /QOpenSys dis­pose de suf­fi­sam­ment d’espace.
• Connexion SSH (option­nelle) : Si vous uti­li­sez une connexion SSH.

Intro­duc­tion

MariaDB est un sys­tème de ges­tion de base de don­nées rela­tion­nelle (SGBDR) open source, fork de MyS­QL. Il est lar­ge­ment uti­li­sé pour des appli­ca­tions comme Word­Press, qui néces­sitent une base de don­nées fiable et performante.

Dans cet article, nous allons vous gui­der pas à pas pour ins­tal­ler MariaDB 10.6.x sur un sys­tème IBM i, en uti­li­sant l’ou­til ACS (IBM i Access Client Solu­tions). Cette ver­sion est recom­man­dée car la ver­sion 10.3.x ne sera bien­tôt plus maintenue.

Ins­tal­la­tion via ACS

Ouvrez ACS et lan­cez la ges­tion de modules open source.

Sai­sir les iden­ti­fiants et éven­tuel­le­ment les infor­ma­tions ssh si néces­saire et faites « OK ». Vous devez avoir les droits spé­ciaux *ALLOBJ pour pou­voir gérer les modules open sources.

Vous ver­rez appa­raître 3 onglets, celui qui nous inté­resse est celui des modules dis­po­nibles. Sélec­tion­nez mariadb-10.6 et mariadb-10.6‑server et cli­quez sur Installation.

L’ins­tal­la­tion se lance, au moment où on vous demande si c’est ok pour vous tapez y.

Vous rece­vrez le mes­sage « Com­plete ! », indi­quant que l’ins­tal­la­tion a réussi.

Confi­gu­ra­tion de MariaDB

Dans ce qui suit, afin de faci­li­ter la sai­sie des com­mandes de MariaDb, je vous conseille de confi­gu­rer les che­mins par défaut pour QSH.

Ini­tia­li­sa­tion de MariaDB

A par­tir de ssh ou de QSH, exé­cu­tez la com­mande mysql_install_db.

Cela crée­ra les bases de ges­tion de MariaDB.

Démar­rer et arrê­ter le serveur

SSH

La com­mande pour démar­rer le ser­veur est :

/QOpenSys/pkgs/bin/mysqld_safe --datadir=/QOpenSys/var/lib/mariadb/data

/QOpenSys/pkgs/bin/mysqld_safe --datadir=/QOpenSys/var/lib/mariadb/data

Et pour l’arrêter :

/QOpenSys/pkgs/bin/mysqladmin --no-defaults --user=root --password=yourpassword shutdown

/QOpenSys/pkgs/bin/mysqladmin --no-defaults --user=root --password=yourpassword shutdown

Quand vous lan­cez la com­mande sous cette forme, le ter­mi­nal est blo­qué que ce soit en ssh ou par QSH. En sor­tant d’une façon ou d’un autre, le ser­veur conti­nue de fonctionner.

Sou­mis­sion

Pour un meilleur contrôle, ces com­mandes peuvent être sou­mis par SBMJOB.
Le tra­vail du ser­veur néces­site d’être exé­cu­té dans un sous-sys­tème mul­ti­thread, c’est pour­quoi QSYSMOAX/QUSRWRK est une bonne option. Ensuite, vous pou­vez uti­li­ser les exemples WRKACTJOB et NETSTAT ci-des­sus pour véri­fier si les tâches et les ports du ser­veur sont actifs.

SBMJOB CMD(CALL PGM(QP2SHELL) PARM('/QOpenSys/pkgs/bin/mysqld_safe'        
'--datadir=/QOpenSys/var/lib/mariadb/data') ) JOB(MARIADB) JOBQ(QSYSNOMAX) 
JOBMSGQFL(*WRAP)   

SBMJOB CMD(CALL PGM(QP2SHELL) PARM('/QOpenSys/pkgs/bin/mysqld_safe'        
'--datadir=/QOpenSys/var/lib/mariadb/data') ) JOB(MARIADB) JOBQ(QSYSNOMAX) 
JOBMSGQFL(*WRAP)   

Autos­tart JOB

Au cas ou le ser­veur tom­be­rai en panne pen­dant vos vacances, il peut être inté­res­sant de confi­gu­rer ce tra­vail en AUTOSTART. De cette façon, en cas de plan­tage, le tra­vail va se relancer.

Com­men­çons par créer une des­crip­tion de tra­vail qui contien­dra tout la confi­gu­ra­tion d’en­vi­ron­ne­ment du ser­veur MariaDB.

CRTJOBD JOBD(QGPL/MARIADBSVR) JOBQ(QSYS/QSYSNOMAX) USER(LOGIN_USER) RQSDTA('CALL PGM(QP2SHELL) PARM(''/QOpenSys/pkgs/bin/mysqld_safe'' ''--datadir=/QOpenSys/var/lib/mariadb/data'')')

CRTJOBD JOBD(QGPL/MARIADBSVR) JOBQ(QSYS/QSYSNOMAX) USER(LOGIN_USER) RQSDTA('CALL PGM(QP2SHELL) PARM(''/QOpenSys/pkgs/bin/mysqld_safe'' ''--datadir=/QOpenSys/var/lib/mariadb/data'')')

• JOBD contient le nom de la des­crip­tion de tra­vail et sa bibliothèque. 
• JOBQ est la file d’at­tente de tra­vail dans laquelle sera exé­cu­té le travail.
• RQSDTA contient la com­mande à sou­mettre dans le tra­vail uti­li­sant cette JOBD.

Puis nous atta­chons cette des­crip­tion de tra­vail au sous-sys­tème QSYSWRK avec cette commande.

ADDAJE SBSD(QUSRWRK) JOB(MARIADBSVR) JOBD(QGPL/MARIADBSVR) 

ADDAJE SBSD(QUSRWRK) JOB(MARIADBSVR) JOBD(QGPL/MARIADBSVR) 

Le para­mètre SBSD est le sous-sys­tème dans lequel le tra­vail sera exé­cu­té quand le sous-sys­tème sera lui-même démarré.

Sécu­ri­ser l’u­ti­li­sa­teur root

Dans MariaDB, il y a un admi­nis­tra­teur qui a tous les droits appe­lé root. Vous devez y affec­ter un mot de passe fort. La com­mande à lan­cer est :

/QOpenSys/pkgs/bin/mysqladmin -u root password yournewpassword

/QOpenSys/pkgs/bin/mysqladmin -u root password yournewpassword

root ne doit pas être uti­li­sé par les appli­ca­tions, il est for­te­ment conseillé de créer un pro­fil par appli­ca­tion qui aura les droits néces­saire sur la base de celle-ci.

A par­tir de main­te­nant, vous êtes prêt à pas­ser à la suite.

Cette article est basé sur HOW TO INSTALL & USE MARIADB WITH PHP

Res­sources supplémentaires

• Docu­men­ta­tion offi­cielle de MariaDB
• Forum IBM i pour les ques­tions techniques