WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Sistemas operativos: AIX, HP-UX, Linux, Solaris, Windows

Instalación de un archivo EAR de módulo de mediación con la consola

Instalar un módulo de mediación consiste en mover el archivo EAR instalable para el módulo de mediación al servidor o clúster que alojará el módulo de mediación. Se considera que un módulo de mediación instalado que se inicia y ejecuta correctamente es un módulo desplegado.

Antes de empezar

Si ha exportado su módulo de mediación a un archivo JAR, utilice el mandato serviceDeploy para crear un archivo EAR instalable a partir del archivo JAR del módulo de mediación. Para obtener información sobre cómo crear un archivo EAR instalable para un módulo de mediación, consulte Despliegue de un módulo de mediación.

Por qué y cuándo se efectúa esta tarea

Para habilitar WebSphere ESB de modo que utilice las funciones proporcionadas por un módulo de mediación para integrar aplicaciones y servicios, debe instalar el archivo EAR del módulo en un servidor o clúster y luego iniciar el módulo desplegado.

En este tema se describe cómo utilizar la consola administrativa para instalar un archivo EAR de módulo de mediación. Si lo desea, también puede utilizar otros métodos, como el mandato install o installinteractive con la herramienta wsadmin, del mismo modo que instala archivos de aplicación de empresa en WebSphere Application Server.

Importante: una vez que haya empezado a ejecutar los pasos siguientes, pulse Cancelar para salir si decide no instalar la aplicación. No pase a otra página de la consola administrativa sin primero pulsar Cancelar en una página de instalación de la aplicación.

Para utilizar la consola administrativa para instalar un archivo EAR de módulo de mediación, siga estos pasos:

Pasos para realizar esta tarea

  1. Pulse Aplicaciones > Instalar una nueva aplicación en el árbol de navegación de la consola. Se muestra la primera de las dos páginas de Preparación para la instalación de la aplicación.
  2. En la primera página de Preparación para la instalación de la aplicación, siga los pasos secundarios que se indican a continuación:
    1. Especifique el nombre completo de la vía de acceso del archivo EAR del módulo de mediación (archivo .ear). El archivo EAR que instale puede encontrarse en la máquina cliente (la máquina que ejecuta el navegador web de la consola administrativa) o en la máquina servidor (la máquina a la que está conectado el cliente). Si especifica un archivo EAR de la máquina cliente, la consola administrativa carga el archivo EAR en la máquina en la que se ejecuta la consola y procede con la instalación de la aplicación.
    2. Pulse Siguiente.
  3. En la segunda página Preparación para la instalación de la aplicación, siga los pasos secundarios que se indican a continuación:
    1. Indique si desea generar enlaces predeterminados.

      El uso de enlaces predeterminados da lugar a que los enlaces incompletos de la aplicación se cumplimenten con valores predeterminados. Los enlaces existentes no se modifican.

      Los valores predeterminados utilizados al generar enlaces predeterminados pueden personalizarse.

    2. Pulse Siguiente. Si aparecen avisos de seguridad, pulse Continuar. Se muestran las páginas Instalar una nueva aplicación. Si opta por generar enlaces predeterminados y la aplicación no utiliza ningún adaptador de recursos, puede proceder hasta el paso de resumen (el último de los pasos que se indican a continuación).
  4. En el panel Paso: Seleccionar las opciones de instalación, especifique los valores para los valores siguientes. Para obtener más información sobre los valores de esta página, consulte el apartado sobre la selección de valores de las opciones de instalación. Si no especifica ningún valor, se utilizan los valores predeterminados.
    1. Para Directorio de instalación de la aplicación, especifique el directorio en el que se instalará el archivo EAR de la aplicación. El valor predeterminado es el valor de RAÍZ_INSTAL_APLIC/nombre_celda, siendo la variable RAÍZ_INSTAL_APLIC raíz_instalación/installedApps. Por ejemplo, para el producto WebSphere ESB instalado en Windows en el directorio C:\Archivos de programa\WESB\, la ubicación predeterminada es C:\Archivos de programa\WESB\nombre_perfil\installedApps\nombre_celda.
      Nota: si no se especifica ningún directorio al instalar la aplicación en un perfil autónomo, la aplicación se instala en RAÍZ_INSTAL_APLIC/nombre_celda_base. Si añade el servidor autónomo a una celda de gestor de despliegue, el nombre de la celda de la configuración del servidor nuevo pasa a ser el nombre de la celda del nodo del gestor de despliegue. Si utiliza la opción -includeapps para el programa de utilidad addNode, las aplicaciones que se hayan instalado antes de ejecutar la operación addNode seguirán utilizando el directorio de instalación RAÍZ_INSTAL_APLIC/nombre_celda_base. No obstante, una aplicación que se instale tras añadir el servidor autónomo a la configuración de la red utiliza el directorio de instalación predeterminado RAÍZ_INSTAL_APLIC/nombre_celda_red. Para mover la aplicación a la ubicación RAÍZ_INSTAL_APLIC/nombre_celda_red tras ejecutar la operación addNode, debe especificar explícitamente el directorio de instalación como ${RAÍZ_INSTAL_APLIC}/${CELL} durante la instalación. En este caso, los archivos de la aplicación siempre pueden encontrarse en el directorio RAÍZ_INSTAL_APLIC/nombre_celda_actual.
    2. Para Distribuir la aplicación, especifique si WebSphere ESB expande o suprime los archivos binarios de la aplicación en el destino de la instalación. De forma predeterminada, se permite la distribución de la aplicación. Como consecuencia de ello, al guardar los cambios en la consola, los archivos binarios de la aplicación para las aplicaciones recientemente instaladas se expanden en el directorio especificado. Los archivos binarios también se suprimen al desinstalar y guardar los cambios realizados en la configuración. Si inhabilita esta opción, debe garantizar que los archivos binarios de la aplicación se expandan de forma adecuada en los directorios de destino de todos los nodos en los que se prevé ejecutar la aplicación.
      Importante: si inhabilita esta opción y no copia y expande los archivos binarios de la aplicación en los nodos, al ejecutar una operación para guardar la configuración o realizar una sincronización manual los archivos binarios de la aplicación no se moverán automáticamente.
    3. Para Utilizar configuración binaria, especifique si el servidor o el clúster utiliza los descriptores de enlace, extensiones y despliegue que se encuentran en el documento de despliegue de la aplicación, archivo deployment.xml (opción predeterminada), o los que se encuentran en el archivo EAR.
    4. En Nombre de aplicación, especifique un nombre para la aplicación. Los nombres de aplicación deben ser exclusivos dentro de una celda y no pueden contener caracteres no admitidos para los nombres de objeto. Si desea obtener una lista de los caracteres que no pueden utilizarse en los nombres de objeto, consulte Nombres de objeto.
    5. En Crear MBeans para los recursos, especifique si deben crearse MBeans para distintos recursos (como servlets o archivos JSP) en una aplicación al iniciar la aplicación. De forma predeterminada se crean instancias de MBean.
    6. En Habilitar recarga de clases, especifique si debe habilitarse la recarga de clases al actualizar los archivos de aplicación. De forma predeterminada, la recarga de clases no está habilitada. Si se habilita la recarga de clases, el valor de reloadEnabled se establece en true en el archivo deployment.xml del módulo de mediación. Si una definición de clase del módulo de mediación cambia, el entorno de ejecución del servidor detiene e inicia la aplicación para cargar de nuevo las clases de aplicación.
    7. En Intervalo de recarga en segundos, especifique el número de segundos para explorar el sistema de archivos de la aplicación para detectar los archivos que se hayan actualizado. El valor predeterminado es el valor del atributo del intervalo de recarga del archivo de extensiones de IBM (META-INF/ibm-application-ext.xmi) del archivo EAR. Para habilitar la recarga, especifique un valor mayor que cero (por ejemplo, de 1 a 2147483647). Para inhabilitar la recarga, especifique cero (0).

      El intervalo de recarga especificado aquí sólo es efectivo si se ha habilitado la recarga de clases.

    8. En Desplegar servicios web, especifique si la herramienta de despliegue de servicios web wsdeploy se ejecuta durante la instalación de la aplicación. La herramienta genera el código necesario para ejecutar aplicaciones utilizando servicios web. De forma predeterminada, la herramienta wsdeploy no se ejecuta. Este valor debe habilitarse si el archivo EAR contiene módulos que utilizan servicios web y anteriormente no se ha ejecutado la herramienta wsdeploy en dicho archivo, ya sea desde la opción de menú Desplegar de una herramienta de ensamblaje o desde la línea de mandatos.
    9. En Validar entrada desactivada/aviso/error, especifique si WebSphere ESB examina las referencias de la aplicación especificadas durante la instalación o actualización de la aplicación; si se ha habilitado la validación, le advierte si hay referencias incorrectas o genera un error en la operación. Generalmente, una aplicación hace referencia a recursos utilizando orígenes de datos para los beans CMP (Container Managed Persistence) o utilizando referencias de recursos o de entornos de recursos definidas en los descriptores de despliegue. En la validación se comprueba si el recurso al que hace referencia la aplicación está definido en el ámbito del destino de despliegue de dicha aplicación. Seleccione desactivada si no desea realizar la validación de recursos, aviso si desea recibir mensajes de aviso sobre las referencias a recursos incorrectas, o error para detener las operaciones que dan error como consecuencia de referencias a recursos incorrectas.
    10. En Procesar configuración incorporada, especifique si debe procesarse la configuración incorporada. Una configuración incorporada está formada por archivos tales como resource.xml y variables.xml. Si se selecciona o si su valor es true, la configuración incorporada se carga en el ámbito de la aplicación desde el archivo .ear. Si el archivo .ear no contiene ninguna configuración incorporada, el valor predeterminado es false. Si el archivo .ear contiene una configuración incorporada, el valor predeterminado es true.
  5. En el panel Paso: Correlacionar módulos con servidores, seleccione un servidor o clúster de destino de la lista Clústeres y servidores para cada uno de los módulos. Active el recuadro de selección que se encuentra junto a Módulo para seleccionar el módulo de mediación.

    Si la aplicación utiliza un adaptador WebSphere, especifique los servidores o clústeres de destino para cada archivo RAR. Correlacione también todos los demás módulos que utilizan los adaptadores de recursos definidos en los módulos RAR con los mismos destinos.

    Nota: Al instalar un archivo RAR en un servidor, WebSphere ESB busca el manifiesto (MANIFEST.MF) para el módulo de conector. Primero busca en el archivo connectorModule.jar para determinar si existe un archivo RAR y carga el manifiesto del archivo _connectorModule.jar. Si la entrada de la vía de acceso a clases se encuentra en el manifiesto del archivo connectorModule.jar, el archivo RAR utiliza dicha vía de acceso a clases. Para garantizar que el módulo de conector instalado encuentre las clases y los recursos que necesita, compruebe el valor de la vía de acceso a clases para el archivo RAR utilizando la consola. Si desea obtener más información sobre el valor de la vía de acceso a clases, consulte los valores del adaptador de recursos y los valores del adaptador de recursos relacionales de WebSphere para la consola administrativa.

    Es posible especificar servidores web como destinos que dirijan las solicitudes a la aplicación. El archivo de configuración de conectores plugin-cfg.xml para cada servidor web se genera en función de las aplicaciones que se redirigen a través del mismo. Si desea que un servidor web preste servicio a la aplicación, utilice la tecla Ctrl para seleccionar conjuntamente un servidor o clúster de aplicaciones y el servidor web de modo que el archivo de configuración de conector plugin-cfg.xml para dicho servidor web se genere en función de las aplicaciones que se redirigen a través del mismo.

  6. Si la aplicación define referencias a recursos, en Paso: Correlacionar referencias de recursos con los recursos, especifique nombres JNDI para los recursos que representan los nombres lógicos definidos en las referencias a recursos. Cada referencia de recurso definida en la aplicación debe estar vinculada a un recurso definido en la configuración de WebSphere ESB antes de pulsar Finalizar en el panel de resumen.
    1. Opcional: Especifique el nombre de configuración de inicio de sesión y las propiedades de autenticación para el recurso.
    2. Pulse Aceptar para guardar los valores y regresar al paso de correlación.
  7. Si la aplicación utiliza módulos Web, en Paso: Correlacionar sistemas principales virtuales para módulos Web, seleccione un sistema principal virtual de la lista que deba correlacionarse con un módulo web definido en la aplicación.

    El número de puerto especificado en la definición del sistema principal virtual se utiliza en el URL que se utiliza para acceder a artefactos tales como servlets y archivos JSP del módulo Web. Cada módulo web debe tener un sistema principal virtual al que correlacionarse. Si no se especifican todos los sistemas principales virtuales necesarios, se mostrará un error de validación tras pulsar Finalizar en el panel de resumen.

  8. Si la aplicación tiene roles de seguridad definidos en su descriptor de despliegue, en Paso: Correlacionar roles de seguridad con usuarios y grupos, especifique los usuarios y grupos que están correlacionados a cada uno de los roles de seguridad.

    Seleccione Rol para seleccionar todos los roles o seleccione roles individuales. Para cada rol, debe seleccionar una de las opciones siguientes a fin de indicar cómo debe aplicarse la seguridad:

    Opción Descripción
    Todos Equivale a no tener seguridad.
    Todos autenticados Todos los usuarios que se autentiquen con un nombre de usuario y una contraseña válidos son miembros del rol.
    Usuarios correlacionados Los usuarios individuales se indican como miembros del rol.
    Grupos correlacionados Los grupos constituyen el mejor método para agregar usuarios; todos los miembros de los grupos identificados pasan a ser miembros del rol.

    En Usuarios correlacionados o Grupos correlacionados, para seleccionar usuarios o grupos específicos del registro de usuarios, siga estos pasos secundarios:

    1. Seleccione un rol y pulse Buscar usuarios o Buscar grupos.
    2. En el panel Buscar usuarios y grupos que se muestra, especifique los criterios de búsqueda para extraer una lista de los usuarios o grupos del registro de usuarios.
    3. Seleccione usuarios individuales o grupos en los resultados que se muestran.
    4. Pulse Aceptar para correlacionar los usuarios o grupos seleccionados con el rol seleccionado en el panel Paso: Correlacionar roles de seguridad con usuarios y grupos.
  9. Si la aplicación tiene roles de tipo Ejecutar como (RunAs) definidos en el descriptor de despliegue, en Paso: Correlacionar roles RunAs como usuarios, especifique el nombre de usuario RunAs y la contraseña para cada rol RunAs. Los enterprise beans utilizan los roles RunAs cuando deben ejecutarse como un rol determinado al interactuar con otro enterprise bean. Seleccione Rol para seleccionar todos los roles o seleccione roles individuales. Una vez que haya seleccionado el rol, especifique un valor para el campo de nombre de usuario, contraseña y verificación de la contraseña y pulse Aplicar.
  10. Si la aplicación contiene referencias a un entorno de recursos, en Paso: Correlacionar referencias de entradas de entorno de recursos con los recursos, especifique los nombres JNDI de los recursos que se correlacionan con los nombres lógicos definidos en las referencias al entorno de recursos. Si hay alguna referencia al entorno de recursos que no tenga ningún recurso asociado, tras pulsar Finalizar se muestra un error de validación.
  11. Si la aplicación define Identidad RunAs como Identidad del sistema, en Paso: Sustituir sistema RunAs por roles RunAs, si lo desea puede cambiarlo por Rol RunAs y especificar un nombre de usuario y una contraseña para el rol RunAs especificado. Seleccionar Identidad del sistema implica que la invocación se realiza utilizando el ID de servidor de seguridad WebSphere Application Server; esta opción debe utilizarse con precaución, ya que este ID tiene más privilegios.
  12. Si la aplicación tiene referencias a recursos que se correlacionan con recursos que tienen una base de datos Oracle que realiza el proceso de fondo, en Paso: Especifique el nivel de aislamiento para los proveedores de tipo Oracle., especifique o corrija el nivel de aislamiento que debe utilizarse para dichos recursos cuando la aplicación los utiliza. Las bases de datos Oracle dan soporte únicamente a los niveles de aislamiento ReadCommitted y Serializable.
  13. En el panel de resumen, verifique la celda, el nodo y el servidor en los que se instalarán los módulos de aplicación:
    1. Junto a Célula/Nodo/Servidor, pulse Pulse aquí.
    2. Verifique los valores.
    3. Pulse Finalizar.

Resultado

Se muestran varios mensajes en los que se indica si el archivo de la aplicación se ha instalado correctamente.

Si recibe una excepción OutOfMemory y el archivo de la aplicación de origen no se instala, es posible que el sistema no tenga memoria suficiente o que la aplicación tenga demasiados módulos para poder instalarse correctamente en el servidor. Si la causa de la excepción no reside en la falta de memoria del sistema, empaquete de nuevo la aplicación de modo que el archivo .ear tenga menos módulos. Si la causa de la excepción no reside en la falta de memoria del sistema ni en el número de módulos, compruebe las opciones especificadas en la página JVM (máquina virtual Java) del servidor de aplicaciones que ejecuta la consola administrativa. A continuación, intente instalar de nuevo el archivo de la aplicación.

Para plataformas Windows Durante la instalación se extraen determinados archivos de aplicación del directorio representado por la sesión de configuración y, al guardar la configuración, dichos archivos se guardan en el repositorio de configuración de WebSphere Application Server. En las máquinas Windows, existe un límite de 256 caracteres para las vías de acceso a archivos. Por consiguiente, es posible que la aplicación no pueda instalarse si la vía de acceso de los archivos de la aplicación en la sesión de configuración o en el repositorio de configuración excede dicho límite. Es posible que vea excepciones de tipo FileNotFound que indican informaciones del tipo nombre de vía de acceso demasiado larga en el mensaje. A fin de evitar problemas de este tipo, defina nombres de URI cortos para la aplicación y los módulos, lo que le ayudará a reducir la longitud de la vía de acceso de los archivos. A continuación, intente instalar de nuevo el archivo de la aplicación.

Qué hacer a continuación

Una vez que haya instalado correctamente el archivo de la aplicación, complete las acciones que se indican a continuación:
  1. Asocie las bibliotecas compartidas necesarias para la aplicación a la aplicación.
  2. Guarde los cambios realizados en la configuración. La aplicación se registra con la configuración administrativa y los archivos de aplicación se copian en el directorio de destino, que es el directorio predeterminado raíz_instalación/installedApps/nombre_celda o el directorio que se designe. Si la instalación se realiza en un perfil de despliegue en red, los archivos se copian en nodos remotos cuando la configuración del gestor de despliegue se sincroniza con la configuración de los nodos individuales.
  3. Si el módulo se despliega en un clúster de servidor, pulse Desplegar actualización en la página Aplicaciones de empresa para propagar la configuración cambiada en todos los miembros del clúster. La función Desplegar actualización actualiza secuencialmente la configuración en los nodos que contienen miembros de clúster.

Para permitir que WebSphere ESB utilice funciones proporcionadas por un módulo de mediación para integrar aplicaciones y servicios, el módulo desplegado debe estar iniciado. El módulo puede iniciarse manualmente o se puede configurar para que el inicio sea automático. También puede administrar el módulo de otros modos; por ejemplo, para cambiar la configuración del módulo, detener o actualizar el módulo, y también gestionar la actividad del mismo.


Task topic

Condiciones de uso | Evalúe esta página

Icono de fecha y horaÚltima actualización: 1 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\ae\trun_app_instwiz.html

(C) Copyright IBM Corporation 2005. Reservados todos los derechos.
Este centro de información está basado en tecnología Eclipse. (http://www.eclipse.org)