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

(C) Copyright IBM Corporation 2004, 2005. 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.

CVS compatibility
The Message Brokers Toolkit Version 5.1 is based on Eclipse 2.1.2, and uses CVS client plugin version 2.1.1. For this version, your CVS server must be at version 1.11.6 or earlier (Linux and UNIX only, CVSNT is not supported).

Información esencial para todos los usuarios

Recomendamos encarecidamente que lea la última versión de este archivo Readme. Puede encontrar la última versión (sólo en inglés) en:
http://www.ibm.com/software/integration/mqfamily/support/readme/

Para finalizar la instalación, consulte el archivo install.html. Incluye información acerca de las tareas que debe completar antes de instalar el producto.

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:

Puede compartir recursos entre versiones en distintos sistemas:

Documentación

Se puede descargar el centro de información de WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker Versión 5.0. Puede descargar el archivo comprimido de: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/wbimb_help.zip

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

Soporte

En este archivo Readme hay referencias a números de defectos. Estos números hacen referencia a los números de problemas de IBM internos; encontrará estos números útiles cuando consulte al representante de servicio de IBM con respecto a algún problema.
Para obtener información acerca de los problemas conocidos y los arreglos disponibles, consulte
http://www.ibm.com/software/integration/wbimessagebroker/support/
para WebSphere Business Integration Message Broker y
http://www.ibm.com/software/integration/wbieventbroker/support/
para WebSphere Business Integration Event Broker.

Actualizaciones de características

Debe comprobar de forma periódica si hay actualizaciones de características, incluidas actualizaciones de la documentación (tanto en inglés como en otros idiomas soportados):
  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:

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.5 Interim Fix 001 - Prerequisite Fixes 1.0.0.1" una vez instalado WebSphere Business Integration Message Broker o WebSphere Business Integration Event Broker.

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

Coexistencia

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; no obstante, puede compartir recursos entre versiones en distintos sistemas: Para obtener información acerca de cómo migrar los recursos y los datos de usuario a la Versión 5.1, consulte la sección sobre migración del centro de información en línea.

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 JavaTM Virtual Machine (JVM) y el Launchpad se cuelga.

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

  2. Defecto 37122
    Un defecto de Installshield hace que el archivo de respuestas utilizado en una instalación silenciosa se interprete de forma incorrecta. Para evitar este problema, lleve a cabo las siguientes acciones:

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

    ---start of response file---------

-P installLocation="C:\Archivos de programa\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:
    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 LAN.
    2. Si el sistema principal se ha configurado para utilizar DHCP para la asignación de IP, asegúrese de que se ha desmarcado el recuadro Detectar la configuración automáticamente.
    3. Si utiliza el servidor proxy, asegúrese de que esté seleccionado No usar servidor proxy para direcciones locales.
    4. En Opciones avanzadas para servidor proxy, añada '127.0.0.1;localhost' en Excepciones si la 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:
  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 copia COBOL: cuando importa un libro de copias COBOL para insertar datos en un archivo de definición de conjuntos 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. Database Views definitions are not supported in the ESQL editor. References to database views in the ESQL code (instead of to schemas or tables) are flagged as warnings (unresolved reference) in the ESQL editor. These warnings do not prevent you from deploying the corresponding ESQL.
    These unresolved reference warnings might also appear when you have migrated a Version 2.1 message flow, because the 5.0 ESQL editor validates database references.
    References to database tables and schemas only are supported.
  8. ESQL compilation restriction: if you create a subflow, and choose to distribute this as a plug-in project, calls to ESQL global routines within the subflow might not be generated correctly when you add a message flow that contains the subflow to a BAR file. When you deploy the BAR file, it will fail.
    Workaround: Implement one of the following options:

Avisos

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

Puede que IBM no ofrezca en otros países los productos, servicios o características descritos en esta información. Solicite a su representante local de IBM información sobre los productos y servicios que están disponibles actualmente en su zona. Las referencias a un producto, programa o servicio de IBM no pretenden afirmar ni sugerir que sólo se pueda utilizar ese producto, programa o servicio de IBM. Se puede utilizar 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 afecten al objeto que se describe en este documento. El hecho de que se proporcione esta información no le otorga ninguna licencia para dichas patentes. Puede enviar consultas sobre licencias por escrito a:

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

El párrafo siguiente no se aplica al Reino Unido o a cualquier otro país donde tales disposiciones no cumplan 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. En algunos estados no está permitida la renuncia a garantías explícitas o implícitas en ciertas transacciones, por lo que es posible que esta declaración no le sea aplicable.

Esta información puede incluir imprecisiones técnicas o errores tipográficos. Se efectúan cambios periódicamente a la información de este documento; 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 sin aviso previo.

Las referencias de este documento a sitios web que no pertenecen a IBM se proporcionan sólo a título informativo y no representan, en modo alguno, una recomendación de esos sitios web. El material de esos sitios web no forma parte del material de este producto de IBM y el usuario corre con toda la responsabilidad derivada del uso de esos sitios web.

IBM puede utilizar o distribuir la información que el usuario proporcione del modo que estime oportuno sin que, por ello, incurra en ninguna obligación ante éste.

Las licenciatarios de este programa que deseen obtener información sobre éste con el fin de habilitar: (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:

Puede que esta información se proporcione en virtud de términos y condiciones aplicables, incluido, en algunos casos, el pago de un importe.

IBM proporciona el programa bajo licencia que se describe en este documento y todo el material bajo licencia disponible para éste bajo los términos del IBM Customer Agreement, el IBM International Programming License Agreement o cualquier contrato equivalente entre IBM y el usuario.

La información referente a productos no IBM se ha obtenido de los proveedores de estos productos, sus anuncios publicados u otras fuentes disponibles públicamente. IBM no ha probado esos productos y no puede confirmar la precisión de funcionamiento, compatibilidad o cualquier otra reclamación relacionada con productos que no pertenecen a IBM. Las preguntas sobre las posibilidades de productos que no pertenecen a IBM deben dirigirse a los proveedores de esos productos.

Esta información incluye ejemplos de datos e informes utilizados en operaciones comerciales diarias. Para que parezcan verídicos, los ejemplos incluyen nombres de personas, compañías, marcas y productos. Todos estos nombres son ficticios y cualquier parecido con los nombres y direcciones utilizados por una empresa real es pura coincidencia.

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 estos programas de ejemplo del modo que considere oportuno sin que, por ello, deba abonar un importe a IBM a fin de desarrollar, utilizar, comercializar o distribuir programas de aplicación de acuerdo con 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. IBM, por lo tanto, no puede garantizar ni implicar la fiabilidad, la capacidad de servicio ni el funcionamiento de estos programas. Puede copiar, modificar y distribuir estos programas de ejemplo del modo que considere oportuno sin que, por ello, deba abonar un importe a IBM a fin de desarrollar, utilizar, comercializar o distribuir programas de aplicación de acuerdo con 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.ibm.com/software/integration/mqfamily/support/summary/wbib.html

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

Requisitos 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.ibm.com/software/integration/mqfamily/support/readme/

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/