Un archivo .ear puede contener módulos web, componentes EJB y otros recursos de una aplicación empresarial. Tenerlo listo simplifica el despliegue, pero aún debemos elegir el servidor o clúster correcto, configurar sus dependencias y comprobar que la aplicación responde.
Esta guía describe el primer despliegue de una aplicación nueva mediante las consolas administrativas. Las rutas pueden variar ligeramente según la versión. Para WebSphere, tomamos como referencia WebSphere Application Server traditional; para WebLogic, la Administration Console.
Antes de comenzar
Confirma estos datos con el equipo de desarrollo o con la solicitud de cambio:
- Nombre y versión del archivo
.ear. - Servidor o clúster donde debe ejecutarse.
- URL o context root esperado para los módulos web.
- Recursos que utiliza: datasources, destinos JMS, entradas JNDI, bibliotecas compartidas o certificados.
- Método de validación: URL de salud, inicio de sesión o transacción de prueba.
También conviene conservar una copia identificable del EAR y registrar su versión o suma de verificación. Que el archivo exista no garantiza que sus dependencias estén configuradas en el entorno.
Desplegar el EAR en IBM WebSphere
- Entra en la consola administrativa. Accede a la consola de WebSphere con una cuenta autorizada para instalar aplicaciones.
- Abre el asistente de instalación. Ve a Applications → Application Types → WebSphere enterprise applications y selecciona Install.
- Selecciona el archivo EAR. Indica la ruta del archivo según las opciones que presente el asistente. Revisa que el nombre de la aplicación sea el esperado.
- Elige el destino. Asigna los módulos al servidor o clúster correspondiente. Si la aplicación tiene módulos web, revisa también su asociación con el servidor web cuando tu arquitectura lo requiera.
- Revisa las asignaciones. Comprueba el context root, las referencias a recursos JNDI y las demás opciones del asistente. Una referencia a un datasource o a JMS debe corresponder con un recurso disponible en el destino.
- Finaliza y guarda. Completa la instalación y guarda los cambios en la configuración administrativa.
- Sincroniza los nodos si utilizas Network Deployment. Comprueba que los cambios lleguen a los nodos de destino; si hace falta, usa System administration → Nodes → Synchronize.
- Inicia la aplicación. Regresa a WebSphere enterprise applications, selecciona la aplicación y pulsa Start. Verifica que figure como Started. IBM distingue la instalación, el guardado, la sincronización y el inicio como pasos del proceso. (ibm.com)
Desplegar el EAR en Oracle WebLogic
- Entra en la Administration Console. Accede al dominio con una cuenta que pueda administrar despliegues.
- Habilita la edición cuando corresponda. En Change Center, pulsa Lock & Edit si tu consola lo solicita.
- Abre los despliegues. En el menú lateral, entra en Deployments y selecciona Install.
- Localiza el EAR. Selecciona el archivo
.eary continúa con Next. Si el archivo está en tu equipo, utiliza la opción de carga que ofrezca la consola; si ya está en el servidor, selecciona su ruta allí. - Selecciona el tipo de instalación. Elige Install this deployment as an application.
- Asigna el destino. Selecciona los Managed Servers o clústeres que deben ejecutar la aplicación. Revisa el nombre del despliegue y las opciones de distribución del archivo entre servidores.
- Termina y activa los cambios. Pulsa Finish y después Activate Changes en Change Center.
- Inicia la aplicación. En Deployments, selecciona la aplicación y usa Start → Servicing all requests para ponerla a disposición de los usuarios. Instalar el EAR y activar los cambios no equivale necesariamente a iniciar la aplicación. (docs.oracle.com)
Nota sobre versiones: En WebLogic Remote Console, el flujo cambia: Edit Tree → Deployments → App Deployments → New. Allí puedes cargar el EAR o indicar una ruta existente, elegir los destinos y definir su comportamiento al desplegarse. (docs.oracle.com)
Validación después del despliegue
Una aplicación con estado Started todavía puede fallar al atender una petición. Antes de cerrar el cambio:
- Confirma que la aplicación aparece activa en todos los destinos previstos.
- Revisa los registros del servidor y busca errores de inicio, dependencias, JNDI, base de datos o JMS.
- Prueba la URL real de la aplicación o su endpoint de salud.
- Ejecuta una función básica de negocio, si existe una prueba acordada.
- Comprueba que el balanceador o servidor web dirige tráfico hacia los destinos correctos.
- Registra la versión desplegada, los destinos, el resultado de las pruebas y cualquier incidencia.
Oracle también recomienda comprobar el despliegue mediante la URL y el contexto de la aplicación, además de revisar su estado en la consola. (docs.oracle.com)
Problemas frecuentes
| Síntoma | Qué revisar primero |
|---|---|
| La instalación termina, pero la aplicación no inicia | Errores en los registros, bibliotecas requeridas y compatibilidad del EAR con el servidor |
| Fallan conexiones a base de datos | Datasource, nombre JNDI, credenciales y conectividad desde el destino |
| La aplicación inicia, pero la URL devuelve 404 | Context root, puerto, ruta del proxy y servidor o clúster seleccionado |
| Funciona en un nodo, pero falla en otro | Sincronización en WebSphere o disponibilidad del archivo y recursos en los destinos de WebLogic |
| Aparecen errores de mensajería | Destinos JMS y referencias configuradas para la aplicación |
Conclusión
El despliegue no termina al cargar el .ear. En WebSphere hay que guardar los cambios, sincronizar los nodos cuando aplique e iniciar la aplicación. En WebLogic hay que confirmar los destinos, activar los cambios e iniciar el despliegue para atender solicitudes. En ambos casos, la prueba decisiva es que la aplicación funcione desde la ruta que utilizarán sus usuarios.