6.4. Sources de données XA

6.4.1. Créer une source de données XA par les interfaces de gestion

Résumé

Cette section explique les étapes à suivre pour créer une source de données XA, en utilisant la console de gestion ou l'interface CLI.

Note

Avant la version 10.2 de la source de données Oracle, le paramètre <no-tx-separate-pools/> était requis, car le mélange de connexions transactionnelles et non-transactionnelles auraient créé une erreur. Ce paramètre n'est plus requis pour certaines applications.

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

    • L'interface CLI

      1. Exécuter la commande suivante pour créer une source de données XA, et configurer les variables comme il se doit:
        xa-data-source add --name=XA_DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME --xa-datasource-class=XA_DATASOURCE_CLASS
      2. 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)
      3. Activer la source de données :
        xa-data-source enable --name=XA_DATASOURCE_NAME
    • Console de management

      1. Naviguez 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.
      2. Sélectionner l'onglet XA Datasource.
      3. 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 cliquez 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.
Résultat

La source de données XA a été ajoutée au serveur. Elle est maintenant visible dans le fichier standalone.xml ou le fichier domain.xml, ainsi que dans les interfaces de gestion.