Configuration d'une source de données à l'aide de la console d'administration

Les composants d'applications utilisent une source de données pour accéder aux instances de connexion établies avec une base de données spécifique.

Avant de commencer

Le serveur d'applications prend en charge deux versions différentes d'une source de données. Déterminez la source de données pour votre environnement, en fonction des niveaux du bean enterprise et de spécification de servlet qui constituent la base de vos applications :
  • Les sources de données (WebSphere Application Server version 4) doivent être utilisées avec les spécifications Enterprise JavaBeans (EJB) 1.0 et Java™ Servlet 2.2.
  • Les sources de données de la dernière version standard doivent être utilisées avec les applications mettant en oeuvre les éditions les plus avancées de ces spécifications.

Pourquoi et quand exécuter cette tâche

Lorsque vous créez une source de données, vous l'associez à un fournisseur JDBC (Java Database Connectivity) configuré pour un accès à une base de données fournisseur spécifique. Le serveur d'applications exige que les deux objets de vos applications effectuent des appels vers cette base de donnée spécifique et reçoivent les données de cette dernière. La source de données fournit des capacités de gestion des connexions qui rendent physiquement possibles ces échanges entre vos applications et la base de données.
A faire : Le serveur doit êtrre redémarré pour que la nouvelle source de données soit disponible pour une interface JNDI (Java Naming and Directory Interface) à partir de l'application.

Procédure

  1. Ouvrez la console d'administration.
  2. Accédez au panneau de console approprié. Utilisez un des chemins d'accès suivants :
    • Cliquez sur Ressources > JDBC > Sources de données.
    • Cliquez sur Ressources > JDBC > Sources de données (WebSphere Application Server Version 4)
    • Cliquez sur Ressources > JDBC > Fournisseurs JDBC > fournisseur_JDBC > Sources de données
    • Cliquez sur Ressources > JDBC > Fournisseurs JDBC > fournisseur_JDBC > Sources de données (WebSphere Application Server Version Version 4).
  3. Sélectionnez la portée avec laquelle les applications peuvent utiliser la source de données. Vous pouvez choisir cellule, noeud, cluster ou serveur. Pour plus d'informations, voir la rubrique relative aux paramètres de portée.
    Version 4 uniquement : A partir de maintenant, la procédure de création de sources de données WebSphere Application Server version 4 diffère de celle de la création de sources de données de la dernière version standard. Pour configurer une source de données version 4, procédez comme suit :
    • Cliquez sur Nouveau pour accéder au panneau de la console permettant de définir les propriétés requises.
    • Dans ce panneau de propriétés, indiquez les valeurs des champs groupés sous l'en-tête Configuration. Le serveur d'applications requiert ces propriétés afin de pouvoir implémenter les classes de votre pilote JDBC.
    • Sauvegardez la configuration en cliquant sur OK. Vous avez à présent terminé les premières tâches de configuration de la source de données.
    • Définissez d'autres propriétés susceptibles d'être demandées par le fournisseur de la base de données ou proposez, de façon facultative, d'utiliser le pilote JDBC. Le serveur d'applications les appelle propriétés personnalisées et exige que vous les définissiez sur la source de données. Commencez par cliquer sur le lien Propriétés personnalisées qui apparaît à présent sur le panneau de la console d'administration. Voir la documentation de votre base de données pour obtenir plus d'informations sur les propriétés requises et les propriétés facultatives.

      [z/OS]Vous pouvez également obtenir des informations sur les propriétés facultatives de la source de données dans Application Programming Guide and Reference for Java de votre version de DB2 pour z/OS si vous utilisez le fournisseur de pilote JDBC DB2 Universal ou DB2 à l'aide du pilote JCC IBM® du fournisseur JDBC.

  4. Cliquez sur Nouveau. Cette action entraîne le lancement et l'affichage du panneau Saisie des informations de source de données de base par l'assistant Créer une source de données. Le premier champ, en lecture seule, indique la portée. Il affiche votre sélection antérieure.
  5. Indiquez une source de données dans le champ Nom de la source de données. Ce nom n'est utilisé qu'à des fins d'administration.
  6. Saisissez un nom JNDI (Java Naming and Directory Interface) dans le champ Nom JNDI. Le serveur d'applications associe des références de ressources d'application à cette source de données à l'aide du nom JNDI. Suivez ces conseils lorsque vous spécifiez des noms JNDI :
    • N'attribuez pas deux fois le même nom JNDI à différents types de ressources, tels que les sources de données par opposition aux fabriques de connexions J2C ou aux fabriques de connexions JMS.
    • N'affectez pas de nom JNDI en double à plusieurs ressources d'un même type dans la même portée.
    Pour plus d'informations sur JNDI, voir l'article sur la désignation.
  7. Cliquez sur Suivant pour afficher le panneau Sélectionnez un fournisseur JDBC. Le panneau Sélectionnez un fournisseur JDBC est ignoré si aucun fournisseur JDBC n'est configuré pour la portée actuelle.
  8. Sélection ou création d'un fournisseur JDBC.
    • Sélection d'un fournisseur JDBC existant
      1. Cliquez sur l'option de sélection d'un fournisseur JDBC existant.
      2. Sélectionnez un pilote JDBC dans la liste.
      3. Cliquez sur Suivant. Le panneau Entrez des propriétés spécifiques à la base de données pour la source de données s'affiche à présent.
    • Créez un fournisseur JDBC.
      1. Cliquez sur l'option de création d'un nouveau fournisseur JDBC.
      2. Cliquez sur Suivant pour afficher le panneau >Création d'un fournisseur JDBC.
      3. Utilisez la première liste déroulante pour sélectionner le type de base de données du fournisseur JDBC à créer.
        Option Défini par l'utilisateur : En présence d'un des scénarios suivants, sélectionnez le type de base de données défini par l'utilisateur :
        • Vous ne visualisez pas le type de base de données.
        • Vous ne pouvez pas sélectionner le type de fournisseur JDBC dont vous avez besoin à l'étape suivante.
        Cette sélection conduit l'assistant à afficher votre type de fournisseur en tant que Fournisseur JDBC défini par l'utilisateur, et votre type d'implémentation en tant que Défini par l'utilisateur. Consultez la documentation de votre base de données pour connaître les fichiers de classe JDBC, les propriétés de sources de données, etc. nécessaires pour votre fournisseur défini par l'utilisateur. Vous devez fournir ces informations sur les deux panneaux suivants de l'assistant :
        • informations de chemin d'accès aux classes de base de données ;
        • propriétés spécifiques de base de données.
      4. Si le fournisseur JDBC s'affiche dans la seconde liste, sélectionnez votre type de fournisseur JDBC. Sélectionnez Afficher les fournisseurs obsolètes pour déclencher l'affichage des fournisseurs en cours et obsolètes. Si le fournisseur voulu est introuvable dans la liste déroulée, sélectionnez Défini par l'utilisateur dans la liste précédente des types de base de données.
      5. Dans la troisième liste, sélectionnez le type d'implémentation nécessaire à votre application. Si l'application ne requiert pas de connexions prenant en charge les transactions à validation en deux phases, sélectionnez Source de données du pool de connexions. Toutefois, si votre application requiert des connexions prenant en charge les transactions à validation en deux phases, sélectionnez Source de données XA. Les applications qui utilisent cette configuration de source de données bénéficient d'une reprise des transactions gérées par conteneur.

        Une fois un type d'implémentation sélectionné, l'assistant complète les champs de nom et de description pour votre fournisseur JDBC. Vous pouvez saisir différentes valeurs dans ces champs ; ils ne sont utilisés qu'à des fins administratives.

      6. Cliquez sur Suivant après avoir défini le type de votre base de données, le type de fournisseur et le type d'implémentation. Vous visualisez à présent le panneau de l'assistant de la saisie des informations de chemin d'accès aux classes de base de données.
      7. Dans le champ du chemin d'accès aux classes, entrez l'emplacement du chemin complet des fichiers de classes du pilote JDBC de la base de données. Les informations de chemin d'accès aux classes deviennent la valeur de la variable d'environnement WebSphere qui s'affiche sur ce panneau, sous la forme ${DATABASE_JDBC_DRIVER_PATH}. Le serveur d'applications définit votre fournisseur JDBC à l'aide de la variable. Vous ne devez plus de ce fait spécifier des chemins d'accès aux classes JDBC statiques d'applications individuelles. N'oubliez pas que si vous n'indiquez pas le chemin d'accès aux classes complet et correct du pilote JDBC pour la variable, vous obtenez un échec au niveau de la source de données. Si le champ présente déjà un chemin de classe qualifié complet, vous pouvez accepter cette définition de variable en complétant le reste du panneau de l'assistant et en cliquant sur Suivant.
      8. A l'aide de la zone Chemin d'accès à la bibliothèque native, indiquez des fichiers de classe supplémentaires dont votre pilote JDBC peut avoir besoin pour fonctionner correctement sur votre plateforme de serveur d'applications. Entrez le nom complet du chemin d'accès au répertoire de ces fichiers de classe.
      9. Cliquez sur Suivant. Le panneau Entrez des propriétés spécifiques à la base de données pour la source de données s'affiche à présent.
  9. Renseignez toutes les zones du panneau Entrez des propriétés spécifiques à la base de données pour la source de données.
    • Cochez la case Utiliser cette source de données dans la persistance CMP pour que les beans enterprise CMP (à persistance gérée par conteneur) accèdent à cette source de données.
    • Les autres champs de propriété qui sont affichés dans le panneau de l'assistant sont propres au type de votre base de données. Consultez la rubrique Paramètres minimum requis des sources de données par fournisseur pour plus d'informations sur ces paramètres de propriété. Cet article traite des fournisseurs JDBC en cours et obsolètes prédéfinis dans le serveur d'applications.
      Sources de données définies par l'utilisateur : Ce panneau de l'assistant n'affiche pas de champ de propriété supplémentaire pour les sources de données qui correspondent aux fournisseurs JDBC définis par l'utilisateur. Toutefois, à partir des fichiers classe des pilotes JDBC que vous avez installés, le serveur d'applications peut généralement extraire les noms de propriété des sources de données nécessaires. Le serveur d'applications les définit en tant que propriétés de sources de données personnalisées. Il les affiche également sur un panneau de console relatif aux propriétés personnalisées et leur affecte des valeurs par défaut. Consultez la documentation de votre base de données pour savoir comment configurer ces propriétés et connaître les conditions relatives à la source de données définie par l'utilisateur. Une fois la source de données créée, accédez au panneau de collection de propriétés personnalisées correspondante de la console d'administration en cliquant sur Sources de données > source_données > Propriétés personnalisées. Passez en revue les valeurs par défaut des propriétés, et modifiez-les éventuellement.

      Les serveurs d'applications ne peuvent extraire que des propriétés propres au fournisseur des fichiers de classe du pilote si vous installez les fichiers sur le noeud du gestionnaire de déploiement et si vous configurez correctement les variables WebSphere qui leur sont spécifiques. Dans le cas contraire, le produit affiche un message d'informations (par opposition à un message d'erreur) qui vous invite à définir manuellement les propriétés voulues comme propriétés personnalisées.

  10. Facultatif : Configurez les alias de sécurité pour la source de données. Vous pouvez sélectionnez Aucun pour chaque méthode d'authentification ou choisir un des types d'alias ci-après :
    • Utiliser l'alias d'authentification géré par composant - indique un alias d'authentification à utiliser lorsque la valeur res-auth de référence de ressource de composant est Application. Pour définir un nouvel alias, allez dans Articles liés > Entrées relatives aux données d'authentification du connecteur J2EE. Un alias géré par composant représente une combinaison d'ID et de mot de passe spécifiée dans une application pour authentification de la source de données. Par conséquent, l'alias que vous définissez sur la source de données doit être identique à celui du code de l'application.
      1. A l'aide de la liste déroulante, sélectionnez un alias d'authentification géré par composant existant.
      2. Pour créer un nouvel alias, cliquez sur les liens fournis. Cette action ferme l'assistant de source de données et incite la console d'administration à afficher le panneau de données d'authentification J2C. Cliquez sur Nouveau pour définir un nouvel alias. Cliquez sur OK pour enregistrer vos paramètres et visualiser le nouvel alias dans le panneau de données d'authentification J2C. Redémarrez l'assistant de source de données en accédant à nouveau au panneau de collection de sources de données, en sélectionnant la portée appropriée et en cliquant sur Nouveau.
      Pour plus d'informations sur la sécurité J2C (Java 2 Connector), voir la rubrique relative à la gestion des entrées de données d'authentification Java 2 Connector Architecture.
    • Alias de configuration de mappage - est utilisé seulement en l'absence de configuration de connexion dans la référence de ressource de composant. La spécification d'une configuration de connexion et des propriétés associées sur la référence de ressource de composant est la meilleure manière de définir la stratégie d'authentification lorsque la valeur res-auth est Conteneur. Si vous spécifiez la configuration de connexion DefaultPrincipalMapping, la propriété associée est un alias d'entrée de données d'authentification JAAS - J2C.
    • Alias d'authentification géré par conteneur - est utilisé seulement en l'absence de configuration de connexion dans la référence de ressource de composant. La spécification d'une configuration de connexion et des propriétés associées sur la référence de ressource de composant détermine la stratégie d'authentification gérée par conteneur lorsque la valeur d'autorisation de ressource est définie sur Conteneur.
    Remarque : Si vous avez défini les domaines de sécurité dans le serveur d'applications, vous pouvez cliquer sur Parcourir pour sélectionner un alias d'authentification pour la ressource que vous configurez. Les domaines de sécurité prennent en charge les alias d'authentification d'isolement entre les serveurs. L'affichage de l'arborescence permet de déterminer le domaine de sécurité auquel appartient un alias et les serveurs pouvant accéder à chaque alias d'authentification. L'affichage de l'arborescence est adapté à chaque ressource, les domaines et alias que vous ne pouvez pas utiliser sont donc masqués.
  11. Cliquez sur Suivant pour afficher le panneau Récapitulatif, et afficher de nouveau les informations relatives à la source de données. Si une information est incorrecte, vous pouvez cliquer sur Précédent pour revenir en arrière et la corriger.
  12. Cliquez sur Fin pour enregistrer la configuration et quitter l'assistant. Vous visualisez à présent le tableau Sources de données qui affiche votre nouvelle configuration dans un tableau avec les autres sources de données configurées pour la même portée.

Que faire ensuite

  • Vous pouvez remplacer les valeurs par défaut de certaines propriétés de source de données.
  • Vous pouvez configurer des propriétés supplémentaires dont le fournisseur de votre base de données pourrait avoir besoin ou qu'il propose comme options. Pour plus d'informations sur ces paramètres, consultez la documentation de votre base de données.
  • [z/OS]Si vous utilisez le fournisseur de pilote JDBC DB2 Universal ou DB2 à l'aide du pilote JCC IBM, vous obtiendrez des informations sur les propriétés facultatives des sources de données dans le guide Application Programming Guide and Reference for Java de votre version de DB2 pour z/OS.
  • Vous pouvez ajouter la propriété personnalisée commitOrRollbackOnCleanup aux paramètres d'une source de données JDBC si vous souhaitez qu'une action ait lieu avec une tâche non validée si votre source de données JDBC se ferme de manière inattendue. Les valeurs pouvant être définies pour cette propriété sont commit ou rollback.

    Si votre source de données JDBC prend en charge la détection des unités de travail (UOW), cette propriété s'applique uniquement lorsque vous travaillez dans une unité de travail discrète. Si votre source de données JDBC ne prend pas en charge la détection des unités UOW, cette propriété s'applique toujours.

    Si vous n'ajoutez pas cette propriété à vos paramètres de source de données JDBC, toute transaction implicite détectée est annulée et votre application doit gérer les transactions implicites non détectées.

    Pour ajouter cette propriété personnalisée à vos paramètres de configuration de la source de données JDBC :
    1. Dans la console d'administration, cliquez sur Fournisseurs JDBC > nom_fournisseur_JDBC > Sources de données > source_de_données > Propriétés personnalisées > Nouveau.
    2. Entrez commitOrRollbackOnCleanup dans la zone Nom et commit ou rollback dans la zone Valeur.
    3. Enregistrez les modifications.

Les rubriques suivantes de ce centre de documentation vous indiquent comment utiliser la console d'administration pour affecter les valeurs de propriété :


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_ccrtpds
Nom du fichier : tdat_ccrtpds.html