L'outil wsadmin permet de configurer les adaptateurs de ressources Java™ 2 Connector avec les fichiers RAR (Resource
Adapter Archive). Ce fichier RAR fournit les classes et d'autres codes pour prendre en charge un adaptateur de ressources afin d'accéder à un système EIS (Enterprise Information System) spécifique, tel qu'un système CICS (Customer Information Control System). Ne configurez des adaptateurs de ressources pour un système EIS qu'après avoir installé le fichier RAR approprié.
Avant de commencer
Un fichier RAR, qui est souvent dénommé connecteur JCA (Java Connector Architecture), doit être conforme à la spécification JCA 1.5 et 1.6. En outre, pour assurer la compatibilité des adaptateurs de ressources avec JCA version 1.6, les modules RAR prennent en charge les annotations Java. Pour plus d'informations sur la prise en charge des annotations et les métadonnées, consultez la rubrique Prise en charge des annotations dans les modules RAR par la spécification JCA 1.6.
Pour cela, utilisez un outil d'assemblage pris en charge (voir la description fournie dans l'article sur les outils d'assemblage) qui vous permettra d'assembler dans un fichier RAR déployable différents fichiers JAR (fichiers d'archive Java), d'autres composants exécutables, des classes d'utilitaire, etc. Vous êtes ensuite prêt pour installer le fichier RAR dans Application Server.
Vous disposez de deux solutions pour mener à bien cette tâche. Grâce à cette rubrique, vous allez installer des adaptateurs de ressources à l'aide de l'objet AdminConfig.
Mais, pour installer un adaptateur de ressources J2C, vous pouvez aussi utiliser le script installJ2CResourceAdapter de la bibliothèque de scripts AdminJ2C. Exemple :
AdminJ2C.installJ2CResourceAdapter(“myNode", "C:\temp\jca15cmd.rar", "J2CTest")
La bibliothèque de scripts propose un ensemble de procédures
permettant d'automatiser les fonctions d'administration les plus courantes. Vous pouvez
exécuter chaque procédure de script individuellement ou combiner plusieurs
procédures pour développer rapidement de nouveaux scripts.
Procédure
- Lancez le script wsadmin. Pour plus d'informations, reportez-vous à l'article Démarrage du client de scriptage wsadmin.
- Identifiez l'ID configuration du noeud sur lequel l'adaptateur de ressources est installé, comme le montrent les exemples suivants :
Exemple de sortie :
mynode(cells/mycell/nodes/mynode|node.xml#Node_1)
- Identifiez les attributs facultatifs.
L'objet J2CResourceAdapter
ne requiert pas d'arguments spécifiques. Utilisez la commande suivante pour afficher les attributs facultatifs de l'objet J2CResourceAdapter :
La sortie de commande suivante affiche chaque attribut facultatif et le type de données correspondant et précise les attributs par défaut :
Attribut Type Valeur par défaut
name String
description String
classpath String
nativepath String
providerType String
isolatedClassLoader boolean false
archivePath String
threadPoolAlias String Default
singleton boolean false
hACapability ENUM RA_NO_HA
isEnableHASupport boolean false
propertySet J2EEResourcePropertySet
jaasLoginConfiguration JAASConfigurationEntry
deploymentDescriptor Connector
connectionDefTemplateProps ConnectionDefTemplateProps
activationSpecTemplateProps ActivationSpecTemplateProps
j2cAdminObjects J2CAdminObject
adminObjectTemplateProps AdminObjectTemplateProps
j2cActivationSpec J2CActivationSpec
properties Property
- Configurez les attributs de votre choix.
Déterminez les
attributs à configurer pour l'adaptateur de ressources J2C. Dans les exemples
suivants, les commandes définissent le chemin d'accès des fichiers RAR dans la
variable rarFile et les options de configuration des noms et des
descriptions dans la variable option :
- Create a resource adapter.
Utilisez la commande
installResourceAdapter pour que l'objet AdminConfig installe l'adaptateur de
ressources avec les options de configuration précédemment définies, comme
illustré dans les exemples suivants :
Avec Jacl :
$AdminConfig installResourceAdapter $rarFile mynode $option
Avec Jython :
AdminConfig.installResourceAdapter(rarFile, 'mynode', option)
Exemple de sortie :
RAR1(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)
- Enregistrez les modifications apportées à la configuration. Pour plus d'informations, reportez-vous à la rubrique Enregistrement des modifications de configuration avec l'outil wsadmin.
- Dans un environnement de déploiement en réseau uniquement, synchronisez le noeud. Pour plus d'informations, reportez-vous à la rubrique Synchronisation des noeuds à l'aide de l'outil wsadmin.