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

La instalación de un módulo de mediación consiste en mover el archivo EAR instalable, para el módulo de mediación, a un servidor o clúster que alojará el módulo de mediación. Los módulos de mediación instalados que se inician y se ejecutan correctamente se consideran desplegados.

Antes de empezar

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

Por qué y cuándo realizar esta tarea

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

Este tema describe cómo utilizar la consola administrativa para instalar un archivo EAR de módulo de mediación. Como alternativa, también puede utilizar otros métodos, como el mandato install o installinteractive con la herramienta wsadmin, de la misma manera que al instalar archivos de aplicación de empresa en WebSphere Application Server.

Importante: Después de empezar a realizar los pasos siguientes, si decide no instalar la aplicación, pulse Cancelar para salir. No se limite a ir a otra página de la consola administrativa sin pulsar antes Cancelar en una página de instalación de aplicación.

Para utilizar una 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 nueva aplicación en el árbol de navegación de la consola. Se muestra la primera de 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 estos subpasos:
    1. Especifique el nombre de vía de acceso completo del archivo EAR de módulo de mediación (archivo .ear). El archivo EAR que va a instalar puede estar 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 el cliente está conectado). Si especifica un archivo EAR en la máquina cliente, la consola administrativa carga el archivo EAR en la máquina en que está ejecutándose la consola y continúa con la instalación de la aplicación.
    2. Pulse Siguiente.
  3. En la segunda página de Preparación para la instalación de la aplicación, siga estos subpasos:
    1. Seleccione si va a generar enlaces por omisión.

      El uso de los enlaces por omisión hace que los enlaces incompletos de la aplicación se llenen con valores por omisión. No se alteran los enlaces existentes.

      Puede personalizar los valores por omisión utilizados al generar enlaces por omisión.

    2. Pulse Siguiente. Si se muestran avisos de seguridad, pulse Continuar. Se muestran las páginas Instalar una nueva aplicación. Si ha elegido generar enlaces por omisión y la aplicación no utiliza un adaptador de recursos, puede continuar en el paso de Resumen (último paso que encontrará más abajo).
  4. En el panel Paso: Seleccionar opciones de instalación, proporcione los valores siguientes. Para obtener más información sobre los valores de esta página, consulte Seleccionar valores de opciones de instalación. Se utilizarán valores por omisión si no especifica ningún valor.
    1. Para Directorio de instalación de la aplicación, especifique el directorio en que se instalará el archivo EAR de aplicación. El valor por omisión es el valor de APP_INSTALL_ROOT/nombre_célula, donde la variable APP_INSTALL_ROOT es raíz_instalación/installedApps. Por ejemplo, para WebSphere ESB que está instalado en Windows en C:\Archivos de programa\WESB\, la ubicación por omisión es C:\Archivos de programa\WESB\nombre_perfil\installedApps\nombre_célula.
      Nota: Si no se especifica un directorio de instalación cuando se instala una aplicación en un perfil autónomo, la aplicación se instala en APP_INSTALL_ROOT/nombre_célula_base. Si añade el servidor autónomo a una célula del gestor de despliegue, el nombre de célula de la nueva configuración de servidor se convierte en el nombre de célula del nodo del gestor de despliegue. Si se utiliza la opción -includeapps para el programa de utilidad addNode, las aplicaciones que se instalan antes que la operación addNode todavía utilizarán el directorio de instalación APP_INSTALL_ROOT/nombre_célula_base. Sin embargo, una aplicación que se instale después de añadir el servidor autónomo a la configuración de red, utiliza el directorio de instalación por omisión APP_INSTALL_ROOT/nombre_célula_red. Para mover la aplicación a la ubicación APP_INSTALL_ROOT/nombre_célula_red al ejecutar la operación addNode, debe especificar de manera explícita el directorio de instalación como ${APP_INSTALL_ROOT}/${CELL} durante la instalación. En tal caso, los archivos de aplicación pueden encontrarse siempre bajo APP_INSTALL_ROOT/nombre_célula_actual.
    2. Para Distribuir aplicación, especifique si WebSphere ESB expande o suprime los binarios de aplicación en el directorio de instalación. El valor por omisión es habilitar la distribución de la aplicación. Como resultado, cuando guarde cambios en la consola, los binarios de aplicación para las aplicaciones recién instaladas se expandirán al directorio especificado. Los binarios también se suprimen cuando se desinstala y se guardan los cambios en la configuración. Si inhabilita esta opción, debe asegurarse de que los binarios de aplicación se expanden de la manera correcta en los directorios de destino de todos los nodos donde se espera que se ejecute la aplicación.
      Importante: Si inhabilita esta opción y no copia y expande los binarios de aplicación a los nodos, una operación posterior de guardar la configuración o la sincronización manual no mueve automáticamente los binarios de aplicación a los nodos.
    3. Para Utilizar configuración binaria, especifique si el servidor o el clúster utiliza los enlaces, extensiones y descriptores de despliegue situados con el documento de despliegue de aplicación, el archivo deployment.xml (valor por omisión) o los ubicados en el archivo EAR.
    4. Para Nombre de aplicación, escriba un nombre para la aplicación. Los nombres de aplicación deben ser exclusivos en una célula y no pueden contener caracteres que no estén permitidos en los nombres de objeto. Para ver una lista de caracteres que no están permitidos en los nombres de objeto, consulte Nombres de objeto
    5. Para Crear MBeans para recursos, especifique si se deben crear MBeans para diversos recursos (como, por ejemplo, servlets o archivos JSP) en una aplicación cuando ésta se inicie. El valor por omisión es crear instancias de MBean.
    6. Para Habilitar recarga de clases, especifique si debe habilitar la recarga de clases cuando se actualicen los archivos de aplicación. El valor por omisión es no habilitar la recarga de clases. Al habilitar la recarga de clases se establece reloadEnabled en true en el archivo deployment.xml para el módulo de mediación. Si la definición de clase de un módulo de mediación cambia, el tiempo de ejecución del servidor se detiene e inicia la aplicación para recargar las clases de aplicación.
    7. Para Intervalo de recarga en segundos, especifique el número de segundos para explorar el sistema de archivos de la aplicación en busca de archivos actualizados. El valor por omisión es el valor del atributo de intervalo de recarga en el archivo de extensión 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 entra en vigor si se ha habilitado la recarga de clases.

    8. Para 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 los servicios Web. El valor por omisión es no ejecutar la herramienta wsdeploy. Debe habilitar este valor si el archivo EAR contiene módulos que utilizan servicios Web y no se ha ejecutado previamente la herramienta wsdeploy en el mismo, sea desde la opción de menú Desplegar de una herramienta de ensamblaje o desde una línea de mandatos.
    9. Para Validar entrada desactivada/aviso/error especifique si WebSphere ESB examina las referencias de aplicación especificadas durante la instalación o actualización de la aplicación y, si se ha habilitado la validación, le avisará de las referencias incorrectas que existan o la operación dará error. Una aplicación suele hacer referencia a recursos que utilizan orígenes de datos para beans de persistencia gestionada por contenedor (CMP) o que utilizan referencias de recurso o referencias de entorno de recursos definidas en los descriptores de despliegue. La validación comprueba si el recurso al que hace referencia la aplicación está definido en el ámbito del destino de despliegue de esa aplicación. Seleccione desactivada si no hay validación de recursos, aviso para avisos de mensajes sobre referencias de recursos incorrectas, o error para detener las operaciones que fallen como resultado de referencias de recursos incorrectas.
    10. Para Procesar configuración incorporada, especifique si debe procesarse la configuración incorporada. Una configuración incorporada consta de archivos tales como resource.xml y variables.xml. Cuando se selecciona o el valor es true, la configuración incorporada se carga en el ámbito de aplicación del archivo .ear. Si el archivo .ear no contiene una configuración incorporada, el por omisión es false. Si el archivo .ear contiene una configuración incorporada, el valor por omisión es true.
  5. En el panel Paso: Correlacionar módulos con servidores, seleccione para cada módulo un servidor o clúster de destino de la lista Clústeres y servidores. Seleccione el recuadro de selección junto a Módulo para seleccionar el módulo de mediación.

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

    Nota: Cuando se instala un archivo RAR en un servidor, WebSphere ESB busca el archivo de manifiesto (MANIFEST.MF) para el módulo de conector. Busca primero en el archivo connectorModule.jar del archivo RAR y carga el archivo de manifiesto del archivo _connectorModule.jar. Si la entrada de la variable classpath se encuentra en el archivo de manifiesto del archivo connectorModule.jar y, a continuación, el archivo RAR utiliza esa variable classpath. Para asegurarse de que el módulo de conector instalado encuentre las clases y recursos que necesita, seleccione el valor de Class path para el archivo RAR utilizando la consola. Para obtener más información sobre el valor Class path, consulte Valores de adaptador de recursos y Valores de adaptador de recursos relacionales de WebSphere para la consola administrativa.

    Puede especificar servidores Web como destino que direccionan peticiones a la aplicación. El archivo de configuración de plug-in plugin-cfg.xml para cada servidor Web se genera en función de las aplicaciones que se direccionan a través del mismo. Si desea que un servidor Web sirva a la aplicación, utilice la tecla Control para seleccionar juntos un servidor de aplicación o clúster y el servidor Web para tener el archivo de configuración de plug-in plugin-cfg.xml para ese servidor Web generado en función de las aplicaciones que se direccionan a través del mismo.

  6. Si la aplicación define referencias de recursos, para Paso: Correlacionar referencias de recurso con recursos, especifique nombres JNDI para los recursos que representan los nombres lógicos definidos en las referencias de recurso. Cada referencia de recurso definida en la aplicación debe enlazarse a un recurso definido en la configuración de WebSphere ESB antes de pulsar en Finalizar en el panel Resumen.
    1. Opcional: Especifique el nombre de configuración de inicio de sesión y las propiedades de autenticación del recurso.
    2. Pulse Aceptar para guardar los valores y volver al paso de correlación.
  7. Si la aplicación utiliza módulos Web, para 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 de sistema principal virtual se utiliza en el URL que se usa para acceder a artefactos tales como, por ejemplo, servlets y archivos JSP en el módulo Web. Cada módulo Web debe tener un sistema principal virtual con el que se correlaciona. No especificar todos los sistemas principales virtuales necesarios producirá un error de validación que se mostrará después de que pulse Finalizar en el panel Resumen.

  8. Si la aplicación tiene roles de seguridad definidos en su descriptor de despliegue, para Paso: Correlacionar roles de seguridad con usuarios/grupos, especifique usuarios y grupos que se correlacionen con cada uno de los roles de seguridad.

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

    Opción Descripción
    Todos Equivale a que no haya seguridad.
    Todos los autenticados Cualquier usuario que se autentique con un nombre de usuario y contraseña válidos es miembro del rol.
    Usuarios correlacionados Los usuarios individuales se listan como miembros del rol.
    Grupos correlacionados Los grupos son la manera más conveniente de añadir los usuarios y todos los miembros de los grupos identificados se convierten en miembros del rol.

    Para Usuarios correlacionados o Grupos correlacionados, para seleccionar usuarios o grupos específicos del registro de usuarios, siga estos subpasos:

    1. Seleccione un rol y pulse Buscar usuarios o Buscar grupos.
    2. En el panel Buscar usuarios/grupos que se visualiza, especifique los criterios de búsqueda para extraer una lista de usuarios o grupos del registro de usuarios.
    3. Seleccione usuarios o grupos individuales a partir de los resultados visualizados.
    4. Pulse Aceptar para correlacionar los usuarios o grupos seleccionados con el rol seleccionado en el panel Paso: Correlacionar roles de seguridad con usuarios/grupos.
  9. Si la aplicación tiene roles de Ejecutar como definidos en su descriptor de despliegue, para Paso: Correlacionar roles RunAs con usuario, especifique el nombre de usuario y la contraseña de Run As para cada rol Run As. Los roles Run As los utilizan los enterprise beans que deben ejecutarse como un rol concreto mientras interactúan con otro enterprise bean. Seleccione Rol para seleccionar todos los roles o bien seleccionar roles individuales. Después de seleccionar un rol, especifique valores para los campos de nombre de usuario, contraseña y verificar contraseña y pulse Aplicar.
  10. Si la aplicación define referencias de recursos, para Paso: Correlacionar referencias de entorno de recurso con recursos, especifique nombres JNDI de los recursos que se correlacionan con los nombres lógicos definidos en las referencias de entorno de recurso. Si cada referencia de entorno de recurso no tiene un recurso asociado al mismo, después de pulsar Finalizar se visualizará un error de validación.
  11. Si la aplicación define Identidad Run-As como Identidad del sistema, para Paso: Sustituir sistema RunAs por roles RunAs, tiene la opción de cambiarlo por Rol Run-As y especificar un nombre de usuario y contraseña para el rol Run As especificado. La selección de Identidad del sistema implica que la invocación se realice utilizando el ID de servidor de seguridad de WebSphere Application Server y debe utilizarse con precaución, ya que este ID tiene más privilegios.
  12. Si la aplicación tiene referencias de recurso que se correlacionan con recursos que tengan una base de datos Oracle que ejecuta un proceso de programa de fondo, para Paso: Especificar el nivel de aislamiento para proveedor de tipo Oracle, especifique o corrija el nivel de aislamiento que debe utilizarse para tales recursos cuando los utilice la aplicación. Las bases de datos Oracle sólo dan soporte a los niveles de aislamiento ReadCommitted y Serializable.
  13. En el panel Resumen, verifique la célula, 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 en Pulse aquí.
    2. Verifique los valores.
    3. Pulse Finalizar.

Resultado

Se visualizan varios mensajes, lo que indica si el archivo de aplicación se instala satisfactoriamente o no.

Si recibe una excepción OutOfMemory y el archivo de 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 en ella para instalarse satisfactoriamente en el servidor. Si la falta de memoria del sistema no es la causa de la excepción, vuelva a empaquetar la aplicación de manera que el archivo .ear tenga menos módulos. Si la falta de memoria del sistema y el número de módulos no son las causas de la excepción, compruebe las opciones que ha especificado en la página Java Virtual Machine del servidor de aplicaciones que ejecuta la consola administrativa. A continuación, intente instalar de nuevo el archivo de aplicación.

Icono que indica plataformas Windows Durante la instalación, ciertos archivos de aplicación se extraen en el directorio representado por la sesión de configuración y, cuando se guarda la configuración, estos archivos se guardan en el depósito 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 de archivos. Por consiguiente, la instalación de la aplicación podría fallar si la vía de acceso para los archivos de aplicación en la sesión de configuración o en el depósito de configuración sobrepasa el límite de 256 caracteres. Podría ver excepciones FileNotFound con nombre de vía de acceso demasiado largo en el mensaje. Para superar estos problemas, haga que los nombres de aplicación y los nombres de URI de módulo tengan una longitud más corta, ya que esto ayuda a reducir la longitud de la vía de acceso de archivos. A continuación, intente instalar de nuevo el archivo de aplicación.

Qué hay que hacer a continuación

Una vez que el archivo de aplicación se haya instalado satisfactoriamente, realice las acciones siguientes:
  1. Asocie las bibliotecas compartidas que la aplicación necesita para la aplicación.
  2. Guarde los cambios en la configuración. La aplicación se registra con los archivos de aplicación y configuración administrativa copiados en el directorio de destino, que por omisión es raíz_instalación/installedApps/nombre_célula o el directorio que indique. Cuando se realiza la instalación en un perfil de Network Deployment, los archivos se copian en nodos remotos cuando la configuración que hay en el gestor de despliegue se sincroniza con la configuración en nodos individuales.
  3. Si el módulo se despliega en un clúster de servidores, pulse Desplegar actualización en la página Aplicaciones de empresa para propagar la configuración modificada en todos los miembros del clúster. Desplegar actualización realiza una actualización secuencial de la configuración en los nodos que contienen miembros de clúster.

Para habilitar WebSphere ESB con el fin de utilizar las funciones proporcionadas por un módulo de mediación para integrar aplicaciones y servicios, debe iniciarse el módulo desplegado. Puede iniciar el módulo manualmente o configurarlo para que se inicie de forma automática. También puede administrar el módulo de otras maneras; por ejemplo, para cambiar la configuración del módulo, para detener o actualizar el módulo y gestionar su actividad de otras maneras.


Condiciones de uso |


(c) Copyright IBM Corporation 2005, 2006.
Este centro de información está basado en tecnología Eclipse (http://www.eclipse.org)