24.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 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 24.5. Configurer un adaptateur de ressources par l'interface CLI
- Ouvrir une invite de commande de votre système d'exploitation.
- 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
- 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"}
- 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"}
- 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"}
- 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"}
- 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"}
- 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"}
- 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"}
- Activer l'adaptateur de ressource.
[standalone@localhost:9999 /] /subsystem=resource-adapters/resource-adapter=eis.rar:activate {"outcome" => "success"}
- 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 24.6. Configurer un adaptateur de ressources par la console de management basée-web
- Connectez-vous à la console de gestion. Voir Section 3.4.2, « Se conncecter à la console de gestion ».
- Cliquer sur l'onglet Configuration en haut de l'écran. Étendre le menu Connectors et sélectionner Resource Adapters.
- En mode de domaine, sélectionner Profile à partir du menu déroulant qui se trouve en haut et à gauche.
Cliquer sur Ajouter. - Saisir le nom de l'archive et choisir le type de transaction
XATransaction
à partir du menu déroulant TX:. Ensuite, cliquer sur Save. - Sélectionner l'onglet Properties. Cliquer sur Add.
- Saisir le
serveur
pour le Name (nom) et le nom d'ĥôte, par exemplelocalhost
, pour la valeur Value. Puis cliquer sur Save pour terminer. - Cliquer sur Add à nouveau. Saisir le
port
pour le Name (nom) et le nom dde port, par exemple9000
, pour la valeur Value. Puis cliquer sur Save pour terminer. - Les propriétés
server
etport
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. - Cliquer sur Add qui se trouve au dessus du tableau Available Connection Definitions pour ajouter une définition de connexion.
- Saisir le JNDI Name et le nom de classe complet de la Connection Class. Puis cliquer sur Save pour terminer.
- 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.
- 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.
- 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 afficherEnabled
(activée). - 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.
- Saisir le JNDI Name et le nom de classe Class Name complet de l'objet admin. Puis cliquer sur Save.
- Sélectionner l'onglet Properties, puis cliquer sur Add pour ajouter des propriétés d'objet admin.
- 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 exemple10
, pour la valeur Value. Puis cliquer sur Save pour sauvegarder la propriété. - L'objet admin est maintenant complété, mais non actif. CLiquer sur Enable pour activer l'objet admin.
- Un dialogue vous demande
Souhaitez-vous réellement modifier l'Objet admin?
du nom JNDI. Cliquer sur Confirm. L'objet admin devrait maintenant afficherEnabled
(activé). - 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.
- Charger à nouveau les serveurs
- En mode de domaine, faire glisser le curseur sur le groupe de serveurs. Sécletionner Restart Group.
- En mode standalone, il y aura un bouton Reload disponible. Cliquer sur Reload.
- 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 24.7. Configurer un adaptateur de ressources manuellement
- 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. - 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
.
- Chercher le sous-système
urn:jboss:domain:resource-adapters
dans le fichier de configuration. - 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"/>
par ceci :<subsystem xmlns="urn:jboss:domain:resource-adapters:1.1"> <resource-adapters> <!-- <resource-adapter> configuration listed below --> </resource-adapters> </subsystem>
- 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>
Démarrer le serveur
Lancer à nouveau le serveur JBoss EAP 6 pour qu'il commence à exécuter avec la nouvelle configuration.