Archivo README de IBM^(R) WebSphere^(R) Business Integration Message Brokers Toolkit Versión 5.1

Historial de cambios:
GA: 23 de Julio de 2004
Updated: 20 August 2004

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

Bienvenido a IBM WebSphere Business Integration Message Brokers Toolkit Versión 5.1. Este archivo README contiene la información que no estaba disponible en su día para nuestro centro de información en línea. Se aplica solamente a la instalación de Message Brokers Toolkit Versión 5.1 en Microsoft^(R) Windows^(R) y su uso con WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker Versión 5.0.

ATENCIÓN
Instale Message Brokers Toolkit Versión 5.1 solamente si ha instalado WebSphere Application Development Integration Edition (WSADIE) Versión 5.1. No instale la Versión 5.1 si tiene un nivel anterior de WSADIE; para esto debe utilizar Message Brokers Toolkit Versión 5.0 que se proporciona con WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker Versión 5.0. Message Brokers Toolkit Versión 5.1 tiene una función idéntica a Message Brokers Toolkit Versión 5.0.3 (Fixpack 3).

Para obtener información acerca de todos los demás componentes de WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker Versión 5.0, consulte el archivo README Versión 5.0.

Installing Message Brokers Toolkit Version 5.1 in a team environment
WSADIE Version 5.1 is not a prerequisite for every installation of the Message Brokers Toolkit Version 5.1. However, if at least one of your Message Broker Toolkit installations integrates with WSADIE Version 5.1, all your Message Broker Toolkit installations must be at Version 5.1 to ensure data sharing and integrity.

If you are not using WSADIE Version 5.1 on any system, or you are using WSADIE Version 5.0, you must install Message Brokers Toolkit Version 5.0.

Información esencial para todos los usuarios
Recomendamos encarecidamente que lea la última versión del README. Puede encontrar la última versión de este README (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.

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

Información esencial si está migrando

If you are migrating, refer to the install.html file for details of the actions that you must take before you install.

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first; the two versions cannot coexist.

The information center provides further information about migration; to view this before you install, download a stand-alone version of the information center (see the "Documentation" section for instructions).

Debe tener en cuenta estos aspectos de la migración y el despliegue:

• Cuando crea o modifica flujos de mensajes, conjuntos de mensajes y correlaciones de mensajes del kit de herramientas de la Versión 5.1, ya no puede acceder a estos recursos en un kit de herramientas de la Versión 5.0. Asegúrese de que todos los usuarios que comparten proyectos en un entorno de equipo conozcan esta restricción y efectúen copias de seguridad según sea necesario.
• Debe solicitar al proveedor una versión migrada de todos los plugins de nodo definidos por el usuario para poder desplegar correctamente los flujos de mensajes que los contienen.

Puede compartir recursos entre versiones de sistemas diferentes:

• Puede desplegar cualquier proyecto que haya desarrollado en la Versión 5.0 sin tener que modificarlo.
• Puede importar los archivos de intermediario que se han creado en esta versión a un espacio de trabajo de la versión 5.0 y desplegarlos correctamente.

Documentación
El centro de información en línea para WebSphere Business Integration Message Broker y WebSphere Business Integration Event Broker Versión 5.0 se ha actualizado para incluir los cambios necesarios para Message Brokers Toolkit Versión 5.1 y se puede descargar. Puede bajarse el archivo zip desde: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip

Lea el archivo installing_and_managing.htm que se incluye en el archivo wbimb_help.zip.

Soporte
En este documento 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 actual acerca de problemas conocidos y los arreglos disponibles, consulte en:
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 funciones
Debe comprobar de forma periódica si hay actualizaciones de funciones, incluidas actualizaciones de la documentación.

Siga estos pasos:

1. Desde el kit de herramientas, seleccione Ayuda > Actualizaciones de software > Nuevas actualizaciones. Eclipse busca las actualizaciones disponibles.
2. Eclipse muestra las actualizaciones que están disponibles. Seleccione las actualizaciones que desee instalar.
3. Cuando seleccione actualizaciones para instalarlas, recibirá un aviso que indica que las funciones no se han firmado de forma digital. Puede pasar por alto este aviso.
4. Después de instalar las funciones, Eclipse le solicita que vuelva a iniciar el sistema.
5. Una vez reiniciada el área de trabajo, estas funciones se instalan y están 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 útiles

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 área de trabajo de WebSphere Studio Application Developer Integration Edition (WSADIE) con este producto, debe actualizar WSADIE al nivel soportado correspondiente. La versión del área de trabajo de WSADIE que se puede ampliar es WSADIE Versión 5.1 GA con el "arreglo temporal 002 y los arreglos generales 2.0.0".

También debe aplicar el "arreglo temporal 001 y los arreglos que se requieren previamente de 1.0.0.1 de WebSphere Business Integration Message Broker versión 5.1.0" después de haber instalado WebSphere Business Integration Message Broker o WebSphere Business Integration Event Broker.

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

Coexistencia

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first. The two versions cannot coexist, however you can share resources between versions on different systems:

• Puede desplegar cualquier proyecto que haya desarrollado en la Versión 5.0 sin tener que modificarlo.
• Puede importar los archivos de intermediario que se han creado en esta versión a un espacio de trabajo de la versión 5.0 y desplegarlos correctamente.

Para obtener información acerca de cómo migrar los recursos y los datos de usuario a la Versión 5.1, consulte el apartado sobre migración del centro de información en línea.

Instalación

1. 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 la JVM (Java^TM Virtual Machine) el Launchpad se cuelga.

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

Después de la instalación

1. Si ha instalado Message Brokers Toolkit Versión 5.1 y ha sustituido la Versión 5.0:
   1. Error 34555
      Debe volver a crear todos los proyectos que estén definidos en su espacio de trabajo.
   2. Error 34930
      Si existe INSTALL_PATH\eclipse\workspace\.metadata, es posible que cuando abra Message Brokers Toolkit, el gestor de actualizaciones se inicie correctamente pero que las actualizaciones de los plugins no lo hagan. Debido a esto, el kit de herramientas de Message Brokers no se abre con los niveles de plugin correctos, entonces pueden producirse anomalías en el kit de herramientas.
      
      Por ejemplo, si está en la perspectiva de Broker Application Development, es posible que falte el elemento del menú Archivo de definiciones de mensajes de la lista generada por Archivo> Menú nuevo. Esto indica que la instalación no contiene el nivel o la versión correctos de los plugins de Message Brokers Toolkit.
      
      Puede comprobar si los niveles de los plugins que utiliza son correctos, pulsando Ayuda >Acerca de Message Brokers Toolkit para WebSphere Studio - Intermediario de mensajes en la ventana de Message Brokers Toolkit para WebSphere Studio. Debajo del título "Message Brokers Toolkit para WebSphere Studio", aparece un número de versión. Si se están utilizando las versiones correctas de los plugins después de instalar la Versión 5.1, la versión que se visualiza es la 5.1.0. Si la versión que aparece es inferior:
      1. Suprima el directorio .metadata.
      2. Vuelva a abrir el Kit de herramientas del intermediario de mensajes.
      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, elija la opción 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. Error 32898
   Si los valores de la LAN no se han configurado correctamente para el acceso al sistema principal local, posiblemente es provocado por los valores del 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 producen 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 desmarcado el recuadro Detectar la configuración automática.
   3. Si utiliza el servidor proxy, asegúrese de que esté seleccionado No usar servidor proxy para direcciones locales.
   4. En Opciones avanzadas para proxies, 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. Defect T32243
   The mxsd file extension is not associated correctly with the Message Definition Editor. To ensure that mxsd files are opened in the Message Definition Editor as the default action, select Window > Preferences > Workbench > File Associations. Scroll down the list of file types and select *.mxsd. Then select Message Definition Editor in the list of Associated editors. Click Default then OK.
4. Defect 36422
   In the topic "Distributing a user-defined node" in the online information center, the instructions about extracting the zip file are incorrect. Step 2 of the instructions tells you to unzip the file to the install_dir\eclipse\plugins directory. Instead, the correct location to unzip the file to is the WBIMB_install_dir\evtoolkit\eclipse\plugins directory.
   In the topic "Installing a user-defined extension on a broker domain" in the online information center, the install location for Windows is ambiguous. For C user-defined nodes, the topic tells you to use the location install_dir\bin. This should be WBIMB_install_dir\bin. For Java user-defined nodes, the topic tells you to use the location install_dir\jplugin. This should be WBIMB_install_dir\jplugin.
5. Defect 36589
   If you use any of the predefined ESQL constants, such as MQMO_NONE, in ESQL code, the code is flagged as Message Brokers Toolkit Version 5.0 compatible. This means that you cannot deploy message flows referencing this ESQL code to a Version 2.1 broker, regardless of the compatibility level set in the preferences. This limitation will be lifted in the next fix pack for Message Brokers Toolkit Version 5.1.
6. Defect 36605
   The description of the property Namespace in topics "Wildcard attribute logical properties" (ad11870_) and "Wildcard element logical properties" (ad11890_) is incorrect. In the current implementation, there is no enumerated list of options and the field is initially blank. You can specify a namespace in this field; this causes a Task List warning to be displayed which explains that the broker will not use this information and will allow an element from any namespace to be used as the wildcard.
7. Defect 36638
   The Message Set Editor Preferences topic (ad15810_) describes only the options available in the Version 5.0 toolkit. The Version 5.0 options are not available for Version 5.1. In the Version 5.1 toolkit, the options are:
   • Message set editor settings, Outline view settings. These options are displayed but are not operational:
     • Group by namespace and then by collections
     • Group by collections and then by namespace
   • Message definition editor settings:
     • Show base complex types
       If you have defined one or more complex types based on other complex types, select this option if you want the content of those base complex types to be displayed in the message definition editor overview and outline views (this is selected by default).
       If you do not want them displayed, clear the check box.
8. TDS properties
   The grouping and order of TDS properties of global attribute, global element, local attribute, and local element shown in the workbench differ from the grouping and order shown in the topics that describe them. Their meaning and use is unchanged.
9. Defect 36655
   If you uninstall the toolkit by invoking uninstaller.exe with the -silent option, the uninstall program returns control immediately and runs as a background task. If you do not want the uninstall program to return until it has completed, you must invoke the uninstaller within java using this command:
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   where <install_dir> is the directory in which you installed the product.
   If you do not have a jvm configured (Version 1.3.1 or above), you can use the jvm within the installed product in directory <install_dir>\_sjvm\bin\. If you do this, you might have to delete this directory manually when uninstallation is complete.