Les bases de données doivent prendre en charge le codage Unicode.
L'application utilisateur nécessite que le jeu de caractères de la base de données utilise le codage Unicode. Ainsi, UTF-8 est un exemple de jeu de caractères employant ce codage, alors que Latin1 ne l'utilise pas. Avant d'installer l'application utilisateur, vérifiez que votre base de données est configurée avec un jeu de caractères utilisant le codage Unicode.
Remarque : si vous effectuez une migration vers une nouvelle version du module de provisioning basé sur les rôles, vous devez utiliser la même base de données d'application utilisateur que pour l'installation précédente, c'est-à-dire celle depuis laquelle vous effectuez la migration.
2.4.1 Remarques sur la configuration d'une base de données
MySQL
L'application utilisateur nécessite certaines options de configuration pour MySQL. Si vous installez vous-même MySQL, c'est à vous de configurer ces paramètres. Si vous installez MySQL à l'aide de l'utilitaire JbossMysql, celui-ci définit les valeurs qui vous conviennent, mais vous devez connaître les valeurs à maintenir pour ce qui suit :
« Moteur de stockage et types de tables INNODB » page 24
« Ensemble de caractères » page 24
« Distinction de la casse » page 25
« Paramètre Ansi » page 25
« Conditions relatives au compte utilisateur » page 26
Moteur de stockage et types de tables INNODB
L'application utilisateur se sert du moteur de stockage INNODB, ce qui permet de choisir des types de tables INNODB pour MySQL. Si vous créez une table MySQL sans indiquer son type, la table sera de type MyISAM par défaut. Si vous choisissez d'installer MySQL à partir de la procédure d'installation d'Identity Manager, le MySQL fourni avec cette procédure contient le type de table
INNODB indiqué. Pour vous assurer que votre serveur MySQL utilise INNODB, vérifiez que my.cnf
(Linux ou Solaris) ou my.ini
(Windows) contient l'option suivante : default-table-type=innodb
Il ne doit pas contenir l'option skip-innodb
.
Au lieu de configurer l'option default-table-type=innodb
, vous pouvez ajouter l'option
ENGINE=InnoDB
aux instructions de création de table dans le script SQL de votre base de données.
Ensemble de caractères
Indiquez UTF-8 comme ensemble de caractères pour l'ensemble du serveur ou simplement pour une base de données. Indiquez UTF-8 sur l'ensemble du serveur en incluant l'option suivante dans my.cnf
(Linux ou Solaris) ou my.ini
(Windows) : character_set_server=utf8
Pour indiquer le jeu de caractères d'une base de données au moment de la création de la base de données, utilisez la commande suivante :
24
Guide d'installation de l'application utilisateur pour le module de provisioning basé sur les rôles Identity Manager
create database databasename character set utf8 collate utf8_bin;
Si vous configurez le jeu de caractères pour la base de données, vous devez également indiquer le jeu de caractères de l'URL JDBC* dans le fichier
IDM-ds.xml
, comme dans l'exemple suivant :
<connection-url>jdbc:mysql://localhost:3306/ databasename?useUnicode=true&characterEncoding=utf8&connectionCollati on=utf8_bin</connection-url>
Distinction de la casse
Assurez-vous que la distinction de la casse est cohérente sur les serveurs et plates-formes si vous prévoyez sauvegarder et restaurer des données sur des serveurs ou des plates-formes. Pour assurer cette cohérence, indiquez la même valeur (0 ou 1) pour les noms_tables_minuscules
de tous vos fichiers my.cnf
(Linux ou Solaris) ou my.ini
(Windows), au lieu d'accepter la valeur par défaut
(valeurs par défaut Windows à 0 et valeurs par défaut Linux à 1.) Indiquez cette valeur avant de créer la base de données qui contiendra les tables Identity Manager. Vous pouvez par exemple spécifier lower_case_table_names=1 dans les fichiers my.cnf
et my.ini
pour toutes les plates-formes sur lesquelles vous souhaitez sauvegarder et restaurer une base de données.
Paramètre Ansi
Si vous choisissez d'utiliser votre propre programme d'installation pour MySQL 5.1, vous devez ajouter l'entrée ansi
au fichier my.cnf (Linux) ou my.ini (Windows). Si vous ne le faites pas, les tables RBPM sont créées mais les données initiales des tables ne sont pas chargées et vous risquez de recevoir un message d'erreur de type « Définition de page du conteneur de l'invité introuvable ».
Une fois que vous avez ajouté l'entrée ansi
, le fichier my.cnf (ou my.ini) doit se présenter comme suit :
# These variables are required for IDM User Application character_set_server=utf8 default-table-type=innodb
# Put the server in ANSI SQL mode.
#See http://www.mysql.com/doc/en/ANSI_mode.html
ansi
Pour vérifier que la modification permettant d'utiliser le mode Ansi a bien été prise en compte, vous pouvez exécuter l'instruction SQL suivante sur votre serveur MySQL : mysql> select @@global.sql_mode;
+-------------------------------------------------------------+
| @@global.sql_mode |
+-------------------------------------------------------------+
| REAL_AS_FLOAT,PIPES_AS_CONCAT,ANSI_QUOTES,IGNORE_SPACE,ANSI |
+-------------------------------------------------------------+
1 row in set (0.00 sec)
Conditions préalables
25
