Installation Référentiel MySQL

Dans cette section :

MySQL est un serveur de base de données open source que vous pouvez utiliser pour le référentiel WebFOCUS. L'information officielle concernant MySQL est disponible ici :

http://www.mysql.com/

Cette section est fournie pour aider les personnes manquant d'expérience avec MySQL à installer et à configurer MySQL pour l'utiliser avec WebFOCUS.


Haut de page

x
Installation de MySQL

Vous pouvez installer MySQL de cette façon :

  1. Téléchargez le programme d'installation MySQL ici :

    http://www.mysql.com/

    La page suivante contient des liens pour télécharger MySQL :

    http://dev.mysql.com/downloads/mysql/5.0.html

    Vous avez le choix entre télécharger l'installation Windows régulière, ou bien l'installation Windows essentielle.

    La page suivante inclut la documentation pour installer, configurer, administrer, et utiliser MySQL :

    http://dev.mysql.com/doc/mysql/en/index.html

  2. Exécutez le programme d'installation MySQL.

    Une installation typique est suffisante pour WebFOCUS. Vous pouvez garder tous les paramètres par défaut pendant l'installation et la configuration.

  3. Renseignez le mot de passe pour le compte root lorsque vous y êtes invité.

Haut de page

x
Augmentation de la valeur du paramètre max_allowed_packet

Lorsque vous configurez ou que vous migrez le référentiel MySQL pour WebFOCUS, vous devez augmenter la taille du paramètre max_allowed_packet. MySQL recommande que la valeur du paramètre max_allowed_packet pour le client MySQL et le serveur MySQL soit augmenté pour les applications qui utilisent des BLOBs et CLOBs, ce qui est le cas de WebFOCUS.

Pour plus d'informations sur le sujet et comment changer la valeur du paramètre max_allowed_packet pour le client et le serveur MySQL, consultez le site Web suivant :

http://dev.mysql.com/doc/refman/5.1/en/packet-too-large.html


Haut de page

x
Exécution de MySQL

Par défaut, MySQL s'exécute en tant que service Windows. Pour démarrer, arrêter, ou redémarrer SQL :

  1. Ouvrez la fenêtre Services en sélectionnant Panneau de configuration, Outils d'administration, puis Services.
  2. Faites un clic droit sur MySQL et choisissez Démarrer, Arrêter, ou Redémarrer.

MySQL, après son installation, est peut-être en mode exécution par défaut, et démarre automatiquement avec Windows.


Haut de page

x
Administration de MySQL

Vous administrez MySQL en utilisant un outil sur la ligne de commande. Vous pouvez le lancer depuis le menu Démarrer en sélectionnant Programmes, MySQL, MySQL Server 5.0, puis Client Ligne de Commande MySQL.

Connectez-vous via la ligne de commande en utilisant le mot de passe que vous avez spécifié pendant l'installation MySQL.

Vous verrez probablement l'invite suivante :

mysql>

Depuis cette invite, vous pouvez exécuter des commandes SQL et administrer le serveur de base de données.

La documentation MySQL est disponible en ligne ici :

http://dev.mysql.com/doc/mysql/en/index.html


Haut de page

x
Création de la base de données et de l'utilisateur WebFOCUS

Comment :

Vous pouvez utiliser l'outil de la ligne de commande MySQL pour créer une base de données et un utilisateur pour ReportCaster.



x
Comment : Créer la base de données et l'utilisateur MySQL
  1. Ouvrez l'outil de la ligne de commande MySQL et connectez-vous.

    Vous pouvez le lancer depuis le menu Démarrer en sélectionnant Programmes, MySQL, MySQL Server 5.0, puis Client Ligne de Commande MySQL.

  2. A l'invite mysql>, entrez ce qui suit pour créer une nouvelle base de données vide pour WebFOCUS :
    CREATE DATABASE webfocus8;

    où :

    webfocus8

    est le nom de la base de données que vous utiliserez pour le référentiel WebFOCUS. Est sensible à la casse.

    Vous devriez recevoir une réponse semblable à la suivante :

    Query OK, 1 row affected (0.03 sec)
  3. Optionnellement, confirmez que la base de données a été créée en entrant la commande suivante sur l'invite mysql> :
    show databases;

    Vous devriez recevoir une réponse incluant la nouvelle base de données. Par exemple :

    +----------+
    | Database |
    +----------+
    | mysql    |
    | webfocus8|
    | test     |
    +----------+
    3 rows in set (0.00 sec)
  4. A l'invite mysql>, entrez la commande suivante pour créer un nouvel ID utilisateur MySQL et donnez-lui accès à la base de données WebFOCUS :
    GRANT ALL PRIVILEGES ON 
      wf.* TO 'wfuser'@'%'
        IDENTIFIED BY 'wfpass';

    où :

    webfocus8

    est le nom de la base de données que vous utiliserez pour WebFOCUS. Est sensible à la casse dans certains environnements.

    %

    Indique que la base de données est accessible depuis n'importe quel hôte. Pour limiter les hôtes ayant accès à la base de données, fournissez le nom d'hôte ou l'adresse IP de la machine exécutant le client WebFOCUS et le serveur de distribution ReportCaster à la place de %. Si le serveur d'applications est hébergé sur une autre machine, vous aurez à entrer la commande deux fois pour donner accès depuis les deux hôtes.

    webfocus8

    Est l'ID utilisateur que vous créez. Est sensible à la casse dans certains environnements. L'ID utilisateur et mot de passe font partie de MySQL, pas du système d'exploitation.

    rcpass

    Est le mot de passe pour l'ID utilisateur. Est sensible à la casse.

    Si vous avez besoin de changer le mot de passe, vous pouvez ressaisir la commande GRANT pour fournir le nouveau mot de passe. Les nouvelles valeurs vont remplacer tout mot de passe existant.

  5. Optionnellement, confirmez que l'ID utilisateur a été ajouté à la table utilisateur MySQL en saisissant la commande suivante sur l'invite mysql> :
    use mysql

    Ceci a pour effet de sélectionner la base de données MySQL par défaut dans le serveur de base de données.

    Assurez-vous que l'ID utilisateur que vous avez créé existe, et qu'il est bien associé à votre base de données en saisissant la commande suivante sur l'invite mysql> :

    select user,host,db from db;

    Cette requête renvoie tous les ID utilisateur, ainsi que les noms d'hôtes associés aux bases de données auxquelles ils peuvent accéder. Par exemple :

    +--------+------+---------+
    | user   | host | db      |
    +--------+------+---------+
    | wfuser |%     | wf
    +--------+------+---------+

    Après avoir effectué les changements d'ID utilisateur, vous pouvez vous assurer qu'ils ont été actualisés en entrant la commande suivante dans l'invite mysql> :

    FLUSH PRIVILEGES;
  6. Optionnellement, indiquez que la base de données a été créée pour le référentiel en entrant la commande suivante sur l'invite mysql> :
    use wf

    où :

    wf

    est le nom de la base de données que vous utiliserez pour WebFOCUS. Est sensible à la casse dans certains environnements.

  7. Optionnellement, confirmez qu'il n'y a pas de table dans la base de données en entrant la commande suivante à l'invite mysql> :
    show tables;

    Si vous n'avez pas encore créé de table, vous devriez recevoir la réponse suivante :

    Empty set (0.00 sec)

    Après la création des tables du référentiel, vous pouvez utiliser ceci pour confirmer que les tables existent.


Haut de page

x
Installation du pilote JDBC MySQL

Le pilote JDBC MySQL est connu sous le nom MySQL Connector/J 3.1.

  1. Téléchargez le pilote MySQL Connector/J 3.1 depuis :

    http://www.mysql.com/

    La page suivante contient des liens pour télécharger MySQL Connector/J 3.1 :

    http://dev.mysql.com/downloads/connector/j/3.1.html

    Téléchargez le fichier ZIP contenant le code source et le code binaire Java le plus récent. Par exemple :

    mysql-connector-java-3.1.14.zip

    MySQL fournit de nouvelles versions très fréquemment, le numéro dans ce nom de fichier peut donc varier.

  2. Utiliser Winzip pour extraire le fichier JAR du pilote JDBC MySQL. Par exemple :
    mysql-connector-java-3.1.14-bin.jar
  3. Spécifiez le chemin en incluant le fichier JAR lorsque vous y êtes invité pendant l'installation du Client WebFOCUS et du Serveur de distribution ReportCaster. Le chemin incluant le fichier JAR doit se trouver dans la variable CLASSPATH utilisée par votre serveur d'applications client WebFOCUS et votre serveur de distribution ReportCaster. Spécifier le répertoire contenant le fichier JAR n'est pas suffisant.

WebFOCUS