Utilice las instrucciones de esta guía de aprendizaje para verificar la instalación de WebSphere Message Broker y aprender cómo ejecutar los ejemplos con WebSphere Message Broker Toolkit.
Debe tener instalado WebSphere Message Broker Toolkit para poder ejecutar esta guía de aprendizaje.
Para verificar la instalación mediante
WebSphere Message Broker Toolkit complete las tareas siguientes:
- Crear una configuración predeterminada.
- Ejecutar los ejemplos de Buscapersonas.
- (Opcional) Iniciar el asistente de Preparación de ejemplos.
- Eliminar los ejemplos.
Para poder ejecutar programas de ejemplo, debe utilizar el Asistente de configuración predeterminada para crear un intermediario, que tiene un nombre fijo y las propiedades de las que dependen los ejemplos.
El Asistente de configuración predeterminada requiere que se cumplan las condiciones siguientes:
No
puede realizar el proceso de configuración y verificación aquí descrito si
no se cumplen las condiciones descritas anteriormente.
Utilice las
instrucciones siguientes para completar estas tareas:
- Inicie las WebSphere Message Broker Toolkit:
- En Windows:
En Windows, no puede completar la verificación a menos que disponga de autorización de administrador; lleve a cabo la verificación con el mismo ID de usuario que ha utilizado para completar la instalación.
Si
no ha iniciado WebSphere Message Broker Toolkit desde el asistente de
instalación, inícielo desde el menú Inicio, o
ejecute el archivo de script que se proporciona. En una línea de mandatos, vaya al directorio raíz del grupo
de paquetes y entre el siguiente mandato:
launcher.bat
El
archivo de script ejecuta el siguiente mandato; si lo prefiere, puede
utilizar usted mismo este mandato:
eclipse.exe -product com.ibm.etools.msgbroker.tooling.ide
- En Linux:
En
Linux en x86 y
Linux en
x86-64, no necesita
autorización root para realizar la verificación. No puede iniciar
WebSphere Message Broker Toolkit desde el asistente de
instalación porque podría experimentar problemas durante la
operación si crease recursos, como por ejemplo intermediarios,
cuando está conectado como root y, por consiguiente, esta opción no está
disponible.
Termine la sesión del ID de usuario con el que ha instalado el producto. Inicie la sesión con el mismo ID (si el ID no es
root), o inicie la sesión con otro ID diferente, pero no se convierta en
root.
Inicie WebSphere Message Broker Toolkit desde el menú principal o ejecute el archivo de script que se
proporciona. En una línea de mandatos, vaya al directorio raíz del grupo
de paquetes y entre el siguiente mandato:
./launcher
Si
lo prefiere, también puede ejecutar la aplicación directamente:
./eclipse -product com.ibm.etools.msgbroker.tooling.ide
Sin embargo, debe establecer LD_LIBRARY_PATH antes de ejecutar la aplicación. Si desea información detallada sobre cómo establecer LD_LIBRARY_PATH, consulte el script del lanzador.
Cuando inicie por primera vez WebSphere Message Broker Toolkit, se le solicitará que especifique
la ubicación del espacio de trabajo. Este directorio existe en la unidad
local y es donde WebSphere Message Broker Toolkit almacena todos los recursos que se crean. Puede aceptar el directorio predeterminado que se muestra, o puede
especificar uno de su elección escribiéndolo o pulsando
Examinar para especificar la ubicación. Seleccione Utilizar como
valor predeterminado y no preguntar de nuevo para impedir la
visualización del diálogo de espacio de trabajo la próxima vez que inicie
WebSphere Message Broker Toolkit.
Se abre WebSphere Message Broker Toolkit y se visualiza la
página de bienvenida.
- Pulse el icono Cómo empezar
para empezar el proceso de configuración y verificación. Se abre la página Iniciación, desde la que podrá
iniciar la Presentación rápida o crear
una configuración predeterminada que utiliza un programa de ejemplo
para verificar que la instalación sea correcta.
- Cree la configuración predeterminada:
- En la página Cómo empezar, pulse el enlace Crear configuración predeterminada.
Se abre la página "Creación de la
configuración predeterminada".
- Pulse Iniciar el Asistente de configuración
predeterminada.
Siga las instrucciones proporcionadas por el asistente para avanzar por las
páginas.
El asistente crea un intermediario predeterminado que un programa de ejemplo puede utilizar para verificar que la instalación sea correcta.
El
asistente muestra una barra de progreso que indica qué tarea se está
llevando a cabo en ese momento. También informa sobre todas las
acciones que realiza escribiendo información de progreso en una ventana de
texto desplazable desde la que puede copiar y pegar toda o parte de la
información mostrada.
La información de la ventana de texto también se graba en un
archivo de registro de la estructura del directorio de espacio de
trabajo. El directorio de espacio de trabajo predeterminado es el que aparece en el
ejemplo, pero puede elegir otra ubicación cuando inicie
WebSphere Message Broker Toolkit.
- Linux en x86 y Linux en
x86-64
-
dir_inicio_usuario/IBM/wmbt80/workspace/.metadata/
DefaultConfigurationWizard.log
- Windows
-
dir_inicio_usuario\IBM\wmbt80\workspace\.metadata\
DefaultConfigurationWizard.log
Si el asistente encuentra un error durante el proceso,
le informa de lo que ha sucedido y devuelve toda la información de error,
por ejemplo un código de retorno de un mandato. Si averigua el motivo por
el cual se produjo el error en el texto de error, y puede corregir la
situación, hágalo ahora. Vuelva a la ventana del mensaje de error y pulse
Sí para continuar con el asistente.
Si no entiende el error, y no sabe cómo solucionarlo, pulse
No. Si es posible, el asistente retrotrae
todas las acciones que ha realizado hasta ese momento, de manera que
cuando termine, el sistema esté en el mismo estado en que estaba antes de iniciar
el asistente. La ventana de texto le indica exactamente
qué es lo que el asistente ha hecho o no ha hecho.
Pulse Abrir el archivo de registro para
acceder a las anotaciones desde la página de resumen del asistente; esta
opción está disponible tanto si el asistente se ha ejecutado correctamente
como si ha fallado.
El asistente crea los recursos que aparecen en la tabla siguiente.
Tabla 1. Recursos creados por el asistente de Configuración por omisiónNombre |
Tipo |
MB8BROKER |
Intermediario |
MB8QMGR |
Gestor de colas de WebSphere MQ que aloja el intermediario. El gestor de colas tiene un escucha en el primer puerto disponible
que sea mayor que o igual a 2414. |
También inicia el intermediario de forma que esté preparado para procesar un ejemplo.
- En la página final, haga caso omiso de la opción para iniciar el
asistente de Preparación de ejemplos; iniciará este asistente más
adelante es estas instrucciones.
- Pulse Finalizar para cerrar el asistente. Cuando el asistente finalice, se abrirá laperspectiva
Desarrollo de aplicaciones de intermediario y se mostrarán los recursos que ha creado el asistente.
- Para verificar la instalación, pulse para que se abra el panel Ejemplos y Guías de aprendizaje. El panel Ejemplos y Guías de aprendizaje también se puede abrir desde la página de bienvenida.
- Expanda Ejemplos de aplicación y pulse Ejemplos de buscapersonas para abrir la página Ejemplos de buscapersonas. Se muestran las siguientes
opciones:
- Importar y desplegar los ejemplos de buscapersonas
Esta opción inicia el asistente de preparación de ejemplos, que le ayuda a importar los ejemplos en el espacio de trabajo y a desplegar los ejemplos y los recursos asociados (por ejemplo, flujos de mensajes) en el intermediario predeterminado.
- Ejecutar los ejemplos de buscapersonas
Esta
opción abre la página de ayuda que contiene una descripción de cada uno de
los tres programas de ejemplo, e iconos que puede pulsar para iniciar cada
uno de ellos.
- Averiguar qué hacen los ejemplos de buscapersonas
Esta opción
abre una página que describe con detalle qué hacen los ejemplos de
Buscapersonas y cómo funcionan. Puede examinar los flujos de mensajes que
implementan la función de ejemplo y los mensajes que esos flujos manejan.
- Pulse Importar y desplegar ejemplos de buscapersonas.
El asistente de Preparación de ejemplos se inicia y muestra su primera página. La opción para importar y
desplegar en el intermediario predeterminado está preseleccionada.
- Pulse Siguiente y siga las instrucciones
proporcionadas por el asistente para avanzar por las páginas.
El
asistente muestra una barra de progreso que indica qué tarea se está
llevando a cabo en ese momento. También informa sobre todas las acciones
que realiza escribiendo información de progreso en una ventana de texto
desplazable.
Puede copiar y pegar toda o parte de la información que
se presenta en esta ventana de texto. Esta información también se graba en el archivo de registro siguiente:
- Linux en x86 y Linux en
x86-64
-
dir_inicio_usuario/IBM/wmbt80/workspace/.metadata/
samplePreparationWizard.log
- Windows
-
directorio_inicial_usuario\eclipse\workspace\.metadata\
samplePreparationWizard.log
Si el asistente encuentra un error durante el proceso,
le informa de lo que ha sucedido y devuelve toda la información de error,
por ejemplo un código de retorno de un mandato. Si averigua el motivo por
el cual se produjo el error en el texto de error, y puede corregir la
situación, hágalo ahora. Vuelva a la ventana del mensaje de error y pulse
Sí para continuar con el asistente.
Si no entiende el error, y no sabe cómo solucionarlo, pulse
No. Si es posible, el asistente retrotrae todas las
acciones que ha realizado hasta ese momento, de manera que cuando termine,
el sistema esté en el mismo estado en que estaba antes de iniciar el
asistente. La ventana de texto le indica exactamente
qué es lo que el asistente ha hecho o no ha hecho.
El asistente
muestra mensajes informativos para comunicar que los ejemplos de
Buscapersonas y los recursos asociados están desplegados y listos para
ejecutarse.
- Pulse Siguiente cuando haya leído los mensajes
sobre las acciones que ha realizado el asistente.
Se visualiza la página de
confirmación.
- Pulse en Finalizar para cerrar el asistente.
La
página "Ejemplos de Buscapersonas" (desde la que ha iniciado el
asistente) se vuelve a visualizar.
- Pulse Ejecutar los ejemplos de Buscapersonas.
En
la página que se abre, pulse Cómo utilizar las
aplicaciones para leer información sobre las aplicaciones Mensajero
de textos y Publicador de informes de surf.
Cuando comprenda lo que hacen las aplicaciones y sepa cómo utilizarlas, pulse el icono que representa la aplicación que desea ejecutar.
Si desea
información más detallada sobre el contenido de estas aplicaciones, y cómo
funcionan los flujos de mensajes, pulse Averiguar qué hacen los ejemplos de Buscapersonas.
- Si ha enviado y recibido mensajes satisfactoriamente, ha
verificado que la instalación está completa. Ahora puede cerrar las
aplicaciones de Buscapersonas y la Galería de ejemplos.
- (Opcional) Puede iniciar el asistente de Preparación de ejemplos para crear los recursos e iniciar otros programas de ejemplo proporcionados.
Pulse en el WebSphere Message Broker Toolkit y seleccione Preparar las muestras. Se abre el asistente de preparación de ejemplos y lista otros ejemplos que están disponibles.
Puede
ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center
en línea. Puede
ejecutar ejemplos sólo cuando utilice el Information Center que está
integrado en WebSphere Message Broker Toolkit.
- Para eliminar el ejemplo o los ejemplos cuando haya terminado de utilizarlos, ejecute de nuevo el asistente de Preparación de ejemplos y elimine los ejemplos que haya añadido. Esta
acción elimina los ejemplos del intermediario y elimina los recursos de
ejemplo del espacio de trabajo.
Cuando haya completado las pruebas de verificación, ejecute el Asistente de configuración predeterminada para eliminar todos los recursos predeterminados. Utilice el mismo espacio de
trabajo y el mismo ID de usuario que utilizó para crear los recursos. Para iniciar el
asistente desde WebSphere Message Broker Toolkit, pulse
y expanda Message Broker - Configuración predeterminada y ejemplos. Seleccione Crear la configuración predeterminada y
pulse Siguiente.
Ha completado la guía de aprendizaje.