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

Procédure 21.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
     

     Copy to Clipboard Toggle word wrap
     Vous devriez voir le résultat de sortie suivant :

     $ Connected to standalone controller at localhost:9999
     

     Copy to Clipboard Toggle word wrap
   • Dans Windows, saisir ce qui suit au niveau de la ligne de commande :

     C:\>EAP_HOME\bin\jboss-cli.bat --connect
     

     Copy to Clipboard Toggle word wrap
     Vous devriez voir le résultat de sortie suivant :

     C:\> Connected to standalone controller at localhost:9999
     

     Copy to Clipboard Toggle word wrap
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"}
   

   Copy to Clipboard Toggle word wrap
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"}
   

   Copy to Clipboard Toggle word wrap
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"}
   

   Copy to Clipboard Toggle word wrap
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"}
   

   Copy to Clipboard Toggle word wrap
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"}
   

   Copy to Clipboard Toggle word wrap
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"}
   

   Copy to Clipboard Toggle word wrap
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"}
   

   Copy to Clipboard Toggle word wrap
10. Activer l'adaptateur de ressource.

    [standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:activate
    {"outcome" => "success"}
    

    Copy to Clipboard Toggle word wrap
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"}}
            }}
        }
    }
    

    Copy to Clipboard Toggle word wrap

Procédure 21.6. Configurer un adaptateur de ressources par la Console de gestion basée-web

1. Démarrer votre serveur JBoss EAP 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 EAP 6.
3. Ouvrir un navigateur web et naviguez dans la Console de gestion. L'emplacement par défaut est http://localhost:9990/console/. Pour plus d'informations sur la Console de gestion, voir Section 3.4.2, « Se conncecter à la console de gestion ».
4. Cliquer sur le lien Runtime pour passer à la vue Profile, puis choisir Resource Adapters dans le panneau de navigation de gauche, et cliquer sur Add (Ajouter).
5. Saisir le nom de l'archive et choisir le type de transaction XATransaction à partir du menu déroulant TX:. Ensuite, cliquer sur Save.
6. Sélectionner l'onglet Properties, puis cliquer sur Add pour 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é.
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é.
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.
10. Cliquer sur Add en haut et à droite de la page pour ajouter une définiton de connexion.
11. Saisir le JNDI Name et le nom de classe complet de la Connection Class. Puis cliquer sur Next.
12. Cliquer sur Add pour saisir la Key (clé) et la Value pour cette définition de connexion.
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é.
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.
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).
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.
17. Saisir le JNDI Name et le nom de classe Class Name complet de l'objet admin. Puis cliquer sur Save.
18. Sélectionner l'onglet Properties, puis cliquer sur Add pour ajouter des 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é.
20. L'objet admin est maintenant complété, mais non actif. CLiquer sur Enable pour activer l'objet admin.
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é).
22. Vous devez charger à nouveau la configuration du serveur pour terminer ce processus. Cliquer sur le lien Runtime pour passer à la vue de Runtime, puis choisir Configuration dans le panneau de navigation de gauche, et cliquer sur Reload (Charger à nouveau).
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.

Procédure 21.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'adaptateurs de ressources définis pour ce système. Veuillez commencer par remplacer :

   <subsystem xmlns="urn:jboss:domain:resource-adapters:1.1"/>
   
   
   

   Copy to Clipboard Toggle word wrap

   par ceci :

                     
   
   <subsystem xmlns="urn:jboss:domain:resource-adapters:1.1">
       <resource-adapters>
           <!-- <resource-adapter> configuration listed below -->
       </resource-adapters>
   </subsystem>
   
   
   

   Copy to Clipboard Toggle word wrap
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 gestion 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>
   
   
   

   Copy to Clipboard Toggle word wrap

6. Démarrer ler serveur

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