Service de connexion test

WebSphere Application Server fournit un service de connexion test pour la validation des configurations des sources de données. L'opération testConnection instancie la configuration de la source de données puis ferme immédiatement la connexion.

Si vous associez des sources de données à des variables WebSphere, reportez-vous à la rubrique Création, modification et suppression de variables WebSphere afin de vérifier que vous les configurez correctement. Une exception variable cannot be found (variable introuvable) est générée lors de la tentative d'utilisation d'une source de données qui est appelée par une variable définie de façon erronée.

Activation du service de connexion test

Vous pouvez activer le service de connexion test via la console d'administration, l'outil wsadmin ou un programme Java™ autonome. Chaque processus appelle les mêmes méthodes sur le même MBean.

Console d'administration

WebSphere Application Server vous permet de tester une connexion à partir de la console d'administration en appuyant simplement sur un bouton : les pages Collection de sources de données, Paramètres de la source de données, Collection de sources de données (version 4) et Paramètres de la source de données (version 4) contiennent toutes un bouton Connexion Test. Après avoir défini et sauvegardé une source de données, vous pouvez cliquer sur ce bouton pour vous assurer que les paramètres contenus dans la définition de la source de données sont corrects. Dans la page de la collection, vous pouvez sélectionner plusieurs sources de données et les tester toutes à la fois. Certaines conditions doivent d'abord être remplies. Pour plus d'informations, voir la rubrique Test d'une connexion avec la console d'administration.

Remarque : L'erreur suivante se produit lorsque vous cliquez sur Connexion test pour connecter une source de données Sybase à partir de la console d'administration.
La connexion test a échoué pour la source de données isagent sur le serveur server1 sur le noeud 
svtaix24Node01 avec l'erreur suivante : java.lang.Exception: 
java.sql.SQLException: JZ006: Caught IOException: java.net.ConnectException: A 
Hôte distant a refusé une tentative de connexion. DSRA0010E: SQL State = JZ006, 
Error Code = 0
Cette erreur se produit lorsque le numéro de port de la source de données Sybase ne correspond pas au port configuré sur le serveur Sybase. Le numéro de port par défaut est 5000. Vérifiez le numéro de port du serveur Sybase dans le fichier des interfaces sous /<sybase install directory>.

Outil WsAdmin

L'outil wsadmin fournit une interface de script pour une gamme complète de fonctions d'administration de WebSphere Application Server. Etant donné que la fonctionnalité Test Connection est implémentée en tant que méthode sur un MBean et que wsadmin peut appeler les méthodes de MBean, wsadmin peut être employé pour tester les connexions aux sources de données. Vous disposez de deux options pour tester une connexion de source de données via wsadmin :

L'objet AdminControl de wsadmin comporte une opération testConnection, qui teste les propriétés de configuration d'un objet source de données. Pour plus d'informations, reportez-vous à la rubrique Test d'une connexion avec wsadmin.

Vous pouvez aussi tester une connexion en appelant l'opération MBean. Utilisez la rubrique "Exemple : Test d'une connexion à la source de données à l'aide de wsadmin" comme guide pour appliquer cette technique.

Programme autonome Java

Vous pouvez tester une connexion en exécutant la méthode testConnection sur le MBean DataSourceCfgHelper. Cette méthode vous permet de transmettre l'ID de configuration de la source de données configurée. Le programme Java se connecte à un serveur JMX (Java Management Extensions) pour accéder au MBean. Dans une installation de base d'Application Server, vous vous connectez au serveur JMX qui s'exécute dans le serveur d'applications, généralement sur le port 8880.

La valeur renvoyée par cet appel est 0, un nombre positif ou une exception. 0 indique que l'opération a abouti, sans avertissement. Un nombre positif indique que l'opération a abouti, avec un certain nombre d'avertissements. Une exception indique que le test de la connexion a échoué.

Remarque : Exemple : Test d'une connexion à l'aide de testConnection(ConfigID).

L'échantillon de code suivant crée une instance de source de données et une instance de connexion associée, et les teste pour s'assurer de la connectivité de la base de données.

Ce programme utilise JMX pour établir une connexion avec un serveur en cours d'exécution et appeler la méthode testConnection sur le MBean DataSourceCfgHelper. L'acronyme ND dans une ligne commentaire indique que le code qui suit concerne WebSphere Application Server WebSphere Application Server, Network Deployment. Le mot Base dans une ligne commentaire indique que le code qui suit s'applique à WebSphere Application Server.

/**
 * Description
 * Programme de test d'adaptateur de ressources vérifiant que les interfaces du MBean fonctionnent.
 * Les interfaces suivantes sont testées :
 * 
 *  ---  testConnection()
 * 
 * 
 * L'environnement suivant doit être préalablement défini
 * C:\src>java -Djava.ext.dirs=C:\WebSphere\AppServer\lib;C:\WebSphere\AppServer\java\jre\lib\ext testDSGUI
 * doit comporter le jre pour log.jar et mail.jar, sinon l'exception de classe introuvable est émise
 * 
 * 
 */

import java.util.Iterator;
import java.util.Locale;
import java.util.Properties;
import java.util.Set;

import javax.management.InstanceNotFoundException;
import javax.management.MBeanException;
import javax.management.MalformedObjectNameException;
import javax.management.ObjectName;
import javax.management.RuntimeMBeanException;
import javax.management.RuntimeOperationsException;

import com.ibm.websphere.management.AdminClient;
import com.ibm.websphere.management.AdminClientFactory;
import com.ibm.ws.rsadapter.exceptions.DataStoreAdapterException;

public class testDSGUI {

//Utilisez le port 8880 pour l'installation de base ou le port 8879 pour l'installation ND
String port = "8880";
// String port = "8879";
String host = "localhost";
final static boolean verbose = true;

// exemple : ID de configuration pour source de données déclarée au niveau du noeud pour une installation de base
private static final String resURI = "cells/cat/nodes/cat|resources.xml#DataSource_1";

// exemple : source de données 4.0 déclarée au niveau du noeud pour une installation de base
//    private static final String resURI = "cells/cat/nodes/cat|resources.xml#WAS40DataSource_1";

// exemple : source de données Apache Derby déclarée au niveau du serveur pour une installation de base
//private static final String resURI = "cells/cat/nodes/cat/servers/server1/resources.xml#DataSource_6";

// exemple : source de données au niveau du noeud pour une installation ND
//private static final String resURI = "cells/catNetwork/nodes/cat|resources.xml#DataSource_1";

// exemple : source de données au niveau du serveur pour une installation ND
//private static final String resURI = "cells/catNetwork/nodes/cat/servers/server1|resources.xml#DataSource_4";

// exemple : source de données au niveau de la cellule pour une installation ND
//private static final String resURI = "cells/catNetwork|resources.xml#DataSource_1";

 public static void main(String[] args) {
  testDSGUI cds = new testDSGUI();
  cds.run(args);
 }

/**
 * Cette méthode teste l'objet ResourceMbean.
 * 
 * @param args
 * @exception Exception
 */
 public void run(String[] args) {

  try {

	System.out.println("Connexion au serveur d'applications.......");

        /*************************************************************************/
        /**    Initialisation d'AdminClient                                     */
        /*************************************************************************/	
	Properties adminProps = new Properties();
	adminProps.setProperty(AdminClient.CONNECTOR_TYPE, AdminClient.CONNECTOR_TYPE_SOAP);
	adminProps.setProperty(AdminClient.CONNECTOR_HOST, host);
	adminProps.setProperty(AdminClient.CONNECTOR_PORT, port);
	AdminClient adminClient = null;
	try {
	    adminClient = AdminClientFactory.createAdminClient(adminProps);
	} catch (com.ibm.websphere.management.exception.ConnectorException ce) {
  	    System.out.println("NLS : Impossible d'établir une connexion au serveur d'applications\n");
	    ce.printStackTrace();
	    System.exit(1);
	}

       /*************************************************************************/
       /**    Recherche du Mbean                                                */
       /*************************************************************************/
	ObjectName handle = null;
	try {
                // Envoyer dans une chaîne de pointeur vers une adresse http 
                // par ex., le texte suivant suffit pour une installation de base
                ObjectName queryName = new ObjectName("WebSphere:type=DataSourceCfgHelper,*");

                // Pour une installation ND, vous devez indiquer le noeud/processus à partir                 // duquel le test doit être effectué
                // par ex., sur le serveur
//ND: ObjectName queryName = new OjectName
				("WebSphere:cell=catNetwork,node=cat,process=server1,type=DataSourceCfgHelper,*");
                // par ex., sur l'agent de noeud
//ND: ObjectName queryName = new ObjectName
				("WebSphere:cell=catNetwork,node=cat,process=nodeagent,type=DataSourceCfgHelper,*");
//ND: eg run in the   Manager
//ND: ObjectName queryName = new ObjectName
			("WebSphere:cell=catNetwork,node=catManager,process=dmgr,type=DataSourceCfgHelper,*");
	Set s = adminClient.queryNames(queryName, null);
	Iterator iter = s.iterator();
	while (iter.hasNext()) {
                // utiliser le premier MBean trouvé
	 	handle = (ObjectName) iter.next();
		System.out.println("Found this ->" + handle);
		}
		if (handle == null) {
			System.out.println("NLS: Did not find this MBean>>" + queryName);
			System.exit(1);
		}
	} catch (MalformedObjectNameException mone) {
		System.out.println("Vérifiez la variable programme queryName" + mone);
	} catch (com.ibm.websphere.management.exception.ConnectorException ce) {
		System.out.println("Impossible de se connecter au serveur d'applications" + ce);
	}

         /*************************************************************************/
         /**           Paramètres de génération à transmettre au MBean                          */
         /*************************************************************************/
	String[] signature = { "java.lang.String" };
	Object[] params = { resURI };
	Object result = null;

       	if (verbose) {
		System.out.println("\nTest de la connexion à la base de données en utilisant " +  handle);
	}

	try {
               /*************************************************************************/
               /**  Lancez le test de connexion à la base de données                    */
               /*************************************************************************/
		result = adminClient.invoke(handle, "testConnection", params, signature);
	} catch (MBeanException mbe) {
		// ****** toutes les exceptions utilisateur figurent ici
		if (verbose) {
			Exception ex = mbe.getTargetException(); // il s'agit de l'exception réelle provenant du MBean
			System.out.println("\nNLS : l'exception Mbean qui a été reçue contient " + ex);
			ex.printStackTrace();
			System.exit(1);
		}
	} catch (InstanceNotFoundException infe) {
		System.out.println("Impossible de trouver " + infe);
	} catch (RuntimeMBeanException rme) {
		Exception ex = rme.getTargetException();
		ex.printStackTrace(System.out);
		throw ex;
	} catch (Exception ex) {
		System.out.println("\nUne exception inattendue s'est produite : " + ex);
		ex.printStackTrace();
	}

         /*************************************************************************/
         /**  Traitez le résultat.  Ce sera le nombre d'avertissements             */
         /**  émis.  Un résultat égal à 0 indique l'établissement d'une connexion  */
         /**  avec aucun avertissement.                                                        */
         /*************************************************************************/

	//Un résultat égal à 0 indique l'établissement d'une connexion avec aucun avertissement.
	System.out.println("Result= " + result);

  } catch (RuntimeOperationsException roe) {
	Exception ex = roe.getTargetException();
	ex.printStackTrace(System.out);
  } catch (Exception ex) {
	System.out.println("Une exception générale s'est produite");
	ex.printStackTrace(System.out);
  }
 }
}
Conseil : Vérifiez que vous exécutez le service de connexion test au même niveau qu'une source de données existante. Par exemple, n'exécutez pas le service de connexion test au niveau du noeud si votre source de données est configurée au niveau du serveur. Si le service de connexion test et la source de données ne sont pas au même niveau, un incident de chargement se produit. Dans cette situation, recherchez la source du script db2profile sur l'ordinateur et vérifiez que l'environnement contient des pointeurs désignant les bibliothèques natives DB2. Le script db2profile se trouve dans le répertoire racine de l'ID utilisateur DB2.

Icône indiquant le type de rubrique Rubrique de concept



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