Guide de migration vers MySQL

1
Serveur de communication IceWarp
Stockage des données en
bases MySQL
IceWarp France
novembre 2009
2
Serveur IceWarp : Stockage en base de données MySQL
Sommaire
Introduction ........................................................................................................... 3
Les logiciels nécessaires ........................................................................................... 3
MySQL .......................................................................................................... 3
PhpMyAdmin .................................................................................................. 3
Serveur IceWarp ............................................................................................. 3
Configuration existante du serveur IceWarp ................................................................. 3
Préparatifs ..................................................................................................... 4
Installation MySQL et PhpMyAdmin ............................................................................. 5
MySQL .......................................................................................................... 5
PhpMyAdmin .................................................................................................. 5
Création de bases MySQL ................................................................................. 5
Migration des données vers MySQL ............................................................................. 6
Domaines & Comptes ....................................................................................... 6
Antispam ....................................................................................................... 6
Groupware ..................................................................................................... 7
Vérifications ........................................................................................................... 7
Serveur IceWarp : Stockage en base de données MySQL
3
Introduction
Ce document décrit les différentes étapes pour
gérer toutes les données (domaines&comptes, groupware et antispam) dans des bases MySQL
Il concerne les installations d’IceWarp sur Windows (2000 server, XP, 2003 server, Vista).
Il concerne les versions 9 et 10 du serveur IceWarp.
Les logiciels nécessaires
MySQL
Le binaire MySQL : http://dev.mysql.com/downloads/mysql/5.0.html#downloads
PhpMyAdmin
L'outil d'administration PhpMyadmin :
http://sourceforge.net/projects/phpmyadmin/files/phpMyAdmin/3.2.3/phpMyAdmin-3.2.3-alllanguages.zip/download
Serveur IceWar
Le binaire IceWarp : http://www.icewarp.fr/download/merak.zip
Configuration existante du
serveur IceWarp
On suppose ici que la version 9 ou la version 10 du serveur IceWarp est installée sur la machine.
Lancer la console d'administration pour vérifier le paramétrage actuel des différentes bases de
données:
•
Les domaines et les comptes : l'information se trouve dans l'onglet Système -> Stockage,
l'onglet Comptes.
Si la gestion des domaine&comptes n'a jamais été faite dans une base de données, cet onglet
sera positionné soit sur 'Système de fichiers standard' ou sur 'Professionnel (Fichiers+cache)'.
4
Serveur IceWarp : Stockage en base de données MySQL
•
La base AntiSpam : l'information se trouve dans le menu Anti-Spam -> Général, l'onglet
Général, bouton Paramètres BD.
o
Pour les installations créées avec les anciennes versions et mises à jour pour la V9 ou
la V10, la base de données sera une base MS Access (Syntaxe: MS Access).
o
Pour les installations créées avec la V9 ou avec la V10, la base de données par défaut
sera SQLite (Syntaxe: SQLite).
Si la syntaxe est MS Access, noter le 'DSN' inscrit dans la partie 'Connexion principale' de
la fenêtre Paramètres BD. Ouvrir le menu Windows : Outils d'administration -> Sources de
données ODBC (Sur des machines 64 bits, il faut ouvrir l’administration ODBC en mode 32bits - C:\Windows\SysWOW64\odbcad32.exe)
Chercher le DSN dans la partie 'Système DSN' de cette interface et trouver le nom du
fichier (.mdb) correspondant.
Si la syntaxe est SQLite, le fichier de la base (antispam.db) se trouve dans le répertoire
…\merak\spam (ou …\icewarp\spam)
•
La base Groupware : l'information se trouve dans le menu Groupware, l'onglet Général, bouton
Paramètres BD.
o
Pour les installations créées avec les anciennes versions et mises à jour pour la V9 ou
la V10, la base de données sera une base MS Access (Syntaxe: MS Access).
o
Pour les installations créées avec la V9 ou avec la V10, la base de données par défaut
sera SQLite (Syntaxe: SQLite).
Si la syntaxe est MS Access, noter le 'DSN' inscrit dans la partie 'Connexion principale' de
la fenêtre Paramètres BD. Ouvrir le menu Windows : Outils d'administration -> Sources de
données ODBC (Sur des machines 64 bits, il faut ouvrir l’administration ODBC en mode 32bits - C:\Windows\SysWOW64\odbcad32.exe)
Chercher le DSN dans la partie 'Système DSN' de cette interface et trouver le nom du
fichier (.mdb) correspondant.
Si la syntaxe est SQLite, le fichier de la base (groupware.db) se trouve dans le répertoire
…\merak\calendar (ou …\icewarp\calendar)
Préparatifs
Avant de changer la configuration vers MySQL,
•
A partir de la console d'administration, faire une sauvegarde de la configuration existante avec
le menu Fichier -> Sauvegarder la configuration. Cette action génère un fichier .MCB (ou .ZIP
selon la version) qui contient toutes les informations concernant les domaines et comptes.
•
Faire une copie de la base existante d'antispam (…\merak\spam\*.mdb ou
…\merak\spam\antispam.db)
•
Faire une copie de la base existante de groupware (…\merak\calendar\*.mdb ou
…\merak\calendar\groupware.db)
Serveur IceWarp : Stockage en base de données MySQL
5
Installation MySQL et
PhpMyAdmin
MySQL
Installer MySQL en exécutant le setup.exe du zip.
PhpMyAdmin
Créer un dossier : …/merak/html/phpmyadmin
Dézipper le contenu du sous-dossier 'phpMyAdmin-3.2.3-all-languages' dans le répertoire
…/merak/html/phpmyadmin.
Copier le fichier …/merak/html/phpmyadmin/config.sample.inc.php en
…/merak/html/phpmyadmin/config.inc.php
Editer …/merak/html/phpmyadmin/config.inc.php; Changer la ligne
$cfg['blowfish_secret'] = ' '; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */
par
$cfg['blowfish_secret'] = 'ba17c1ec07d65003'; /* YOU MUST FILL IN THIS FOR COOKIE AUTH!
*/
Editer le fichier …/merak/php/php.ini pour activer la ligne 'extension=php_mysql.dll'
Editer le service web 'Défaut' de IceWarp pour ajouter dans la liste des documents : 'index.php' (si ce
nom n’y est pas)
Copier le fichier libmySQL.dll présent dans le répertoire ‘bin’ de l’installation MySQL dans le répertoire
C:\Windows\system32
Redémarrer le service Web/Control du serveur IceWarp.
Création de bases MySQL
Lancer dans un navigateur http://<serveur Merk>:<port>/phpmyadmin
Fournir un login/mot de passe (créés lors de l'installation de MySQL)
Créer trois bases de données (Important : Choisir ‘utf8_general_ci’ comme valeur pour
Interclassement ET Interclassement pour la connexion MySQL lors de la création de chaque base)
6
Serveur IceWarp : Stockage en base de données MySQL
•
•
•
merakcomptes
merakgw
merakspam
Migration des données vers
MySQL
Lancer la console d'administration
Domaines & Comptes
Aller dans le menu Système -> Stockage
Activer le bouton 'Base de données' et cliquer sur 'Paramètres BD' et renseigner les champs suivants:
-
Pilote: My SQL
Syntaxe: My SQL
DSN: merakcomptes
Serveur: 127.0.0.1
Utilisateur: <…>
Mot de Passe: <…>
Cliquer sur 'Créer Tables'.
Cliquer sur 'Valider'
Répondre Oui à la question 'voulez-vous convertir les données en BD'.
Antispam
Aller dans Système -> Outil -> Migration base de données et renseigner les champs suivants
Base de données : Base Anti-Spam
Cliquer sur BD source:
-
DSN: <le DSN qui pointe vers l'ancienne base; se trouve dans le menu Anti-Spam > Général -> Paramètres BD>
Serveur: <blanc si l'ancienne base était Access ou SQLite>
Utilisateur: <blanc si l'ancienne base était Access ou SQLite>
Mot de Passe: <blanc si l'ancienne base était Access ou SQLite>
Syntaxe: <type de l'ancienne base; se vérifie dans Sources de données ODBC pour
le nom de DSN du menu Anti-Spam -> Général -> Paramètres BD>
Pilote: ODBC
Cliquer sur BD destination
-
Pilote: My SQL
Syntaxe: My SQL
DSN: merakspam
Serveur: 127.0.0.1
Utilisateur: <…>
Mot de Passe: <…>
Serveur IceWarp : Stockage en base de données MySQL
7
Cliquer sur 'Démarrer la migration'. Le temps de migration dépend de la taille de la base source. A la
fin de la migration, une nouvelle fenêtre qui récapitule le nombre d'enregistrements migrés s'affiche.
Vérifier qu'il n'y a pas d'erreur dans ce journal.
Groupware
Aller dans Système -> Outil -> Migration base de données et renseigner les champs suivants
Base de données : Base groupware
Cliquer sur BD source:
-
DSN: <le DSN qui pointe vers l'ancienne base; se trouve dans le menu Groupware > Général -> Paramètres BD>
Serveur: <blanc si l'ancienne base était Access ou SQLite>
Utilisateur: <blanc si l'ancienne base était Access ou SQLite>
Mot de Passe: <blanc si l'ancienne base était Access ou SQLite>
Syntaxe: <type de l'ancienne base; se vérifie dans Sources de données ODBC pour
le nom de DSN du menu Groupware -> Général -> Paramètres BD>
Pilote: ODBC
Cliquer sur BD destination
-
Pilote: My SQL
Syntaxe: My SQL
DSN: merakgw
Serveur: 127.0.0.1
Utilisateur: <…>
Mot de Passe: <…>
Cliquer sur 'Démarrer la migration'. Le temps de migration dépend de la taille de la base source. A la
fin de la migration, une nouvelle fenêtre qui récapitule le nombre d'enregistrements migrés s'affiche.
Vérifier qu'il n'y a pas d'erreur dans ce journal.
En cas de problème, éditer le fichier …/merak/calendar/calendar.xml pour remplacer toutes les
occurrences de '%%Text%%' par le type approprié pour la BD destination. Cette correspondance pour
les types 'text' se trouve en début de ce fichier. Par example, si la BD destination est MySQL,
remplacer '%%text%%' par 'text'. Cliquer sur 'Démarrer la migration'. Vérifier qu'il n'y a pas d'erreur
dans ce journal.
Vérifications
Se connecter à l’interface Web
-
http://<serveur merak>:<port>/webmail
Et vérifier le contenu des mails, des contacts, des agendas…