IBM^(R) WebSphere^(R) Business Integration Kit de herramientas de Message Brokers Versión 5.1

Historial de cambios:
GA: 23 de julio de 2004
Actualizado: 20 de agosto de 2004
Actualizado: 20 de octubre de 2004
Actualizado: 17 de diciembre de 2004
Fixpack 5: 9 de febrero de 2005
Fixpack 7: 6 de febrero de 2006
Actualizado: 24 de febrero de 2006

(C) Copyright IBM Corporation 2004, 2006. Reservados todos los derechos.

Bienvenido a IBM WebSphere Business Integration Kit de herramientas de Message Brokers Versión 5.1

Este archivo Readme sólo se aplica a la instalación del Kit de herramientas de Message Brokers Versión 5.1 en Microsoft^(R) Windows^(R), así como a su uso con WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker Versión 5.0. Describe los problemas conocidos y contiene actualizaciones de la documentación que no estaban disponibles en el momento de incluirla en el centro de información en línea. Para obtener información adicional sobre el producto también debe consultar el archivo Readme de IBM WebSphere Business Integration Message Brokers Versión 5.0.

AVISO
Instale el Kit de herramientas de Message Brokers Versión 5.1 sólo si ha instalado WebSphere Application Development Integration Edition Versión 5.1. No instale la Versión 5.1 si tiene un nivel anterior de WebSphere Studio Application Developer Integration Edition; en este caso, debe utilizar el Kit de herramientas de Message Brokers Versión 5.0, que se suministra con WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker Versión 5.0. Las funciones del Kit de herramientas de Message Brokers Versión 5.1 son idénticas a las del Kit de herramientas de Message Brokers Versión 5.0.

Instalación del Kit de herramientas de Message Brokers Versión 5.1 en un entorno en equipo
WebSphere Studio Application Developer Integration Edition Versión 5.1 no es un requisito previo para cada instalación del Kit de herramientas de Message Brokers Versión 5.1. Sin embargo, si una sola de las instalaciones de su Kit de herramientas de Message Broker se integra en WebSphere Studio Application Developer Integration Edition Versión 5.1, todas las instalaciones de su Kit de herramientas de Message Broker deben ser de la versión Versión 5.1 para garantizar la integridad de los datos y la posibilidad de compartirlos.

Si no está utilizando WebSphere Studio Application Developer Integration Edition Versión 5.1 en ningún sistema, o si está utilizando WebSphere Studio Application Developer Integration Edition Versión 5.0, debe instalar el Kit de herramientas de Message Brokers Versión 5.0.

Compatibilidad con CVS
El Kit de herramientas de Message Brokers Versión 5.1 está basado en Eclipse 2.1.2 y utiliza el plug-in de cliente CVS versión 2.1.1. Para esta versión, el servidor CVS debe estar en la versión 1.11.6 o anterior (sólo Linux y UNIX, CVSNT no está soportado).

Información esencial para todos los usuarios

Las versiones traducidas del archivo Readme y el archivo install.html están disponibles en: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling

Las versiones traducidas del centro de información no están incluidas en este paquete. Todas las secciones de idiomas nacionales del centro de información están vacías y toda la información se muestra en inglés. Si desea visualizar el centro de información en un idioma soportado que no sea el inglés, debe descargar la característica de Eclipse adecuada una vez instalado el fixpack. Las versiones traducidas están disponibles cuando aparece el fixpack o poco después. Para obtener instrucciones sobre cómo descargar estas actualizaciones, consulte Actualizaciones de características.

Información esencial si está migrando

Si está efectuando una migración, consulte el archivo install.html para obtener detalles de las acciones que debe llevar a cabo antes de realizar la instalación.

Si desea instalar el Kit de herramientas de Message Brokers Versión 5.1 en un sistema en el que ya tiene instalado el Kit de herramientas de Message Brokers Versión 5.0, debe desinstalar primero la Versión 5.0 del kit de herramientas; las dos versiones no pueden coexistir.

El centro de información proporciona más información acerca de la migración; para poder consultarlo antes de la instalación, descargue una versión autónoma del centro de información (consulte el apartado Documentación para obtener instrucciones).

Debe tener en cuenta las siguientes consideraciones acerca de la migración y la difusión:

• Cuando se crean o modifican flujos de mensajes, conjuntos de mensajes y correlaciones de mensajes con la Versión 5.1 del kit de herramientas, ya no es posible volver a acceder a dichos recursos con la Versión 5.0 del kit de herramientas. Asegúrese de que todos los usuarios que comparten proyectos en un entorno en equipo tengan presente esta restricción y realicen las copias de seguridad correspondientes si fuera necesario.
• Debe obtener del proveedor una versión migrada de todos los plug-ins de nodo definidos por el usuario antes de poder difundir satisfactoriamente los flujos de mensajes que los contienen.

Puede compartir recursos entre versiones en distintos sistemas:

• Puede difundir cualquier objeto desarrollado en la Versión 5.0 sin necesidad de modificarlo.
• Puede importar archivos de datos antiguos de intermediario creados en esta versión a un espacio de trabajo de la Versión 5.0 y difundirlos satisfactoriamente.

Documentación

El centro de información en línea para WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker es accesible desde: http://www.ibm.com/software/integration/wbimessagebroker/library/.

También está disponible para su descarga, como un archivo comprimido, desde: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.0/wbimb_help.zip

Lea el archivo installing_and_managing.htm, que encontrará en el archivo wbimb_help.zip.

Soporte

Actualizaciones de características

1. Desde el kit de herramientas, seleccione Ayuda > Actualizaciones de software> Nuevas actualizaciones. Eclipse busca actualizaciones disponibles.
2. Eclipse muestra qué actualizaciones están disponibles. Seleccione las actualizaciones que desee instalar.
3. Cuando seleccione actualizaciones para instalarlas, recibirá un aviso que indica que las características se han firmado de forma digital. Puede pasar por alto este aviso.
4. Después de instalar las características, Eclipse le solicita que vuelva a iniciar el sistema.
5. Cuando haya reiniciado el espacio de trabajo, estas nuevas características estarán instaladas y listas para ser utilizadas.

Contenido

Restricciones y limitaciones:

• WebSphere Studio Application Developer Integration Edition
• Coexistencia
• Instalación
• Después de la instalación

Avisos y marcas registradas

Páginas web de utilidad

Restricciones y limitaciones

Este apartado describe las restricciones y las limitaciones de WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker, por componente.

WebSphere Studio Application Developer Integration Edition

Para ampliar un espacio de trabajo de WebSphere Studio Application Developer Integration Edition con este producto, debe actualizar WebSphere Studio Application Developer Integration Edition al nivel soportado adecuado. La versión del espacio de trabajo de WebSphere Studio Application Developer Integration Edition que puede ampliarse es WebSphere Studio Application Developer Integration Edition Versión 5.1 GA con "Interim Fix 002 - General Fixes 2.0.0". No hay soporte disponible para versiones anteriores de WebSphere Studio Application Developer Integration Edition 5.1.

También debe aplicar el arreglo "WebSphere Business Integration Message Broker v5.1.X Interim Fix 001" después de que haya instalado WebSphere Business Integration Message Broker o WebSphere Business Integration Event Broker, donde X es el número del fixpack que se ha aplicado.

Para obtener instrucciones detalladas, consulte el archivo install.html.

Coexistencia

• Puede difundir cualquier objeto desarrollado en la Versión 5.0 sin necesidad de modificarlo.
• Puede importar archivos de datos antiguos de intermediario creados en esta versión a un espacio de trabajo de la Versión 5.0 y difundirlos satisfactoriamente.

Instalación

1. Defecto 34320
   Durante la instalación, si NO acepta el acuerdo de licencia, aparecerá un menú emergente con los botones SÍ y NO. Independientemente del botón que seleccione, volverá a la página del acuerdo de licencia. Pulsar SÍ debería cancelar la instalación y cerrar el Launchpad.

   Asimismo, si durante la instalación pulsa Atrás en la página del acuerdo de licencia se muestran varios mensajes de error de Java^TM Virtual Machine (JVM) y el Launchpad se cuelga.

   Solución: Acepte el acuerdo de licencia si desea instalar correctamente el producto.

2. Defecto 37122
   Cuando utilice archivos de respuestas para una instalación silenciosa, éstos pueden contener un indicador establecido incorrectamente. Para superar este problema, lleve a cabo las siguientes acciones:
   • Cree un archivo de respuestas, tal como se indica a continuación.
   • Establezca el parámetro installLocation en el directorio de instalación que ha elegido.
   • Establezca el valor del componente a instalar en "true", como se indica en la línea de comentario.

   El ejemplo siguiente instala las herramientas en la ubicación C:\Archivos de programa\IBM\WBIMB.

   ---start of response file---------
   
   -P installLocation="C:\Program Files\IBM\WBIMB"
   -W setupTypes.selectedSetupTypeId=custom
   
   ###############################################################################
   #
   # User Input Field - suiteFeatures
   #
   #
   
   #Do not change this - it sets the installer to ignore the standard custom setup route
   -W featureSelectionIB.active=false
   
   #Set a value to true to install that component
   # If any of the Broker, UNS or Config Manager parameters are set to true, 
   # the core value must also be set to true.  
   # Otherwise set this should be set to false to avoid installing most of the product.
   
   -W enableCore.value=true
   -W setCustomSuiteBrokerFeatureTrue.propertyValue=false
   -W setCustomSuiteUNSFeatureTrue.propertyValue=false
   -W setCustomSuiteConfigMgrFeatureTrue.propertyValue=false
   
   #Set to true if the Message Broker extension features are required.
   #The broker and core features must also be set to true to install this
   
   -W setCustomMessageTrue.value=false
   
   #Set to true if the tooling is required
   -W setCustomToolingTrue.value=true
   
   ------ end of response file----------
   

Después de la instalación

1. Si ha instalado el Kit de herramientas de Message Brokers Versión 5.1 y ha sustituido la Versión 5.0:
   1. Defecto 34555
      Debe volver a crear todos los proyectos que se hayan definido en el espacio de trabajo.
   2. Defecto 34930
      Si VÍA_ACCESO_INSTALACIÓN\eclipse\workspace\.metadata ya existe, es posible que al abrir el Kit de herramientas de Message Brokers el gestor de actualizaciones se inicie correctamente, pero las actualizaciones de los plug-ins fallen y, como consecuencia, el Kit de herramientas de Message Brokers no se abra con los niveles de plug-in correctos y pueden producirse anomalías en el kit de herramientas.
      
      Por ejemplo, si el usuario está en la perspectiva de desarrollo de aplicaciones de intermediario, es posible que falte el elemento del menú Archivo de definiciones de mensajes de la lista generada por Archivo > Nuevo menú. Esto indica que la instalación no contiene el nivel o la versión correctos de los plug-ins del Kit de herramientas de Message Brokers.
      
      Puede comprobar si los niveles de plug-in que utiliza son correctos, seleccionando Ayuda > Acerca del Kit de herramientas de Message Brokers para WebSphere Studio - Intermediario de mensajes en la ventana del Kit de herramientas de Message Brokers para WebSphere Studio. Debajo del título "Kit de herramientas de Message Brokers para WebSphere Studio", aparece un número de versión. Si se utilizan las versiones correctas de los plug-ins después de instalar la Versión 5.1, la versión que se muestra es 5.1.0. Si la versión que aparece es inferior:
      1. Suprima el directorio .metadata.
      2. Vuelva a abrir el Kit de herramientas de Message Brokers.
      3. Vuelva a importar los proyectos existentes en el espacio de trabajo realizando lo siguiente para cada proyecto:
         1. Pulse Archivo > Importar.
         2. Cuando aparezca el asistente de importación, seleccione Proyecto existente en el espacio de trabajo y pulse Siguiente.
         3. Pulse Examinar y defina la ubicación del proyecto en el espacio de trabajo.
         4. Pulse Finalizar.
2. Defecto 32898
   Si los valores de la LAN no se han configurado correctamente para el acceso al sistema principal local, posiblemente debido a los valores existentes en el script de configuración, podría producirse uno de los casos siguientes:
   • El navegador de la ayuda se abre y muestra una página en blanco.
   • El navegador de la ayuda se abre y muestra un error de HTTP en lugar de una página de ayuda.
   • Se produzcan grandes retrasos cuando se carga el centro de información.
   
   Solución: El administrador del sistema puede configurar los valores de la LAN para que se pueda acceder correctamente a los documentos de ayuda desde el servidor de ayuda local, realizando lo siguiente:
   1. En el Panel de control, abra Opciones de Internet, seleccione el separador Conexiones y elija Configuración de LAN.
   2. Si el sistema principal se ha configurado para utilizar DHCP para la asignación de IP, asegúrese de que se ha deseleccionado el recuadro Detectar la configuración automáticamente.
   3. Si utiliza el servidor proxy, asegúrese de que la opción No usar servidor proxy para direcciones locales esté seleccionada.
   4. En Opciones avanzadas para servidores proxy, añada '127.0.0.1;localhost' en Excepciones si esta dirección no aparece listada.
   5. Si utiliza un script de configuración automática para la configuración del proxy, y no está seguro si el script es correcto, deseleccione el recuadro Usar secuencia de comandos de configuración automática.
   
   Si con los pasos anteriores no soluciona el problema, cambie las propiedades de la puerta y del sistema principal en org.eclipse.tomcat\preferences.ini. Los valores host=localhost o host=127.0.0.1 deberían funcionar. Si ejecuta un cortafuegos, también podría ser necesario establecer port=80 (o algún otro valor compatible con el cortafuegos).
3. Defecto T32243
   La extensión de archivo mxsd no se asocia correctamente con el Editor de definiciones de mensajes. Para asegurarse de que los archivos mxsd se abren en el Editor de definiciones de mensajes como acción por omisión, seleccione Ventana > Preferencias > Área de trabajo > Asociaciones de archivos. Desplácese hacia abajo por la lista de tipos de archivo y seleccione *.mxsd. A continuación, seleccione Editor de definiciones de mensajes en la lista de Editores asociados. Pulse Por omisión y, a continuación, Aceptar.
4. Defecto 36638
   El tema de Preferencias del Editor de conjuntos de mensajes (ad15810_) sólo describe las opciones disponibles en la Versión 5.0 del kit de herramientas. Las opciones de la Versión 5.0 no están disponibles en la Versión 5.1. En la Versión 5.1 del kit de herramientas las opciones son:
   • Valores del editor de conjuntos de mensajes, Valores de vista de esquema. Las siguientes opciones se muestran pero no están operativas:
     • Agrupar por espacios de nombres y luego por recopilaciones
     • Agrupar por recopilaciones y luego por espacios de nombres
   • Valores del editor de definiciones de mensajes:
     • Mostrar tipos complejos básicos
       Si ha definido uno o más tipos complejos basados en otros tipos complejos, seleccione esta opción si desea que el contenido de aquéllos que han servido de base se muestre en la visión general del editor de definiciones de mensajes y en las vistas de esquema (esta es la selección predeterminada).
       Si no desea que se muestren, no seleccione este recuadro.
5. Defecto 36655
   Si desinstala el kit de herramientas invocando uninstaller.exe con la opción -silent, el programa de desinstalación devuelve el control inmediatamente y se ejecuta como una tarea de fondo. Si desea que el programa de desinstalación no devuelva el control hasta que haya finalizado, debe invocar el desinstalador de java utilizando este mandato:
   java -cp <dir_instalación>\_uninst\studio\uninstall.jar run -silent
   donde <dir_instalación> es el directorio en el que ha instalado el producto.
   Si no tiene una JVM configurada (Versión 1.3.1 o superior), puede utilizar la JVM del producto instalado en el directorio <dir_instalación>\_sjvm\bin\. Si lo hace, es posible que tenga que suprimir este directorio manualmente al finalizar la desinstalación.
6. Defecto 37671
   Importación de libros de copias COBOL: cuando importa un libro de copias COBOL para insertar datos en un archivo de definición de conjunto de mensajes, compruebe que el libro de copias contiene al menos una estructura de nivel 01. Si no hay ninguna estructura de nivel 01, no se importa ningún objeto (elementos, grupos, tipos).
7. Las definiciones de vistas de base de datos no están soportadas en el Editor ESQL. Las referencias a vistas de base de datos en el código ESQL (en lugar de a esquemas o tablas) se indican como avisos (referencia no resuelta) en el Editor ESQL. Estos avisos no le impiden desplegar el ESQL correspondiente.
   Estos avisos de referencia no resuelta también pueden aparecer cuando ha migrado un flujo de mensajes de Versión 2.1, puesto que el Editor ESQL 5.0 valida referencias de base de datos.
   Sólo están soportadas las referencias a tablas y esquemas de base de datos.
8. Restricción de la compilación ESQL: Si crea un subflujo, y decide distribuirlo como un proyecto de plug-in, las llamadas a rutinas globales ESQL dentro del subflujo podrían no generarse correctamente cuando añada un flujo de mensajes que contenga el subflujo a un archivo BAR. Cuando realice el despliegue del archivo BAR, éste no se ejecutará correctamente.
   Solución provisional: Implemente una de las siguientes opciones:
   • Incluya todas las rutinas a nivel de módulo en el subflujo.
   • Añada los subflujos a su espacio de trabajo y actualice el proyecto que contiene el flujo de mensajes de llamada para que haga referencia al proyecto (o proyectos) de subflujo.

Avisos

Esta información se ha desarrollado para productos y servicios ofrecidos en los Estados Unidos.

Es posible que IBM no ofrezca en otros países los productos, servicios o características descritos en esta información. Solicite información al representante local de IBM sobre los productos y servicios que están disponibles actualmente en su zona. Cualquier referencia a un producto, programa o servicio de IBM no pretende afirmar ni implica que sólo se pueda utilizar ese producto, programa o servicio de IBM. En su lugar puede utilizarse cualquier producto, programa o servicio con funciones equivalentes que no infrinja ningún derecho de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM.

IBM puede tener patentes o solicitudes de patente pendientes que cubran temas descritos en este documento. El hecho de que se proporcione esta información no le otorga ninguna licencia sobre dichas patentes. Puede enviar consultas sobre licencias, por escrito, a:

• IBM Director of Licensing
• IBM Corporation
• North Castle Drive
• Armonk, NY 10504-1785
• U.S.A.

Para realizar consultas sobre licencias relacionadas con la información de doble byte (DBCS), póngase en contacto con el departamento de propiedad intelectual de IBM en su país o envíe las consultas, por escrito, a:

• IBM World Trade Asia Corporation
• Licensing
• 2-31 Roppongi 3-chome, Minato-ku
• Tokyo 106, Japan

El párrafo siguiente no se aplica al Reino Unido ni a ningún otro país donde las disposiciones en él expuestas sean incompatibles con la legislación local:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN "TAL CUAL" SIN GARANTÍA DE NINGÚN TIPO, EXPLÍCITA O IMPLÍCITA, INCLUIDAS, AUNQUE SIN LIMITARSE A ELLAS, LAS GARANTÍAS IMPLÍCITAS DE NO INFRACCIÓN, COMERCIALIZACIÓN O ADECUACIÓN A UN FIN CONCRETO. Algunas legislaciones no contemplan la exclusión de garantías, ni implícitas ni explícitas, en determinadas transacciones, por lo que es posible que esta declaración no se aplique en su caso.

Esta información puede incluir imprecisiones técnicas o errores tipográficos. Periódicamente se efectúan cambios a la información aquí contenida; estos cambios se incorporarán en nuevas ediciones de la información. IBM puede llevar a cabo mejoras y/o cambios en los productos y/o programas que se describen en este documento en cualquier momento y sin previo aviso.

Todas las referencias hechas en este documento a sitios Web que no son de IBM se proporcionan únicamente a título informativo y no representan en modo alguno una recomendación de dichos sitios Web. El contenido de esos sitios Web no forma parte del contenido de este producto de IBM, por lo que la utilización de dichos sitios Web es responsabilidad del usuario.

IBM puede utilizar o distribuir la información que se le suministre del modo que estime oportuno, sin incurrir por ello en ninguna obligación con el remitente.

Las licenciatarios de este programa que deseen obtener información sobre el mismo con el fin de permitir: (i) el intercambio de información entre programas creados de forma independiente y otros programas (incluido éste) y (ii) el uso mutuo de la información que se haya intercambiado, deben ponerse en contacto con:

• IBM United Kingdom Laboratories,
• Mail Point 151,
• Hursley Park,
• Winchester,
• Hampshire,
• England
• SO21 2JN

Dicha información puede estar disponible, sujeta a los términos y condiciones apropiados, incluyendo en algunos casos el pago de una tarifa.

IBM proporciona el programa bajo licencia que se describe en este documento, y todo el material bajo licencia disponible para el mismo, bajo los términos del Contrato de cliente de IBM, el Acuerdo Internacional de Programas bajo Licencia IBM o de cualquier acuerdo equivalente entre IBM y el cliente.

La información referente a productos no IBM se ha obtenido de los distribuidores de dichos productos, de los anuncios publicados o de otras fuentes disponibles públicamente. IBM no ha probado esos productos y no puede confirmar la precisión del rendimiento, la compatibilidad ni ninguna otra afirmación relacionada con productos que no son de IBM. Las preguntas sobre las prestaciones de productos que no pertenecen a IBM deben dirigirse a los proveedores de dichos productos.

Esta información incluye ejemplos de datos e informes utilizados en operaciones comerciales diarias. Para ilustrar los ejemplos de la forma más completa posible, éstos incluyen nombres de personas, compañías, marcas y productos. Todos estos nombres son ficticios y cualquier similitud con los nombres y direcciones utilizados por una empresa real es puramente casual.

LICENCIA DE COPYRIGHT:

Esta información contiene programas de aplicación de ejemplo en lenguaje fuente, que muestran técnicas de programación en distintas plataformas operativas. Puede copiar, modificar y distribuir libremente estos programas de ejemplo, sin pagar por ello a IBM, con la finalidad de desarrollar, utilizar, comercializar o distribuir programas de aplicación conformes a la interfaz de programación de aplicaciones de la plataforma operativa para la que se hayan escrito los programas de ejemplo. Estos ejemplos no se han probado exhaustivamente bajo todas las condiciones. Por consiguiente, IBM no puede garantizar ni dar por implícito la fiabilidad, la capacidad de servicio ni el funcionamiento de estos programas. Puede copiar, modificar y distribuir libremente estos programas de ejemplo, sin pagar por ello a IBM, a fin de desarrollar, utilizar, comercializar o distribuir programas de aplicación conformes a las interfaces de programación de aplicaciones de IBM.

Marcas registradas

Los siguientes términos son marcas registradas de International Business Machines Corporation en los Estados Unidos y/o en otros países:

IBM WebSphere.

Java y todas las marcas registradas basadas en Java son marcas registradas de Sun Microsystems, Inc. en los Estados Unidos y/o en otros países.

Microsoft y Windows son marcas registradas de Microsoft Corporation en los Estados Unidos y/o en otros países.

Otros nombres de empresas, productos o servicios pueden ser marcas registradas o marcas de servicio de terceros.

Páginas web de utilidad

Fixpacks de WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker
http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006041

Requisitos del sistema de WebSphere Business Integration Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/requirements/

Requisitos del sistema de WebSphere Business Integration Event Broker
http://www.ibm.com/software/integration/wbieventbroker/requirements/

Archivo Install.html de WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

Archivos Readme de WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker
http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006913

Centro de información autónomo de WebSphere Business Integration Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/library/

Centro de información autónomo de WebSphere Business Integration Event Broker
http://www.ibm.com/software/integration/wbieventbroker/library/