Cómo instalar Tomcat en FreeBSD 12

En esta entrada veremos cómo instalar Tomcat en FreeBSD 12 paso a paso, de modo que al final de este pequeño tutorial tendrás listo tu servidor o VPS FreeBSD para desplegar tus desarrollos en Java o aplicaciones y servlets de terceros.

Antes de instalar Tomcat en FreeBSD 12

Si quieres completar esta guía de instalación de Tomcat en FreeBSD 12 necesitarás partir de la siguiente base:

  • Una máquina FreeBSD 12 actualizada.
  • El entorno de ejecución de Java.
  • Acceso a terminal de comandos con root o un usuario con permisos de sudo.
  • Conexión a Internet.

Si aún no dispones del entorno necesario puede ser buena idea consultar previamente nuestra guía de instalación de Java OpenJDK en FreeBSD 12, aunque Tomcat tiene como dependencia la versión 8 de este lenguaje, pero puede ser buena idea configurar el entorno correctamente.

Una vez preparados estos requisitos mínimos podemos ir directamente a la explicación, así que vamos abriendo una terminal.

Cómo instalar Tomcat en FreeBSD 12

En esta ocasión vamos a instalar Tomcat en FreeBSD 12 desde los repositorios del sistema, ya que los paquetes disponibles nos ofrecen versiones muy recientes y próximas al último lanzamiento estable oficial, teniendo en cuenta que en el momento de escribir este tutorial la página oficial ofrece la versión 9.0.43.

Por tanto, el primer paso sería actualizar las listas de paquetes y, por qué no, los paquetes ya instalados:

~$ sudo pkg update

Hecho esto, el paquete que necesitamos es tomcat9, así que procedemos a instalarlo con pkg:

~$ sudo pkg install -y tomcat9

Tras descargar e instalar el paquete principal y todas sus dependencias, se crea un nuevo servicio, llamado tomcat9, en nuestro sistema FreeBSD 12.

Este servicio no arranca tras la instalación ni está configurado para hacerlo con cada inicio del sistema, así que en primer lugar lo activamos para que inicie automáticamente:

~$ sudo service tomcat9 enable

Y a continuación lo arrancamos manualmente para empezar a trabajar:

~$ sudo service tomcat9 start

Podemos comprobar el estado del servicio tomcat9 usando el comando sudo service tomcat9 status:

como instalar tomcat en freebsd 12

Cómo acceder a Tomcat en FreeBSD 12

Para acceder a Tomcat en FreeBSD 12 desde un navegador podemos utilizar la dirección IP o dominio del servidor, especificando el puerto 8080.

Por ejemplo, el servidor de este tutorial responde al subdominio freebsd12.local.lan, así que usaremos http://freebsd12.local.lan:8080 como URL:

instalar tomcat en freebsd 12

Vemos a la derecha de la página principal una pila con tres enlaces, rotulados como «Server Status«, «Manager App» y «Host Manager«. Son muy importantes, pero aún no podemos acceder a ellos.

Cómo configurar Tomcat en FreeBSD 12

El directorio de configuración de Tomcat se encuentra en la ruta /usr/local/apache-tomcat-9.0/conf/.

Los tres enlaces anteriormente mencionados no se pueden acceder desde fuera del servidor FreeBSD 12, ya que si lo intentas te encontrarás con un aviso de que no estás autorizado a acceder.

como configurar tomcat en freebsd 12

Cómo permitir administración remota

Si deseas acceder a las páginas de administración del servidor Tomcat tendremos que editar el archivo context.xml ubicado en el directorio de configuración de cada una de las aplicaciones.

En este caso «Server Status» (manager/status) y «Manager App» (manager/html) son la misma aplicación (manager), mientras que «Host Manager» (hostmanager/html) es otra aplicación (hostmanager).

Empezamos con la aplicación manager, ubicada en la ruta /usr/local/apache-tomcat-9.0/webapps/manager/, editaremos su archivo context.xml:

~$ sudo nano /usr/local/apache-tomcat-9.0/webapps/manager/META-INF/context.xml

Buscaremos este bloque:

...
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
       allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
...

Y la encerraremos entre comentarios de XML, quedando así:

<!--
  <Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
-->

De esa forma eliminamos la directiva que restringe el acceso permitiéndolo a la máquina local en exclusiva.

Para la aplicación host-manager haríamos otro tanto, editando su correspondiente archivo context.xml:

~$ sudo nano /usr/local/apache-tomcat-9.0/webapps/host-manager/META-INF/context.xml

Se repetiría la operación exactamente de la misma forma.

Una vez guardados los cambios, el acceso es posible de forma remota, pero será necesario refrescar la página principal y acceder desde los enlaces (no sirve simplemente refrescar la página de la aplicación a la que intentamos acceder).

Cómo crear usuarios para administrar Tomcat

Ahora ya podemos acceder a las páginas de administración de aplicaciones y del servidor; sin embargo se nos solicita un usuario y contraseña:

configurar tomcat en freebsd 12

Por defecto no hay usuarios, debemos crearlos.

En Tomcat los usuarios se basan en el concepto de roles, de modo que un rol es un conjunto de permisos o privilegios que pueden otorgarse a aquellos usuarios que poseen ese rol.

Así que primero crearemos los roles necesarios y a continuación un usuario con dichos roles.

Esto se hace editando el archivo de configuración tomcat-users.xml de Tomcat:

~$ sudo nano /usr/local/apache-tomcat-9.0/conf/tomcat-users.xml

Este archivo contiene un gran bloque tomcat-users que sólo contiene comentarios.

Al final del bloque, justo antes de la etiqueta de cierre podemos añadir una etiqueta user para crear el usuario, su contraseña y los roles que desempeña:

...
<user username="usuario" password="XXXXXXXX" roles="admin-gui,manager-gui"/>
...

Los roles ya están creados por defecto, así que no necesitamos definirlos.

Quedaría algo así:

...
        <user username="usuario" password="XXXXXXXX" roles="admin-gui,manager-gui" />
</tomcat-users>

Por supuesto, puedes crear distintos usuarios con distintos roles, según tus propias necesidades.

Con tus usuarios ya creados puedes acceder a las distintas secciones del panel de administración.

Por ejemplo, a «Server Status«, que te mostrará el estado del servidor:

tomcat en FreeBSD 12

En «Manager App» podrás ver las aplicaciones instaladas y gestionarlas, además de desplegar nuevas aplicaciones:

tomcat para freebsd 12

Y en «Host Manager» tendrás la oportunidad de crear y gestionar máquinas virtuales:

como instalar y configurar freebsd 12

Desplegar aplicaciones en Tomcat para FreeBSD 12

Si quieres desplegar aplicaciones de servidor en Tomcat para FreeBSD 12 a través de archivos .war mediante la aplicación «Manager App» es posible que necesites ajustar el tamaño máximo de archivo que se puede subir a la aplicación, dependiendo del tamaño de los archivos. Este ajuste se realiza en el archivo de configuración web.xml de la aplicación manager:

~$ sudo nano /usr/local/apache-tomcat-9.0/webapps/manager/WEB-INF/web.xml

Buscaremos el bloque multipart-config:

...
    <multipart-config>
      <!-- 50MB max -->
      <max-file-size>52428800</max-file-size>
      <max-request-size>52428800</max-request-size>
      <file-size-threshold>0</file-size-threshold>
    </multipart-config>
...

Los valores que necesitamos modificar son los de los parámetros max-file-size y max-request-size, cuyos valores por defecto, expresados en bytes, permiten tamaños de archivo de hasta 50 MB. Para permitir tamaños mayores, por ejemplo, 150 MB basta con sustituir los nuevos valores expresándolos en bytes:

...
    <multipart-config>
      <!-- 150MB max -->
      <max-file-size>157286400</max-file-size>
      <max-request-size>157286400<max-request-size>
      <file-size-threshold>0</file-size-threshold>
    </multipart-config>
...

Guardamos los cambios y cerramos el archivo.

Cómo desplegar archivos WAR en Tomcat

Para instalar un archivo .war accedemos a la aplicación «Manager App» y nos desplazamos hasta la sección «Desplegar«, donde en el apartado «Archivo WAR a desplegar» seleccionaremos el archivo buscándolo en el sistema local de archivos mediante el diálogo que se abre al pulsar el botón «Seleccionar archivo«.

Una vez seleccionado el archivo lo instalaremos pulsando el botón «Desplegar«. Al terminar la subida del archivo, se instalará la aplicación y cargará de nuevo la página de gestor de aplicaciones web, mostrando un mensaje de estado y, si el proceso ha sido exitoso, aparecerá la nueva aplicación en la lista de aplicaciones disponibles:

La aplicación se podrá controlar a través del panel de acciones, pero también la podremos ejecutar simplemente siguiendo el enlace que aparece en la lista de aplicaciones:

¡Justo lo que queríamos!

Conclusión

Ya sabes cómo instalar Tomcat en FreeBSD 12, por lo que estás listo para desplegar aplicaciones corporativas o tus propios desarrollos en tu servidor o VPS FreeBSD 12.

Cualquier duda, pregunta, sugerencia, notificación, etc. puedes dejarla en forma de comentario.

¡Apoya esta entrada!

Y si esta guía de instalación de Tomcat en FreeBSD 12 te ha resultado de verdadera utilidad, cualquier mínima contribución al mantenimiento y desarrollo de este sitio es bienvenida, y puedes hacerlo invitándome a un café:

 

O dejando una propina de 1 $ con PayPal:

¡Gracias!

Valora esta entrada

1 estrella2 estrellas3 estrellas4 estrellas5 estrellas (5 votos, promedio: 5,00 de 5)
Cargando...

Deja un comentario

Este sitio web utiliza cookies para que usted tenga la mejor experiencia de usuario. Si continúa navegando está dando su consentimiento para la aceptación de las mencionadas cookies y la aceptación de nuestra política de cookies.

ACEPTAR
Aviso de cookies