Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

22.4. Configuration d'un adaptateur de ressources déployées

Les administrateurs JBoss peuvent configurer les adaptateurs de ressources pour JBoss EAP 6 à l'aide de l'interface CLI, de la console de management basée-web, ou en modifiant manuellement la configuration des fichiers.
Voir le document du fournisseur pour votre adaptateur de ressources pour obtenir des informations sur les propriétés prises en charge et autres informations.

Note

Dans la procédure suivante, la ligne de commande que vous devez saisir suit l'invite suivante [standalone@localhost:9999 /]. Ne pas saisir le texte qui se trouve à l'intérieur des accolades. Voici la sortie que vous devriez apercevoir comme résultat, ainsi, {"outcome" => "success"}.

Procédure 22.5. Configurer un adaptateur de ressources par l'interface CLI

  1. Ouvrir une invite de commande de votre système d'exploitation.
  2. Connectez-vous à l'interface CLI.
    • Dans Linux, saisir ce qui suit au niveau de la ligne de commande :
      $ EAP_HOME/bin/jboss-cli.sh --connect
      Vous devriez voir le résultat de sortie suivant :
      $ Connected to standalone controller at localhost:9999
    • Dans Windows, saisir ce qui suit au niveau de la ligne de commande :
      C:\>EAP_HOME\bin\jboss-cli.bat --connect
      Vous devriez voir le résultat de sortie suivant :
      C:\> Connected to standalone controller at localhost:9999
  3. Ajouter la configuration d'adaptateur de ressource.
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:add(archive=eis.rar, transaction-support=XATransaction) 
    {"outcome" => "success"}
    
  4. Configurer la <config-property> server niveau adaptateur de ressources.
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/config-properties=server/:add(value=localhost)          
    {"outcome" => "success"}
    
  5. Configurer la <config-property>port niveau adaptateur de ressources
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/config-properties=port/:add(value=9000)
    {"outcome" => "success"}
    
  6. Ajouter une définition de connexion à la fabrique de connexions gérées.
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/connection-definitions=cfName:add(class-name=com.acme.eis.ra.EISManagedConnectionFactory, jndi-name=java:/eis/AcmeConnectionFactory)
    {"outcome" => "success"}
    
  7. Configurer <config-property> port niveau usine de connexions gérées.
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/connection-definitions=cfName/config-properties=name/:add(value=Acme Inc)
    {"outcome" => "success"}
    
  8. Ajouter un objet admin.
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/admin-objects=aoName:add(class-name=com.acme.eis.ra.EISAdminObjectImpl, jndi-name=java:/eis/AcmeAdminObject)
    {"outcome" => "success"}
    
  9. Configurer la propriété threshold de l'objet admin.
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar/admin-objects=aoName/config-properties=threshold/:add(value=10)
    {"outcome" => "success"}
    
  10. Activer l'adaptateur de ressource.
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:activate
    {"outcome" => "success"}
    
  11. Voir l'adaptateur de ressources nouvellement configuré et activé.
    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:read-resource(recursive=true)
    {
        "outcome" => "success",
        "result" => {
            "archive" => "eis.rar",
            "beanvalidationgroups" => undefined,
            "bootstrap-context" => undefined,
            "transaction-support" => "XATransaction",
            "admin-objects" => {"aoName" => {
                "class-name" => "com.acme.eis.ra.EISAdminObjectImpl",
                "enabled" => true,
                "jndi-name" => "java:/eis/AcmeAdminObject",
                "use-java-context" => true,
                "config-properties" => {"threshold" => {"value" => 10}}
            }},
            "config-properties" => {
                "server" => {"value" => "localhost"},
                "port" => {"value" => 9000}
            },
            "connection-definitions" => {"cfName" => {
                "allocation-retry" => undefined,
                "allocation-retry-wait-millis" => undefined,
                "background-validation" => false,
                "background-validation-millis" => undefined,
                "blocking-timeout-wait-millis" => undefined,
                "class-name" => "com.acme.eis.ra.EISManagedConnectionFactory",
                "enabled" => true,
                "flush-strategy" => "FailingConnectionOnly",
                "idle-timeout-minutes" => undefined,
                "interleaving" => false,
                "jndi-name" => "java:/eis/AcmeConnectionFactory",
                "max-pool-size" => 20,
                "min-pool-size" => 0,
                "no-recovery" => undefined,
                "no-tx-separate-pool" => false,
                "pad-xid" => false,
                "pool-prefill" => false,
                "pool-use-strict-min" => false,
                "recovery-password" => undefined,
                "recovery-plugin-class-name" => undefined,
                "recovery-plugin-properties" => undefined,
                "recovery-security-domain" => undefined,
                "recovery-username" => undefined,
                "same-rm-override" => undefined,
                "security-application" => undefined,
                "security-domain" => undefined,
                "security-domain-and-application" => undefined,
                "use-ccm" => true,
                "use-fast-fail" => false,
                "use-java-context" => true,
                "use-try-lock" => undefined,
                "wrap-xa-resource" => true,
                "xa-resource-timeout" => undefined,
                "config-properties" => {"name" => {"value" => "Acme Inc"}}
            }}
        }
    }
    

Procédure 22.6. Configurer un adaptateur de ressources par la console de management basée-web

  1. Connectez-vous à la console de gestion. Voir Section 3.4.2, « Se connecter à la console de gestion ».
  2. Cliquer sur l'onglet Configuration en haut de l'écran. Étendre le menu Connectors et sélectionner Resource Adapters.
    1. En mode de domaine, sélectionner Profile à partir du menu déroulant qui se trouve en haut et à gauche.
    Cliquer sur Add.
  3. Saisir le nom de l'archive et choisir le type de transaction XATransaction à partir du menu déroulant TX:. Ensuite, cliquer sur Save.
  4. Sélectionner l'onglet Properties. Cliquer sur Add.
  5. Saisir le serveur pour le Name (nom) et le nom d'ĥôte, par exemple localhost, pour la valeur Value. Puis cliquer sur Save pour terminer.
  6. Cliquer sur Add à nouveau. Saisir le port pour le Name (nom) et le nom dde port, par exemple 9000, pour la valeur Value. Puis cliquer sur Save pour terminer.
  7. Les propriétés server et port apparaissent maintenant dans le panneau Properties. Cliquer sur le lien View (Vue) sous la colonne Option pour l'adaptateur de ressources listées pour visualiser les définitions de connexion or Connection Definitions.
  8. Cliquer sur Add qui se trouve au dessus du tableau Available Connection Definitions pour ajouter une définition de connexion.
  9. Saisir le JNDI Name et le nom de classe complet de la Connection Class. Puis cliquer sur Save pour terminer.
  10. Sélectionner la nouvelle définition de connexion, puis sélectionner l'onglet Properties. Cliquer sur le bouton Add pour saisir les données de Key et Value pour cette définition de connexion. Cliquer sur Save pour terminer.
  11. La définition de connexion est terminée, mais non activée. Sélectionner la définition de connexion et cliquer sur le bouton Enable pour activer la définition de connexion.
  12. Un dialogue vous demande Souhaitez-vous réellement modifier la définition de connexion? du nom JNDI. Cliquer sur Confirm. La définition de connexion devrait maintenant afficher Enabled (activée).
  13. Cliquer sur l'onglet Admin Objects qui se trouve dans la partie supérieure de la page pour créer et configurer des objets admin. Puis, cliquer sur Add.
  14. Saisir le JNDI Name et le nom de classe Class Name complet de l'objet admin. Puis cliquer sur Save.
  15. Sélectionner l'onglet Properties, puis cliquer sur Add pour ajouter des propriétés d'objet admin.
  16. Saisir une propriété de configuration d'objet admin, comme par exemple la limite threshold, dans le champ Name (nom). Saisir la valeur de la propriété de configuration, comme par exemple 10, pour la valeur Value. Puis cliquer sur Save pour sauvegarder la propriété.
  17. L'objet admin est maintenant complété, mais non actif. Cliquer sur Enable pour activer l'objet admin.
  18. Un dialogue vous demande Souhaitez-vous réellement modifier l'Objet admin? du nom JNDI. Cliquer sur Confirm. L'objet admin devrait maintenant afficher Enabled (activé).
  19. Vous devez charger à nouveau la configuration du serveur pour terminer ce processus. Cliquer sur le lien Runtime. Étendre le menu Server. Sélectionner Overview dans le panneau de navigation de gauche.
    1. Charger à nouveau les serveurs
      • En mode de domaine, faire glisser le curseur sur le groupe de serveurs. Sélectionner Restart Group.
      • En mode standalone, il y aura un bouton Reload disponible. Cliquer sur Reload.
  20. Un dialogue vous demande Souhaitez-vous charger à nouveau la configuration du serveur ? pour le serveur indiqué. Cliquer sur Confirm. La configuration du serveur sera à jour.

Procédure 22.7. Configurer un adaptateur de ressources manuellement

  1. Stopper le serveur JBoss EAP 6.

    Important

    Vous devez interrompre le serveur avant de modifier le fichier de configuration du serveur pour que votre changement puisse être persisté au redémarrage du serveur.
  2. Ouvrir le fichier de configuration du serveur pour l'éditing.
    • Pour les serveurs autonomes, il s'agit du fichier EAP_HOME/standalone/configuration/standalone.xml.
    • Si vous exécutez dans un domaine géré, il s'agira du fichier EAP_HOME/domain/configuration/domain.xml.
  3. Chercher le sous-système urn:jboss:domain:resource-adapters dans le fichier de configuration.
  4. Il n'y a pas d'adaptateur de ressources défini pour ce système. Veuillez commencer par remplacer :
    
    <subsystem xmlns="urn:jboss:domain:resource-adapters:1.1"/>
    
    
    par ceci :
                      
    
    <subsystem xmlns="urn:jboss:domain:resource-adapters:1.1">
        <resource-adapters>
            <!-- <resource-adapter> configuration listed below -->
        </resource-adapters>
    </subsystem>
    
    
  5. Remplacer la configuration <!-- <resource-adapter> listée ci-dessous --> par la définition XML de l'adaptateur de ressources. Ce qui suit représente la représentation XML de la configuration de l'adaptateur de ressources créé par l'interface CLI et la console de management basée-web décrite ci-dessus.
    
    <resource-adapter>
        <archive>
            eis.rar
        </archive>
        <transaction-support>XATransaction</transaction-support>
        <config-property name="server">
            localhost
        </config-property>
        <config-property name="port">
            9000
        </config-property>
        <connection-definitions>
            <connection-definition class-name="com.acme.eis.ra.EISManagedConnectionFactory" 
                    jndi-name="java:/eis/AcmeConnectionFactory"
                    pool-name="java:/eis/AcmeConnectionFactory">
                <config-property name="name">
                    Acme Inc
                </config-property>
            </connection-definition>
        </connection-definitions>
        <admin-objects>
            <admin-object class-name="com.acme.eis.ra.EISAdminObjectImpl" 
                    jndi-name="java:/eis/AcmeAdminObject" 
                    pool-name="java:/eis/AcmeAdminObject">
                <config-property name="threshold">
                    10
                </config-property>
            </admin-object>
        </admin-objects>
    </resource-adapter>
    
    
  6. Démarrer le serveur

    Lancer à nouveau le serveur JBoss EAP 6 pour qu'il commence à exécuter avec la nouvelle configuration.