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

Les administrateurs JBoss peuvent configurer les adaptateurs de ressources pour JBoss Enterprise Application Platform 6 à l'aide du Management 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 20.5. Configurer un adaptateur de ressources par le Management CLI

  1. Ouvrir une invite de commande de votre système d'exploitation.
  2. Connectez-vous au Management 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 20.6. Configurer un adaptateur de ressources par la Console de management basée-web

  1. Démarrer votre serveur de JBoss Enterprise Application Platform 6.
  2. Si vous n'avez pas encore ajouté d'utilisateur, ajoutez-en un maintenant. Pour plus d'informations, voir le chapitre Getting Started du Guide d'installation de JBoss Enterprise Application Platform 6.
  3. Ouvrir un navigateur web et naviguez dans la Console de management. L'emplacement par défaut est http://localhost:9990/console/. Pour plus d'informations sur la Console de management, voir Section 3.4.2, « Connectez-vous à la Console de management ».
  4. Cliquer sur le lien Runtime qui se trouve en haut et à droite pour passer à la vue Profile, puis choisir Resource Adapters dans le panneau de navigation de gauche, et cliquer sur Add (Ajouter) en haut et à droite.
    Adaptateurs de ressources JCA

    Figure 20.10. Adaptateurs de ressources JCA

  5. Saisir le nom de l'archive et choisir le type de transaction XATransaction à partir du menu déroulant TX:. Ensuite, cliquer sur Save.
    Créer un adaptateur de ressources

    Figure 20.11. Créer un adaptateur de ressources

  6. Sélectionner l'onglet Properties, puis cliquer sur Add pour ajouter des propriétés d'adaptateur de ressources.
    Ajouter des propriétés d'adaptateur de ressources

    Figure 20.12. Ajouter des propriétés d'adaptateur de ressources

  7. Saisir le serveur pour le Name (nom) et le nom d'ĥôte, par exemple localhost, pour la valeur Value. Puis cliquer sur Save pour sauvegarder la propriété.
    Ajouter une propriété d'adaptateur de ressources

    Figure 20.13. Ajouter une propriété d'adaptateur de ressources

  8. Saisir le port pour le Name (nom) et le nom d'ĥôte, par exemple 9000, pour la valeur Value. Puis cliquer sur Save pour sauvegarder la propriété.
    Ajouter la propriété de port d'adaptateur de ressource.

    Figure 20.14. Ajouter la propriété de port d'adaptateur de ressource.

  9. 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.
    Propriétés de serveur d'adaptateur de ressources terminé

    Figure 20.15. Propriétés de serveur d'adaptateur de ressources terminé

  10. Cliquer sur Add en haut et à droite de la page pour ajouter une définiton de connexion.
    Ajouter une définition de connexion

    Figure 20.16. Ajouter une définition de connexion

  11. Saisir le JNDI Name et le nom de classe complet de la Connection Class. Puis cliquer sur Next.
    Créer la propriété de définition de connexion - Étape 1

    Figure 20.17. Créer la propriété de définition de connexion - Étape 1

  12. Cliquer sur Add pour saisir la Key (clé) et la Value pour cette définition de connexion.
    Créer la propriété de définition de connexion - Étape 2

    Figure 20.18. Créer la propriété de définition de connexion - Étape 2

  13. Cliquer sur le champ name dans la colonne Key pour autoriser la saisie des données sur ce champ. Saisir le nom de propriété et appuyer sur Entrée pour ce champ. Cliquer sur le champ value dans la colonne Value pour activer la saisie sur ce champ. Saisir la valeur de la propriété et appuyer sur Entrée une fois que c'est fait. Puis, cliquer sur Save pour sauvegarder la propriété.
    Créer la propriété de définition de connexion - Étape 2

    Figure 20.19. Créer la propriété de définition de connexion - Étape 2

  14. La définition de connexion est terminée, mais non activée. Cliquer sur le bouton Enable pour activer la définition de connexion.
    Créer une définition de connexion - Non activée

    Figure 20.20. Créer une définition de connexion - Non activée

  15. 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).
    Définition de connexion maintenant activée

    Figure 20.21. Définition de connexion maintenant activée

  16. 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.
    Objets admin disponibles

    Figure 20.22. Objets admin disponibles

  17. Saisir le JNDI Name et le nom de classe Class Name complet de l'objet admin. Puis cliquer sur Save.
    Créer un objet admin

    Figure 20.23. Créer un objet admin

  18. Sélectionner l'onglet Properties, puis cliquer sur Add pour ajouter des propriétés d'objet admin.
    Ajouter les propriétés d'objet admin

    Figure 20.24. Ajouter les propriétés d'objet admin

  19. 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é.
    Créer une propriété de configuration d'objet admin

    Figure 20.25. Créer une propriété de configuration d'objet admin

  20. L'objet admin est maintenant complété, mais non actif. CLiquer sur Enable pour activer l'objet admin.
    Objet admin - Non actif

    Figure 20.26. Objet admin - Non actif

  21. 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é).
    Définition de connexion maintenant activée

    Figure 20.27. Définition de connexion maintenant activée

  22. Vous devez charger à nouveau la configuration du serveur pour terminer ce processus. Cliquer sur le lien Runtime qui se trouve en haut et à droite pour passer à la vue de Runtime, puis choisir Configuration dans le panneau de navigation de gauche, et cliquer sur Reload (Charger à nouveau) sur la droite.
    Chargement à nouveau de la configuration de serveur

    Figure 20.28. Chargement à nouveau de la configuration de serveur

  23. 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.
    Définition de connexion maintenant activée

    Figure 20.29. Définition de connexion maintenant activée

Procédure 20.7. Configurer un adaptateur de ressources manuellement

  1. Stopper le serveur de JBoss Enterprise Application Platform.

    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'adaptateurs de ressources définis pour ce système. Veuillez commencer par remplacer : 
    
<subsystem xmlns="urn:jboss:domain:resource-adapters:1.0"/>
    par ceci : 
                      

<subsystem xmlns="urn:jboss:domain:resource-adapters:1.0">
    <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 le Management 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 ler serveur

    Lancer à nouveau le serveur JBoss Enterprise Application Platform pour qu'il commence d'exécuter avec la nouvelle configuration.
Report a bug