[AIX Solaris HP-UX Linux Windows][z/OS]

Instalación de archivos de aplicación de empresa añadiéndolos a un directorio supervisado

Puede instalar un archivo de aplicación de empresa en un servidor de aplicaciones o clúster arrastrando o copiado un archivo empresarial (EAR), un archivo de aplicación web (WAR), un archivo Java™ (JAR) o un archivo SIP (Session Initiation Protocol) en un directorio supervisado. Un archivo de aplicación empresarial debe cumplir la especificación Java EE (Java Platform, Enterprise Edition).

Antes de empezar

Desarrolle y ensamble el archivo EAR, JAR, WAR o SAR. Puede utilizar una herramienta de ensamblaje soportada, como IBM® Rational Application Developer para el producto de software de WebSphere para especificar enlaces y ensamblar el archivo.

Instalar un archivo EAR, JAR, WAR o SAR, añadiéndolo a un directorio supervisado, no cambia ni la JNDI (Java Naming and Directory Interface) ni otros enlaces de aplicaciones existentes. Si debe establecer los valores de enlace durante el despliegue, instale el archivo utilizando el asistente de instalación de la aplicación de la consola administrativa, un script wsadmin, o un archivo de propiedades que establece los enlaces. Consulte Instalación de archivos de aplicación de empresa añadiendo los archivos de propiedades a un directorio supervisado.

De forma predeterminada, el despliegue del directorio supervisado no está habilitado. Para poder utilizar el despliegue del directorio supervisado, debe habilitarlo. Consulte Establecimiento de los valores de despliegue de directorio supervisado.

Restricción: La instalación de un archivo EAR, JAR, WAR o SAR añadiéndolo a un directorio supervisado sólo está disponible en los sistemas operativos distribuidos y en z/OS. No está soportado en sistemas operativos IBM i.
Avoid trouble Avoid trouble: No utilice el despliegue de directorios supervisado en un entorno de producción en el que la aplicación debe permanecer continuamente disponible. En lugar de ello, en los entornos de producción, utilice un proceso automático que distribuya actualizaciones de aplicaciones en cada servidor de aplicaciones purgando primero las solicitudes de cada servidor, actualizando la aplicación y luego reiniciando el servidor. Para obtener información sobre este proceso automático, consulte IBM WebSphere Developer Technical Journal: Maintain continuous availability while updating WebSphere Application Server enterprise applications (Mantenimiento de disponibilidad continua al actualizar aplicaciones empresariales de WebSphere Application Server).gotcha

Acerca de esta tarea

Puede desplegar un archivo EAR, JAR, WAR o SAR en un servidor de aplicaciones o clúster arrastrando o copiando el archivo a un directorio supervisado.

Para los servidores de aplicaciones (autónomos) base, el directorio supervisado es el directorio monitoredDeployableApps/servers/nombre_servidor del perfil del servidor de aplicaciones.

Para los gestores de despliegue, los directorios supervisados son los directorios monitoredDeployableApps/servers/nombre_servidor, monitoredDeployableApps/nodes/nombre_nodo/servers/nombre_servidor y monitoredDeployableApps/clusters/nombre_clúster del perfil del gestor de despliegue.

De forma predeterminada, el producto explora un directorio supervisado en busca de las aplicaciones nuevas, cuya frecuencia máxima es cada cinco segundos. Después de encontrar un archivo EAR, JAR, WAR o SAR nuevo en un directorio supervisado, el producto instala el archivo en el servidor de aplicaciones o en el clúster, e inicia la aplicación o el módulo.

Después de añadir un archivo EAR a un directorio supervisado, el producto crea una copia temporal del archivo EAR en otro directorio, e instala el archivo en el servidor. Después de añadir un archivo JAR, WAR o SAR en un directorio supervisado, el producto crea una copia temporal del archivador en otro directorio, envuelve el archivador en un archivo EAR denominado extensión_archivador.ear, e instala el archivo EAR nuevo. Por ejemplo, simpleApp.war se instala como simpleApp_war.ear. El archivo original que ha añadido al directorio supervisado no se cambia.

Puede actualizar los archivos de aplicación de la misma forma. Si, posteriormente, añade un archivo EAR, JAR, WAR o SAR actualizado al mismo directorio supervisado, el producto detiene la aplicación desplegada anteriormente, instala el archivo actualizado en el servidor de aplicaciones o en el clúster, e inicia la aplicación o el módulo actualizado. Por ejemplo, supongamos que ha desplegado anteriormente my_app.ear arrastrándolo a un directorio supervisado. Si, posteriormente, arrastra un archivo denominado mi_aplicación.ear al directorio supervisado, el producto sustituye el archivo EAR desplegado previamente con el archivo EAR actualizado que tiene el mismo nombre. El servidor o clúster debe estar ejecutándose para que el producto perciba los cambios de los archivos en el directorio supervisado.

Puede utilizar un navegador de archivos gráfico para arrastrar o copiar el archivo EAR, JAR, WAR o SAR. Si lo prefiere, puede utilizar los mandatos del sistema operativo para copiar un archivo a un subdirectorio supervisado monitoredDeployableApps.

Procedimiento

  1. Asegúrese de que el servidor de aplicaciones o el miembro de clúster en el que desea instalar el archivo de aplicaciones de empresa se esté ejecutando.
  2. Asegúrese de que el despliegue del directorio supervisado esté habilitado.

    Consulte Establecimiento de los valores de despliegue de director supervisado.

  3. Examine la estructura de archivos del sistema y busque o cree el directorio supervisado.
    Para los servidores de aplicaciones (autónomos) base, el directorio supervisado se encuentra en el perfil del servidor de aplicaciones. La vía de acceso del directorio es:
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_aplicaciones/profiles/nombre_perfil_servidor_aplicaciones/monitoredDeployableApps/servers/server_name
    • [z/OS]raíz_servidor_aplicaciones/AppServer/profiles/default/monitoredDeployableApps/servers/nombre_servidor
    Para servidores autónomos, el producto crea un directorio supervisado automáticamente nombre_servidor.
    Para los servidores de aplicaciones que se encuentran en un nodo gestionado (federado) de un gestor de despliegue, cree un directorio supervisado en el perfil del gestor de despliegue. La vía de acceso del directorio es:
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_aplicaciones/profiles/nombre_perfil_gestor_despliegue/monitoredDeployableApps/servers/nombre_servidor
    • [z/OS]raíz_servidor_aplicaciones/AppServer/profiles/default/monitoredDeployableApps/servers/nombre_servidor
    Para los servidores de aplicaciones que se encuentren en un nodo federado, debe crear el directorio supervisado nombre_servidor. El nombre del directorio debe coincidir con el nombre de un servidor existente.
    Si varios servidores que tengan el mismo nombre se encuentran en nodos federados diferentes, y desea que sólo uno de los servidores sea un directorio supervisado, puede especificar el nodo y el servidor para el directorio supervisado. Cree los directorios /nodes/nombre_nodo/servers/nombre_servidor en el perfil del gestor de despliegue. La vía de acceso del directorio es:
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_aplicación/profiles/nombre_perfil_gestor_despliegue/monitoredDeployableApps/nodes/nombre_nodo/servers/nombre_servidor
    • [z/OS]raíz_servidor_apl/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/nombre_nodo/servers/nombre_servidor
    Debe crear directorios para el nodo y el servidor. El nombre del directorio nombre_nododebe coincidir con el nombre de un nodo existente. El nombre del directorio nombre_servidor debe coincidir con el nombre de un servidor existente en el nodo.
    Para los clústeres, cree un directorio supervisado en el perfil del gestor de despliegue. La vía de acceso del directorio es:
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_apl/profiles/nombre_perfil_gestor_despliegue/monitoredDeployableApps/clusters/nombre_clúster
    • [z/OS]raíz_servidor apl/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/nombre_clúster
    Es necesario que cree el directorio supervisado nombre_clúster. El nombre de directorio debe coincidir con el nombre de un clúster existente.
  4. Copie el archivo EAR, JAR, WAR o SAR que desea desplegar en el directorio supervisado.

    Elija un archivo que aún no se haya desplegado en el directorio supervisado de destino, a menos que desee actualizar un archivo desplegado actualmente.

    Si un archivo ya se ha desplegado en un directorio supervisado de un gestor de despliegue, y desea desplegar el archivo en otro directorio supervisado del gestor de despliegue, elimine el archivo del directorio supervisado del destino actual antes de añadir el archivo al directorio supervisado del destino nuevo. Para este release, un archivo de la aplicación debe existir en un único directorio supervisado de un gestor de despliegue.

Resultados

El producto añade un directorio que tiene el mismo nombre que el archivo al directorio installedApps/nombre_célula del perfil.

Además, el producto graba mensajes sobre el despliegue de la aplicación en el archivo SystemOut.log, en el directorio raíz_servidor_aplicaciones/logs/nombre_servidor. Los mensajes empiezan con la clave de mensaje CWLDD.

Los mensajes indican que el producto ha desplegado el archivo de la aplicación, y que la aplicación se está ejecutando.

Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.

Para instalaciones de un directorio supervisado por el gestor de despliegue, el producto no inicia automáticamente una aplicación o módulo si el agente de nodo o el servidor no están en ejecución. Si un agente de nodo está detenido, el producto instala la aplicación o el módulo en el nivel del gestor de despliegue, pero no sincroniza los cambios con el nodo, y no inicia la aplicación ni el módulo. Los cambios se producirán en el nodo la próxima vez que el agente esté en ejecución y se produzca una sincronización de nodo. Si el servidor se ha detenido, pero el agente de nodo se está ejecutando, el producto instala la aplicación o el módulo y sincroniza los cambios con el nodo, pero no inicia el servidor.

Ejemplo

Supongamos que desea instalar el archivo de ejemplo DynaCacheEsi.ear copiando el archivo EAR en un directorio supervisado. Puede encontrar el archivo EAR de ejemplo en el directorio raíz_servidor_aplicaciones/installableApps.

Despliegue de un archivo EAR en un servidor de aplicaciones autónomo
  1. Asegúrese de que el servidor de aplicaciones en el que desea instalar el archivo DynaCacheEsi.ear se esté ejecutando.

    Para ver si el servidor está en ejecución, puede utilizar el mandato serverStatus -all. Para iniciar el servidor, puede utilizar el mandato startServer nombre_servidor.

    [AIX Solaris HP-UX Linux Windows]Por ejemplo, supongamos que el servidor de aplicaciones autónomo tiene un nombre de perfil AppSrv02. Por ejemplo, para iniciar un servidor de aplicaciones denominado server1 en AppSrv02, ejecute el manda to startServer desde un indicador de mandatos en el directorio raíz_servidor_apl/profiles/AppSrv02/bin:
    serverStatus -all

    Si el servidor no se está ejecutando, inícielo.

    [AIX Solaris HP-UX Linux Windows]Por ejemplo, para iniciar un servidor de aplicaciones denominado server1 en AppSrv02, ejecute el manda to startServer desde un indicador de mandatos en el directorio raíz_servidor_apl/profiles/AppSrv02/bin:
    startServer server1
    El mensaje Servidor server1 abierto para e-business indica que el servidor está en ejecución.
  2. Localice el directorio supervisado.

    [AIX Solaris HP-UX Linux Windows]Para el perfil AppSrv02 autónomo, el directorio supervisado es raíz_servidor_aplicaciones/profiles/AppSrv02/monitoredDeployableApps/servers/server1.

  3. Copie el archivo DynaCacheEsi.ear del directorio raíz_servidor_aplicaciones/installableApps en el directorio supervisado.
  4. Verifique que exista el directorio para las aplicaciones.
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_apl/profiles/AppSrv02/installedApps/nombre_célula/DynaCacheEsi.ear
    • [z/OS]raíz_servidor_apl/profiles/default/installedApps/nombre_célula/DynaCacheEsi.ear
  5. Verifique que DynaCacheEsi.ear esté en la lista de aplicaciones de empresa instaladas y que se esté ejecutando
Desplegar un archivo EAR en un nodo federado de un gestor de despliegue
  1. Asegúrese de que el servidor de aplicaciones del nodo federado en el que desea instalar el archivo DynaCacheEsi.ear se esté ejecutando.

    Para ver si el servidor está en ejecución, puede utilizar el mandato serverStatus -all. Para iniciar el servidor, puede utilizar el mandato startServer nombre_servidor.

    [AIX Solaris HP-UX Linux Windows]Por ejemplo, supongamos que el servidor de aplicaciones server1 está en un nodo que tiene un nombre de perfil AppSrv01. Ejecute el mandato serverStatus desde un indicador de mandatos en el directorio raíz_servidor_apl/profiles/AppSrv01/bin:
    serverStatus -all

    Si el servidor no se está ejecutando, inícielo.

    [AIX Solaris HP-UX Linux Windows]Por ejemplo, ejecute el mandato startServer desde un indicador de mandatos en el directorio raíz_servidor_apl/profiles/AppSrv01/bin:
    startServer server1
  2. Asegúrese de que el archivo DynaCacheEsi.ear no exista en ninguno de los directorios supervisados del gestor de despliegue.

    Para este release, añada un archivo de aplicación sólo a un directorio supervisado de un gestor de despliegue. Si un archivo de la aplicación ya existe en un directorio supervisado del gestor de despliegue, y añade un archivo de aplicación que tenga el mismo nombre de archivo a un directorio supervisado de gestor de despliegue diferente, el producto desinstala el archivo de la aplicación del destino anterior, y lo instala en el destino nuevo. No obstante, el destino de nuevo no está sincronizado con el despliegue porque el archivo todavía existe en el directorio supervisado de destino anterior. Para evitar problemas con la sincronización, debe eliminar DynaCacheEsi.ear de todos los directorios supervisados antes de añadir DynaCacheEsi.ear al directorio de destino nuevo.

  3. Cree el directorio supervisado.

    Para los nodos federados, debe crear un directorio supervisado en el perfil del gestor de despliegue, a menos que el directorio para el servidor de destino ya exista.

    [AIX Solaris HP-UX Linux Windows]Por ejemplo, supongamos que el perfil del gestor de despliegue es Dmgr01, y el servidor de aplicaciones es server1.

    1. Vaya al directorio /monitoredDeployableApps/servers:
      • [AIX Solaris HP-UX Linux Windows]raíz_servidor_apl/profiles/Dmgr01/monitoredDeployableApps/servers
      • [z/OS]raíz_servidor_apl/AppServer/profiles/default/monitoredDeployableApps/servers
    2. Si existe un directorio denominado server1 en el directorio servers, vaya al paso siguiente.

      Si el directorio server1 no existe, cree un directorio denominado server1 en el directorio /monitoredDeployableApps/servers.

    El directorio supervisado es:
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_apl/profiles/Dmgr01/monitoredDeployableApps/servers/server1
    • [z/OS]raíz_servidor_apl/AppServer/profiles/default/monitoredDeployableApps/servers/server1
  4. Copie el archivo DynaCacheEsi.ear del directorio raíz_servidor_aplicaciones/installableApps en el directorio supervisado server1.
  5. Verifique que exista el directorio para las aplicaciones.
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_apl/profiles/AppSrv01/installedApps/nombre_célula/DynaCacheEsi.ear
    • [z/OS]raíz_servidor_apl/AppServer/profiles/default/installedApps/nombre_célula/DynaCacheEsi.ear
  6. verifique que DynaCacheEsi.ear esté en la lista de aplicaciones de empresa instaladas en el servidor y que se esté ejecutando.
Consejo: Si varios servidores que tengan el mismo nombre se encuentran en nodos federados diferentes, y desea que sólo uno de los servidores sea un directorio supervisado, puede especificar el nodo y el servidor para el directorio supervisado. Cree los directorios /nodes/nombre_nodo/servers/nombre_servidor en el perfil del gestor de despliegue. Por ejemplo, si desea que el directorio supervisado sea el servidor de aplicaciones server1 en el nodo myNode01, la vía de acceso del directorio es:
  • [AIX Solaris HP-UX Linux Windows]raíz_servidor_apl/profiles/Dmgr01/monitoredDeployableApps/nodes/myNode01/servers/server1
  • [z/OS]raíz_servidor_apl/DeploymentManager/profiles/default/monitoredDeployableApps/nodes/myNode01/servers/server1
Especifique sólo el nodo para un directorio supervisado si más de un servidor tiene el mismo nombre.
Desplegar un archivo EAR en un clúster de un gestor de despliegue
  1. Asegúrese de que los miembros de clúster del clúster en el que desea instalar el archivo DynaCacheEsi.ear se estén ejecutando. Para este ejemplo, el clúster myCluster01 tiene un miembro, myClusterMember01.
  2. Para ver si el clúster está en ejecución, puede utilizar el mandato serverStatus -all. Para iniciar el miembro de clúster, puede utilizar el mandato startServer myClusterMember01.
    [AIX Solaris HP-UX Linux Windows]Por ejemplo, supongamos que myClusterMember01 está en el perfil AppSrv01. Ejecute el mandato serverStatus desde un indicador de mandatos en el directorio raíz_servidor_apl/profiles/AppSrv01/bin:
    serverStatus -all
    Ejecute el mandato startServer desde un indicador de mandatos en el directorio raíz_servidor_apl/profiles/AppSrv01/bin:
    startServer myClusterMember01
  3. Asegúrese de que el archivo DynaCacheEsi.ear no exista en ninguno de los directorios supervisados del gestor de despliegue.
  4. Cree el directorio supervisado.

    Para los clústeres, debe crear un directorio supervisado en el perfil del gestor de despliegue, a menos que el directorio para el servidor de destino ya exista.

    [AIX Solaris HP-UX Linux Windows]Por ejemplo, supongamos que el perfil del gestor de despliegue es Dmgr01:
    1. Vaya a raíz_servidor_apl/profiles/Dmgr01/monitoredDeployableApps/clusters.
    2. Si existe un directorio llamado myCluster01 en el directorio /clusters, vaya al paso siguiente.

      Si el directorio myCluster01 no existe, cree un directorio denominado myCluster01 en el directorio /clusters.

    El directorio supervisado es:
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_apl/profiles/Dmgr01/monitoredDeployableApps/clusters/myCluster01
    • [z/OS]raíz_servidor_apl/DeploymentManager/profiles/default/monitoredDeployableApps/clusters/myCluster01
  5. Copie el archivo DynaCacheEsi.ear del directorio raíz_servidor_aplicaciones/installableApps en el directorio supervisado myCluster01.
  6. Verifique que exista el directorio para las aplicaciones.
    • [AIX Solaris HP-UX Linux Windows]raíz_servidor_apl/profiles/AppSrv01/installedApps/nombre_célula/DynaCacheEsi.ear
    • [z/OS]raíz_servidor_apl/AppServer/profiles/default/installedApps/nombre_célula/DynaCacheEsi.ear
  7. verifique que DynaCacheEsi.ear esté en la lista de aplicaciones de empresa instaladas en el clúster y que se esté ejecutando.

Qué hacer a continuación

Pruebe la aplicación o el módulo desplegados. Por ejemplo, con el navegador web vaya a la dirección URL de una aplicación desplegada y revise el rendimiento de la aplicación.

Si el despliegue no resulta satisfactorio, lea los mensajes del archivo SystemOut.log, arregle la condición de error, y vuelva a añadir la aplicación o el módulo al directorio supervisado nuevo.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_install_dragdrop
File name: trun_app_install_dragdrop.html