6.4. Sources de données XA

Procédure 6.7. Créer une source de données XA en utilisant l'interface CLI ou la console de gestion

• • Interface CLI

    1. Section 3.5.2, « Lancement de l'interface CLI ».
    2. Exécuter la commande d'interface de gestion CLI suivante pour créer une source de données XA, et configurer les variables comme il se doit :

       Note

       La valeur de DRIVER_NAME (nom de pilote) dépend du nombre de classes répertoriées dans le fichier /META-INF/services/java.sql.Driver situé dans le JAR du pilote JDBC. S'il n'y a qu'une seule classe, la valeur correspondra au nom du JAR. S'il y a plusieurs classes, la valeur correspondra au nom du JAR + driverClassName + « _ » + majorVersion + « _ » + minorVersion. Toute erreur provoquera l'erreur suivante dans le journal :

       JBAS014775:    New missing/unsatisfied dependencies

       Par exemple, la valeur de DRIVER_NAME qu'il nous faut pour le pilote MySQL 5.1.31 est mysql-connector-java-5.1.31-bin.jarcom.mysql.jdbc.Driver_5_1.

       xa-data-source add --name=XA_DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME --xa-datasource-class=XA_DATASOURCE_CLASS

    3. Configurer les propriétés de la source de données XA

       1. Définir le nom du serveur

          Exécuter la commande suivante pour configurer le nom du serveur de l'hôte :

          /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=ServerName:add(value=HOSTNAME)

       2. Définir le nom de la base de données

          Exécuter la commande suivante pour configurer le nom de la base de données :

          /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=DatabaseName:add(value=DATABASE_NAME)

    4. Activer la source de données :

       xa-data-source enable --name=XA_DATASOURCE_NAME

  • Console de gestion

    1. Section 3.4.2, « Se connecter à la console de gestion ».

    2. Naviguer dans le panneau Datasources qui se trouve dans la console de gestion

       1. Sélectionner Configuration qui se trouve en haut de la console.
       2. En mode de domaine uniquement, sélectionner un profil à partir du menu déroulant qui se trouve en haut et à gauche.
       3. Étendre le menu Subsystems qui se trouve à gauche de la console, puis étendre le menu Connector.
       4. Sélectionner Datasources.
    3. Sélectionner l'onglet XA Datasource.

    4. Créer une nouvelle source de données XA

       1. Cliquer sur Add.
       2. Saisir les attributs de la nouvelle source de données XA de l'assistant Create XA Datasource et cliquer sur Next.
       3. Saisir les informations sur le pilote JDBC dans l'assistant Create XA Datasource et cliquer sur Next.
       4. Saisir les propriétés XA et cliquer sur Next.
       5. Saisir les paramètres de connexion dans l'assistant Create XA Datasource.
       6. Cliquer sur le bouton Test Connection pour tester la connexion à la ressource de données XA et vérifier que les paramètres de configuration soient corrects.
       7. Cliquer sur Done pour terminer.