Servicio de conexión de prueba

WebSphere Application Server proporciona un servicio de conexión de prueba para validar las configuraciones de origen de datos. La operación testConnection genera una instancia de la configuración de origen de datos, obtiene una conexión y, a continuación, cierra la conexión de inmediato.

Si asocia los orígenes de datos con las variables de WebSphere, consulte el tema Creación, edición y supresión de variables de WebSphere para verificar que las configura correctamente. Se produce una excepción No se puede encontrar la variable si se intenta utilizar un origen de datos que se ha invocado a través de una variable que no se ha definido correctamente.

Activación del servicio de conexión de prueba

Hay tres formas de activar el servicio de conexión de prueba: mediante la consola administrativa, la herramienta wsadmin o un programa autónomo Java™. Cada proceso invoca los mismos métodos en el mismo MBean.

Consola de administración

WebSphere Application Server permite probar una conexión desde la consola administrativa con sólo pulsar un botón: las páginas Colección de orígenes de datos, Valores de orígenes de datos, Colección de orígenes de datos Versión 4 y Valores de orígenes de datos Versión 4 incluyen todas botones Conexión de prueba. Una vez definido y guardado el origen de datos, puede pulsar este botón para verificar que los parámetros de la definición del origen de datos son los correctos. En la página de la colección, puede seleccionar varios orígenes de datos y probarlos todos a la vez. Tenga en cuanta que se deben cumplir primero determinadas condiciones. Para obtener más información, consulte el tema Prueba de una conexión con la consola administrativa.

Nota: Se produce la excepción siguiente cuando pulsa Conexión de prueba para conectar con un origen de datos Sybase desde la consola administrativa.
La conexión de prueba ha fallado para el origen de datos isagent en el servidor server1 del nodo 
svtaix24Node01 con la excepción siguiente: java.lang.Exception: 
java.sql.SQLException: JZ006: Se ha detectado la excepción IOException: java.net.ConnectException: Un 
host remoto ha rechazado una operación de conexión.DSRA0010E: SQL State = JZ006, 
Código de error = 0
Esta excepción se produce cuando el número de puerto del origen de datos Sybase no coincide con el puerto configurado en el servidor Sybase. El número de puerto predeterminado es 5000. Compruebe el número de puerto para el servidor Sybase en el archivo de interfaces bajo /<directorio_instalación_sybase>.

Herramienta WsAdmin

La herramienta wsadmin proporciona una interfaz de scripts para una amplia gama de actividades de administración de WebSphere Application Server. Como la función de Conexión de prueba se implementa como método en un MBean, y wsadmin puede invocar métodos de MBean, wsadmin se puede utilizar para comprobar conexiones con los orígenes de datos. Tiene dos opciones para probar una conexión de origen de datos mediante wsadmin:

El objeto AdminControl de wsadmin tiene una operación testConnection que comprueba las propiedades de configuración de un objeto de origen de datos. Para obtener información, consulte el tema Prueba de una conexión utilizando wsadmin.

También puede comprobar una conexión invocando la operación de MBean. Utilice el ejemplo del tema Ejemplo: Prueba de conexión de orígenes de datos utilizando wsadmin como guía para esta técnica.

Programa autónomo Java

Finalmente, puede probar una conexión ejecutando el método testConnection en el MBean DataSourceCfgHelper. Este método permite pasar el ID de configuración del origen de datos configurado. El programa Java se conecta con un servidor JMX (Java Management Extensions) en ejecución para acceder al MBean. En una instalación básica de Application Server, se conecta al servidor JMX que se está ejecutando en el servidor de aplicaciones, normalmente en el puerto 8880.

El valor de retorno de esta invocación es 0, un número positivo o una excepción. 0 indica que la operación se ha realizado satisfactoriamente, sin ningún aviso. Un número positivo indica que la operación se ha realizado satisfactoriamente, con el número de avisos. Una excepción indica que no se ha podido realizar la comprobación de la conexión.

Nota: Ejemplo: comprobación de una conexión utilizando testConnection(ConfigID).

El siguiente código de ejemplo crea una instancia de origen de datos y una instancia de conexión asociada, y las prueba para garantizar la conectividad de la base de datos.

Este programa utiliza JMX para conectarse a un servidor en ejecución e invocar el método testConnection en el MBean DataSourceCfgHelper. El acrónimo ND de una línea de comentarios indica que el código siguiente se aplica a WebSphere Application Server WebSphere Application Server, Network Deployment. La palabra Base de una línea de comentarios indica que el código siguiente se aplica a WebSphere Application Server.

/**
 * Descripción
 * Programa de prueba de adaptador de recursos para garantizar que las interfaces del MBean
funcionan.
 * Se prueban las siguientes interfaces
 * 
 *  ---  testConnection()
 * 
 * 
 * Necesitamos lo siguiente para ejecutar
 * C:\src>java -Djava.ext.dirs=C:\WebSphere\AppServer\lib;C:\WebSphere\AppServer\java\jre\lib\ext testDSGUI
 *debe incluir jre para log.jar y mail.jar, o se obtiene una excepción de clase no encontrada
 * 
 * 
 */

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 {

//Utilice el puerto 8880 para la instalación Base o el puerto 8879 para la instalación ND
String port = "8880";
// String port = "8879";
String host = "localhost";
final static boolean verbose = true;

// por ejemplo, un ID de configuración de DataSource declarado a nivel de nodo para la instalación Base
private static final String resURI = "cells/cat/nodes/cat|resources.xml#DataSource_1";

// por ejemplo, un DataSource 4.0 declarado a nivel de nodo para la instalación Base
//    private static final String resURI = "cells/cat/nodes/cat|resources.xml#WAS40DataSource_1";

// por ejemplo, un DataSource de Apache Derby declarado a nivel de servidor para la instalación Base
//private static final String resURI = "cells/cat/nodes/cat/servers/server1/resources.xml#DataSource_6";

// por ejemplo, un DataSource a nivel de nodo para la instalación ND
//private static final String resURI = "cells/catNetwork/nodes/cat|resources.xml#DataSource_1";

// por ejemplo, un DataSource a nivel de servidor para la instalación ND
//private static final String resURI = "cells/catNetwork/nodes/cat/servers/server1|resources.xml#DataSource_4";

// por ejemplo, un DataSource a nivel de célula para la instalación 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);
 }

/**
 * Este método prueba el ResourceMbean.
 * 
 * @param args
 * @exception Exception
 */
 public void run(String[] args) {

           try {

		System.out.println("Connecting to the application server.......");

        /*************************************************************************/
        /**    Inicializar 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: Cannot make a connection to the application server\n");
	    	    ce.printStackTrace();
	    	    System.exit(1);
	}

       /*************************************************************************/
       /**    Localizar el Mbean                                                */
       /*************************************************************************/
		ObjectName handle = null;
	         try {
                // Enviar una serie de localizador 
                // por ejemplo, para una Base, esto es suficiente
                ObjectName queryName = new ObjectName("WebSphere:type=DataSourceCfgHelper,*");

                // para la instalación ND, deberá especificar desde qué nodo/proceso desea realizar la prueba
                // por ejemplo, ejecutar en el servidor
//ND: ObjectName queryName = new OjectName
				 			("WebSphere:cell=catNetwork,node=cat,process=server1,type=DataSourceCfgHelper,*");
                // por ejemplo, ejecutar en el agente de nodo
//ND: ObjectName queryName = new ObjectName
				 			("WebSphere:cell=catNetwork,node=cat,process=nodeagent,type=DataSourceCfgHelper,*");
//ND: por ejemplo, ejecutar en el Gestor
//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()) {
                // utilizar el primer MBean que se encuentra
	 		 	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("Check the program variable queryName" + mone);
	} catch (com.ibm.websphere.management.exception.ConnectorException ce) {
				System.out.println("Cannot connect to the application server" + ce);
	}

         /*************************************************************************/
         /**           Crear parámetros para pasarlos a Mbean                     */
         /*************************************************************************/
		String[] signature = { "java.lang.String" };
		Object[] params = { resURI };
		Object result = null;

       		if (verbose) {
				System.out.println("\nTesting connection to the database using " + handle);
	}

	         try {
               /*************************************************************************/
               /**  Empezar a probar la conexión con la base de datos                   */
               /*************************************************************************/
				result = adminClient.invoke(handle, "testConnection", params, signature);
	} catch (MBeanException mbe) {
				// ****** todas las excepciones de usuario vienen aquí
			if (verbose) {
						Exception ex = mbe.getTargetException(); // ésta es la excepción real del Mbean
						System.out.println("\nNLS:Mbean Exception was received contains " + ex);
			ex.printStackTrace();
				    System.exit(1);
		}
	} catch (InstanceNotFoundException infe) {
				System.out.println("Cannot find " + infe);
	} catch (RuntimeMBeanException rme) {
				Exception ex = rme.getTargetException();
				ex.printStackTrace(System.out);
		throw ex;
	} catch (Exception ex) {
				System.out.println("\nUnexpected Exception occurred: " + ex);
		ex.printStackTrace();
	}

         /*************************************************************************/
         /**  Procesar el resultado.  El resultado será el número de avisos        */
         /**  emitidos.  El resultado 0 indica una conexión satisfactoria sin      */
         /**  avisos. */
         /*************************************************************************/

		//El resultado 0 indica una conexión satisfactoria sin avisos.
		System.out.println("Result= " + result);

  } catch (RuntimeOperationsException roe) {
		Exception ex = roe.getTargetException();
			ex.printStackTrace(System.out);
  } catch (Exception ex) {
		System.out.println("General exception occurred");
			ex.printStackTrace(System.out);
  }
 }
}
Consejo: Asegúrese de ejecutar el servicio de conexión de prueba al mismo nivel que un origen de datos existente. Por ejemplo, no ejecute el servicio de conexión de prueba a nivel de nodo si el origen de datos se configura a nivel de servidor. Si el servicio de conexión de prueba y la configuración de origen de datos no existen en el mismo nivel, es posible que se produzca una excepción de anomalía de carga. En esta situación, cree el origen del script db2profile en la máquina y asegúrese de que el entorno contiene punteros a las bibliotecas nativas de DB2. El script db2profile se encuentra en el directorio raíz del ID de usuario de DB2.

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=cdat_testcon
File name: cdat_testcon.html