MYSQL

Introduction et installation de MYSQL 5.1 sur I5.

Introduction

Le langage PHP (Hypertext Preprocessor) est devenu en quelques années d'existence, le langage de programmation de sites web dynamiques le plus populaire à coté de Java

Associé à MySQL, le langage PHP permet de développer des applications web puissantes reliées à des bases de données.

Sur System i, les pages PHP accèdent généralement à des données DB2, mais cela implique, si vous souhaitez utilisez des produits Open Source utilisant MYSQL, une réécriture partielle du code

Depuis la version 5.1 de MYSQL, MYSQL propose une "passerelle", nommée MYSQL DB2 Storage Engine, pemettant à une base MYSQL de stocker ses données sous DB2

Installation :

PHP, depuis la V5R40 : Zend core for I5/OS

Ce produit installe en fait un serveur Apache sous Pase qui tourne sur un autre port (8000, modifiable) , il faut alors utiliser une directive PROXY pour rerouter les requêtes vers cet autre serveur (depuis le serveur Apache "natif" de I5/OS).

L'interet du serveur Apache2 sous Pase (c'est véritablement celui d'UNIX) pour Zend, c'est de réutilsier les routines existantes, particulièrement celles permettant de lancer PHP en mode module, ce qui offre les meilleures performances et le debug avec ZendStudio.

1/ vérifiez que vous avez les logiciels sous licence suivants :

Code (option)	Produit
5722SS1 (33)	PASE
5722SS1 (30)	Qshell
5722SS1 (13)	System Openness Includes
5722SS1 (34)	Digital Certificate Manager
5733SC1(*base)	IBM Portable Utilities For I5/OS
5733SC1 (1)	OpenSSH ,OpenSST,Zlib

Le répertoire /usr/local doit exister (créez le, s'il le faut, par MKDIR) et ne doit pas être un lien symbolique

2/ Téléchargez le fichier zippé sur le site de ZEND, dézippez et transférez (en binaire) via FTP le SAVF ZCOREPROD dans QGPL

3/ Passez ensuite la commande RSTLICPGM LICPGM(1ZCORE5) DEV(*SAVF) SAVF(QGPL/ZCOREPROD)

Ce produit propose une installation conjointe de MYSQL, mais version 5.0 et qui ne contient pas le DB2 storage Engine.

Enfin, depuis l'été 2009, téléchargez cette version 5.1 contenant un SAVF pour le system i
http://dev.mysql.com/downloads/mysql/5.1.html#i5os-savf et le Mysql DB2 storage Engine.

Attention un APAR II14442 indique les PTF préalables

restaurez alors la bibliothèque MYSQLINST contenant :

     Objet       Type        Attribut    Texte          
     INSMYSQL    *PGM        CLP         Install MySQL  
     UPGMYSQL    *PGM        CLP         Upgrade MySQL  
     SCRIPT      *FILE       SAVF                       
     TARF        *FILE       SAVF                       
     INSMYSQL    *CMD                    Install MySQL  
     UPGMYSQL    *CMD                    Upgrade MySQL  
                                                        
                                                        

 et lancez le CL INSMYSQL après avoir passé votre job en CCSID(37)


Attention, plusieurs remarques :


- si vous aviez déja une version de MYSQL, sauvegardez vos données avant.
 Détruisez ensuite my.cnf dans /etc.

- vous ne pourrez pas faire un Upgrade de mysql 5.0 vers 5.1 avec UPGMYSQL
 ce script ne gère que les mises à jour mineures (5.0.47 à 5.0.48, par ex)

- ce CL installe un script install.sh dans /tmp et l'exécute

- vous devez passer votre job en CCSID(37) à cause d'un fichier temporaire nommé @longlink
 et le script gère mal le @ avec un code page latin (297 par exemple)


- nous avons utilisé comme paramètres :
    
      DIR('/usr/local/')
      DATADIR(/usr/local/mysqldata')
      USRPRF(MYSQL)

cela va restaurer le répertoire /usr/local/mysql-5.1.37-i5os-power-64bits et crééer un lien symbolique nommé /usr/local/mysql

IBM propose par défaut /QOpenSys/usr/local/mysql pour être insensible à la casse, mais /usr/local est plus standard 
et mysql détecte bien si le système de fichier est sensible à la casse ou pas.

les données seront stockées dans mysqldata (répertoire indépendant, plus simple pour changer de version)

le profil MYSQL doit exister. 



- il y a une documentation officielle fournie par MYSQL.

Avec Zend Server (hiver 2010), ce dernier propose une installation intégrée (comme Zend Core) de MYSQL mais version 5.1.50, qui contient déjà le moteur en question.

Enfin désormais vous pouvez télécharger MYSQL ou MAriaDB depuis ce site
http://www.zend.com/en/solutions/modernize-ibm-i/ibm-i-product/dbi

Transférez le SAVF contenu dans le fichier zip puis installez par

RSTLICPGM LICPGM(1ZENDDB) DEV(*SAVF) SAVF(QGPL/ZDBISAVF10)



Dans tous les cas, lancez MYSQL par :

Installation manuelle :
/usr/local/mysql/bin/mysqld_safe --usermysql & (sous QSH)
  (le & demande à ce que MYSQL soit lancée en tâche de fond indépendante)

ou, suite à Installation de MariaDB : 

démarrez le sous-système ZENDDBI10 ce qui lancera -> CALL ZMARIADB/ZMYSQLSTRT

- ensuite assignez à root un mot de passe (ce n'est pas obligatoire, mais c'est plus prudent)

par mysqladmin -u root password "nouveau_pwd"

Attention, pour utiliser ensuite mysqladmin ou mysql en mode commande, il faudra ajouter -pnouveau_pwd

Pour ajouter d'autres utilisateurs :

GRANT ALL PRIVILEGES ON *.* TO 'user'@'%' IDENTIFIED BY 'passw0rd' WITH GRANT OPTION;


->vous pouvez indiquez à droite du @ un host ou une adresse IP, la connexion n'est autorisée que de ce poste

ensuite, vérifiez le fonctionnement par :

 cd /usr/local/mysql                     
 /usr/local/mysql-5.1.37-i5os-power-64bit
 $                                       
 bin/mysqladmin -pnouveau_pwd version                  
 bin/mysqladmin  Ver 8.42 Distrib 5.1.37, for ibm-i5os on power          
 Copyright 2000-2008 MySQL AB, 2008 Sun Microsystems, Inc.               
 This software comes with ABSOLUTELY NO WARRANTY. This is free software, 
 and you are welcome to modify and redistribute it under the GPL license 
                                                                         
 Server version          5.1.37                                          
 Protocol version        10                                              
 Connection              Localhost via UNIX socket

Avec MariaDB utilisez le menu ZDBMENU ou la commande STRZDBI

Option 21

Sinon, Exemple de commandes de démarrage et d'arrêt

STRMYSQL(CMD)

 CMD        PROMPT('Démarrage MYSQL')

STRMYSQL(CLP)


PGM                                                                     
       
    SBMJOB     CMD(CALL PGM(STRMYSQLB))  +     
                          JOB(MYSQLD) JOBQ(ZENDCORE/ZCOREJOBQ)          
                                                                        
ENDPGM

STRMYSQLB(CLP)


PGM                                                                     
    DCL VAR(&CMD) TYPE(*CHAR) LEN(50)                                       
    DCL VAR(&PARM) TYPE(*CHAR) LEN(15)                                      
    DCL VAR(&NULL) TYPE(*CHAR) LEN(1) VALUE(X'00')                          
                                                 
             CALL CHGSRVTYPE PARM('MYSQL')
                             
             CHGVAR     VAR(&CMD) +                                     
                          VALUE('/Usr/local/mysql/bin/mysqld+           
                          _safe' *TCAT &NULL)                           
             CHGVAR     VAR(&PARM) VALUE('--user=mysql' *TCAT &NULL )   
                                                                        
             CALL PGM(QP2SHELL2) PARM(&CMD &PARM)          
                                                                        
ENDPGM

ENDMYSQL(CMD)

  
CMD        PROMPT('ARRÊT MYSQL')                       
PARM       KWD(FORCE) TYPE(*CHAR) LEN(4) RSTD(*YES) +  
                 DFT(*NO) VALUES(*YES *NO) PROMPT('Forcer +
                   arrêt')

ENDMYSQL(CLP)


/*****************************************************************/
/* ATTENTION , REMPLACER -pXXXXX PAR -p<le mot de passe de root> */
/*****************************************************************/
PGM   PARM(&FORCE)                                                 
DCL &FORCE *CHAR 4                                                 
DCL VAR(&CMD) TYPE(*CHAR) LEN(50)                                  
DCL VAR(&PARM1) TYPE(*CHAR) LEN(10)                                
DCL VAR(&PARM2) TYPE(*CHAR) LEN(10)                                
DCL VAR(&PARM3) TYPE(*CHAR) LEN(10)                                
DCL VAR(&PARM4) TYPE(*CHAR) LEN(20)                                
DCL VAR(&NULL) TYPE(*CHAR) LEN(1) VALUE(X'00')                     
                                                                   
                                                                   
                                                                   
  IF (&FORCE = *YES) THEN(DO)                                      
            ENDALLJOB JOB(MYSQLD)                                
 ENDDO                                                            
 ELSE DO                                                          
            CHGVAR     VAR(&CMD) +                                
                         VALUE('/Usr/local/mysql/bin/mysqladmin' +
                         *TCAT &NULL)                             
            CHGVAR     VAR(&PARM1) VALUE('-u' *CAT &NULL)         
            CHGVAR     VAR(&PARM2) VALUE('root' *CAT &NULL)       
            CHGVAR     VAR(&PARM3) VALUE('shutdown' *CAT &NULL)   
            CHGVAR     VAR(&PARM4) VALUE('-pXXXXX' *CAT &NULL)    
                                                                  
            SBMJOB     CMD(CALL PGM(QP2SHELL2) PARM(&CMD &PARM1 + 
                         &PARM2 &PARM3 &PARM4)) JOB(ENDMYSQLD) +  
                         JOBQ(ZENDCORE/ZCOREJOBQ)                 
 ENDDO                                                            
                                                                  
 SNDPGMMSG  MSG('Arrêt demandé') MSGTYPE(*COMP)

ENDPGM

- pour utiliser MYSQL en mode commande (toujours sous QSH) :

 cd /usr/local/mysql                     
 /usr/local/mysql-5.1.37-i5os-power-64bit
 $                                       
 bin/mysql -u root -pnouveau_pwd     
Welcome to the MySQL monitor.  Commands end with ; or \g.                       
Your MySQL connection id is 40                                                  
Server version: 5.1.37 MySQL Community Server (GPL)                             
                                                                                
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.  
                                                                                
mysql>                                                                          
    

 create database vins;
Query OK, 1 row affected (0.03 sec)


 create table vins.producteurs (pr_code integer,                    
                                pr_nom varchar(50),              
                                .../...
                                         );                         
Query OK, 0 rows affected (0.05 sec)

Quelques utilitaires :

mysqladmin -u root shutdown : arret de MYSQL
mysqladmin -u root version
mysqladmin -u root variables
mysqlshow : liste les bases de données
mysqldump BasedeDonnées : exporte les données d'une base ( à restaurer par MYSQL -u root <fichier_exporté.sql )

la documentation : http://dev.mysql.com/doc/refman/5.0/fr/index.html

DB2 Storage Engine

il s'agit de proposer un nouveau moteur de stockage à MYSQL.

Celui-ci en possède naturellement plusieurs

MyISAM : le plus rapide pour stocker des données stables dans un mode non transactionnel
innoDB : pour travailler sous commitment control
MEMORY : stockage en mémoire uniquement
CSV : sockage des données dans un format CSV

et donc le petit nouveau IBMDB2I permettant le stockage des data dans une blbliothèque DB2, donc ensuite accessible par un programme I5/OS.

pour l'activer, sous MYSQL (donc QSH)

 cd /usr/local/mysql                     
 /usr/local/mysql-5.1.37-i5os-power-64bit
 $                                       
 bin/mysql -u root -pnouveau_pwd     
Welcome to the MySQL monitor.  Commands end with ; or \g.                       
Your MySQL connection id is 40                                                  
Server version: 5.1.37 MySQL Community Server (GPL)                             
                                                                                
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.  
                                                                                
mysql>                                                                          
    

install plugin ibmdb2i soname “ha_ibmdb2i.so”;

vous devez le voir, ensuite par show engines

 show engines;                                                                                                                 
+------------+---------+----------------------------------------------------------------+--------------+------+------------+  
| Engine     | Support | Comment                                                        | Transactions | XA   | Savepoints |  
+------------+---------+----------------------------------------------------------------+--------------+------+------------+  
| InnoDB     | YES     | Supports transactions, row-level locking, and foreign keys     | YES          | YES  | YES        |  
| MRG_MYISAM | YES     | Collection of identical MyISAM tables                          | NO           | NO   | NO         |  
| BLACKHOLE  | YES     | /dev/null storage engine (anything you write to it disappears) | NO           | NO   | NO         |  
| CSV        | YES     | CSV storage engine                                             | NO           | NO   | NO         |  
| MEMORY     | YES     | Hash based, stored in memory, useful for temporary tables      | NO           | NO   | NO         |  
| FEDERATED  | NO      | Federated MySQL storage engine                                 | NULL         | NULL | NULL       |  
| IBMDB2I    | YES     | IBM DB2 for i Storage Engine                                   | YES          | NO   | YES        |  
| ARCHIVE    | YES     | Archive storage engine                                         | NO           | NO   | NO         |  
| MyISAM     | DEFAULT | Default engine as of MySQL 3.23 with great performance         | NO           | NO   | NO         |  
+------------+---------+----------------------------------------------------------------+--------------+------+------------+  
9 rows in set (0.01 sec)

Attention, il faut être à jour au niveau des PTF, particluièrement le groupe base de données et en V5R40, il faut

SI37763 (si vous avez 5722SS1 , option 13), SI35184 , SI36388 et SI36391

Ensuite lors d'un CREATE TABLE , ajoutez engine=ibmdb2i

ou bien positionnez cette valeur par défaut.

pour la session par SET storage_engine=ibmdb2i;

au démarrage

au cas par cas avec mysqld_safe --default-storage-engine=ibmdb2i &

toujours, en ajoutant à /etc/my.cnf default-storage-engine=ibmdb2i

Attention, sur les dernières versions de ZendDBi, le fichier se trouve dans /usr/local/mysql/bin et il ne doit pas avoir les droits *RWX pour *Public

(informaitons complètes http://wsip-174-79-32-155.ph.ph.cox.net/wiki/index.php/MySql/DB2StorageEngineDocument )

vous pouvez aussi passer la commande suivante sur une table existante

ALTER TABLE producteurs ENGINE=IBMDB2I;

la bibliothèque porte le nom de la base et n'est créé qu'à la première table

CREATE DATABASE vins, ne créé rien

CREATE TABLES vins.producteurs, créé :

une bibliothèque"vins" avec un journal et le catalogue SQL

NB : "vins" en minuscules, il faut donc mettre le nom entre guillemets pour pouvoir l'utiliser (par exemple ADDLIBLE "vins")

la table "producteurs", nommée "prod0001" pour I5/OS

par contre, DROP TABLE supprime la table, mais seul DROP DATABASE va supprimer la bibliothèque.

les ordres DDL (Data Definition language) comme CREATE TABLE, CREATE INDEX, sont transformés en leur équivalent SQL/400

les ordres DML (Data Manipulation language) comme SELECT, UPDATE sont réalisés par des entrées/sorties natives, l'optimisation étant à la charge de MYSQL

Extrait des options disponibles (à placer dans /etc/my.cnf)

ibmdb2i_assume_exclusive_use = 0/1 (dft=0)

0 informe MYSQL que les tables peuvent être altérées par un moteur externe à MYSQL (comme DB2)
1 indique à MYSQL un accès exclusif
ibmdb2i_compat_opt_time_as_duration =0/1 (dft=0)

0 indique que les zones TIME doivent être stockées au format DB2 et converties lors de l'accès MYSQL
1 indique que les zones TIME doivent être stockées au format MYSQL (integer représentant une durée)
ibmdb2i_rdb_name

Indique le nom de la Remote Database (RDB vue dans WRKRDBDIRE) utilisée par le moteur
ibmdb2i_transaction_unsafe=0/1 (dft=0)

0 utilise le mode transactionnel, tel qu'indiqué dans la connexion MYSQL
1 n'utilise pas le mode transactionnel, comme le moteur MyISAM
ibmdb2i_compat_opt_blob_cols = 0/1 (dft=0)

0 les champs TEXT et BLOB MYSQL sont associés au type BLOB DB2 (DB2 ne sait pas indexer les champs BLOB)
1 les champs TEXT et BLOB sont convertis au type LONG VARCHAR() limités à 32K mais pouvant être indexés
ibmdb2i_create_index_option = 0/1 (dft=0)

1 indique que, quand un index MYSQL de type ASCII est demandé, un index DB2 en EBCDIC soit créé avec le nom <nom-index>__H_<nomdelatable>
ibmdb2i_compat_opt_allow_zero_date_vals = 0/1 (dft=0)

1 demande à ce que les dates MYSQL à 0000-00-00 soient transformées en 0001-01-01 sous DB2 et inversement (lors des lectures)
ibmdb2i_propagate_default_col_vals = 0/1 (dft=0)

1 demande à ce que les valeurs par défaut MYSQL soient aussi indiquées en tant que valeur par défaut sous DB2
ibmdb2i_system_trace_level
- 0 = pas de trace (Defaut)
- 2 = STRDBMON
- 4 = STRDBG
- 8 = DSPJOLOG
- 16 = STRTRC
- 32 = PRTSQLINF
  
  ces valeurs peuvent être cumulées.

Vous pouvez aussi modifier ces paramètres en direct par set global paramètre=valeur.

Pour tester, nous avons installé SugarCRM après avoir défini ibmdb2i comme moteur par défaut.

tout c'est bien passé, voici ce que nous affiche phpMYadmin :

MySQL Administrator

iSeries Navigator

et PDM

Depuis la version 5.1.50, les noms de tables sont automatiquement convertis en Majuscules.

-> pour plus de détails techniques, voyez le redbook SG247705

Réglage des performances

1/ Soyez à jour avec les PTF concernant PASE

2/ Voyez les paramètres IBM i suivants :

Allouez 12 à 15 % dela mémoire globale au pool *MACHINE (WRKSHRPOOL / F11, si vous êtes en ajustement automatique)
Attribuez au pool mémoire un niveau d'activité élevé (200 au moins) MYSQL étant fortement multi-thread
Vérifiez la taille du pool mémoire dans lequel MYSQL s'exécute fonction des tailles de buffers paramètrées dans MYSQL.

3/ Voyez les paramètres de bufferisation suivants dans /etc/my.cnf

Pour chaque élément, il existe des variables de "status", renseignées par le moteur, permettant de voir les valeurs en cours avant d'ajuster les paramètres.

Elles peuvent être visualisées en mode commande par SHOW STATUS LIKE 'thread%' ou par MySQL Administrator.

> show status like 'thread%';    
  +-------------------+-------+  
  | Variable_name     | Value |  
  +-------------------+-------+  
  | Threads_cached    | 0     |  
  | Threads_connected | 1     |  
  | Threads_created   | 1044  |  
  | Threads_running   | 1     |  
  +-------------------+-------+  
  4 rows in set (0.00 sec)       
                                 
  mysql>

ici, un affichage concernant les threads, proposé par MySQL Administrator.

thread_cache_size = nombre de thread à garder actifs, la variable Threads_Created indique le nbr de thread créés en plus.
par exemple thread_cache_size=128
query_cache_size taille du cache de stockage des requêtes et de leur résultat
par exemple query_cache_size=512M
table_definition_cache taille du cache dans lequel conserver les définitons de table [fichier .frm]
read_buffer_size taille du buffer pour les "full scan"
sort_buffer_size taille du buffer pour GROUP BY / ORDER BY
join_buffer_size taille du buffer pour les jointures
Moteur MyISAM
- key_buffer_size taille du buffer pour les index [fichiers .myi], MyISAM ne bufferise pas le contenu des tables.
  Sur les autres plate-forme la règle est de 30 à 40% de la taille globale, à ajuster.
Moteur InnoDB
- innodb_buffer_size taille du buffer pour les index ET les tables, InnoDB bufferise les 2.
- innodb_log_file_size taille des journaux
- innodb_log_buffer_size taille du buffer pour les journaux
Moteur IBMDB2i
- ibmdb2i_assume_exclusive_use=1, si c'est possible
- ibmdb2i_transaction_unsafe=1
- ibmdb2i_create_index_option= 1
Enfin, vous pouvez faire la chasse aux requêtes les plus longues par :
- log_slow_queries=/chemin/fichier (sans paramètre MySQL créé "(nom_du_host)-slow.log")
- long_query_time=(secondes), limite de durée d'exécution avant d'écrire la requête dans le fichier log (dft=10 s.)
  -> les requêtes n'utilisant pas d'index, sont écrites de toutes facons.

MYSQL

Introduction et installation de MYSQL 5.1 sur I5.

Introduction

PHP, depuis la V5R40 : Zend core for I5/OS

DB2 Storage Engine

©AF400