Este documento contiene información para desplegar (deploy) aplicaciones Java en Apache Tomcat en un servicio de hosting administrado con cPanel: qué tenés que preparar, cómo subir la aplicación y qué tareas realiza el soporte.
Apache Tomcat es el servidor que ejecuta aplicaciones web Java (archivos .war, JSP y servlets). En el hosting con cPanel, Tomcat funciona en un entorno aislado de tu cuenta que activa y administra el soporte. Vos preparás la aplicación y la subís desde cPanel.
¿Qué hace cada uno?
- Vos: empaquetás la aplicación, la subís a la carpeta indicada y revisás que funcione.
- El soporte: activa Tomcat en tu cuenta, lo conecta con tu dominio y lo reinicia cuando hace falta.
Importante: Tomcat no está disponible en todos los servicios, y las aplicaciones Java consumen bastante memoria. Antes de empezar, consultá al área comercial, desde el portal de clientes o el chat online, si tu servicio lo incluye o si conviene actualizarlo.
1. Preparar la aplicación
- Empaquetala como un archivo
.war, con Maven, Gradle o Ant desde tu computadora. - El servidor usa Tomcat 10.1, que trabaja con Jakarta EE (paquetes
jakarta.*). Si tu aplicación fue hecha para Tomcat 9 o anterior y usajavax.*, migrala antes de subirla. - Si la aplicación tiene que responder en la dirección principal (
https://tudominio.com), nombrá el archivoROOT.war. Con otro nombre, por ejemploapp.war, queda enhttps://tudominio.com/app. - Si usa una base de datos, creala en cPanel, en Bases de datos → Bases de datos MySQL, y configurá la conexión con el servidor
localhost.
2. Solicitar la activación de Tomcat
Abrí un ticket desde el portal de clientes pidiendo la activación de Tomcat. Indicá:
- El dominio o subdominio donde va a funcionar la aplicación.
- La ruta: la raíz (
/) o una carpeta, como/app. - Si querés que las versiones nuevas se publiquen automáticamente al subirlas.
Cuando esté listo, el soporte te indica la carpeta donde tenés que subir la aplicación.
3. Subir la aplicación
Acceso: ingresá a cPanel desde el portal de clientes → Iniciar sesión en cPanel, o en https://tudominio.com/cpanel. Después abrí Archivos → Administrador de archivos.
- Entrá a la carpeta que te indicó el soporte. Es la carpeta
webappsde Tomcat, dentro deea-podman.den la carpeta de inicio de la cuenta. - Hacé clic en Cargar y subí el archivo
.war. También podés subirlo por FTP con la cuenta principal. - Si activaron la publicación automática, Tomcat despliega la aplicación en unos minutos y crea una carpeta con su nombre, por ejemplo
ROOT. Si no, respondé el ticket para que el soporte la publique.
Importante: no subas la aplicación a public_html: Tomcat solo lee su propia carpeta webapps. Tampoco modifiques los archivos de la carpeta conf: los cambios ahí pueden detener Tomcat.
4. Verificar y actualizar
- Entrá a la dirección de la aplicación desde el navegador y probá sus funciones principales.
- Si algo falla, revisá los registros en la carpeta
logsde Tomcat, al lado dewebapps, con el Administrador de archivos. - Para publicar una versión nueva, reemplazá el
.warenwebapps. Si no tenés la publicación automática, pedí el reinicio por ticket.
Problemas frecuentes
- No encuentro la carpeta
ea-podman.d: Tomcat todavía no está activado en tu cuenta. Solicitalo por ticket. - Subí el
.wary no se crea la carpeta de la aplicación: la publicación automática no está activa. Pedí el despliegue por ticket. - Error
ClassNotFoundExceptioncon clasesjavax.servlet: la aplicación es para Tomcat 9 o anterior. Migrala a Jakarta EE, cambiandojavax.*porjakarta.*. - La aplicación funciona pero el dominio muestra otra página: falta conectar el dominio con Tomcat. Avisá por ticket.
- La aplicación se detiene o va lenta: no tiene memoria suficiente. Podés actualizar tu servicio consultando al área comercial.
Más información sobre cómo empaquetar aplicaciones en la documentación oficial de Tomcat. Si necesitás ayuda con el despliegue, abrí un ticket desde el portal de clientes o consultá por el chat online del sitio.