Cómo instalar Tomcat en FreeBSD 12.1

En esta ocasión vamos a ver cómo instalar Tomcat en FreeBSD 12.1 paso a paso, de modo que podamos usar nuestro servidor o VPS FreeBSD para desplegar servlets o aplicaciones Java de servidor para clientes tanto en red local como a través de Internet.

Antes de instalar Tomcat en FreeBSD 12.1

Para poder completar esta guía de instalación de Tomcat en FreeBSD 12.1 deberías cumplir al menos los siguientes requisitos básicos:

  • Una instalación actualizada de FreeBSD 12.1
  • El entorno de ejecución de Java instalado en el sistema.
  • Un usuario con permisos de sudo o en su defecto el mismo root.
  • Acceso a Internet.

Si aún no dispones de la máquina virtual de Java en tu sistema, te proponemos que eches un vistazo a nuestra guía de instalación de Java en FreeBSD 12.1 antes de empezar. En esta guía usaremos Java 8.

Cómo instalar Tomcat en FreeBSD 12.1

Vamos a instalar Tomcat en FreeBSD 12.1 utilizando los paquetes disponibles en los repositorios del propio sistema, así que el primer paso será actualizar las listas de paquetes:

~$ sudo pkg update

El paquete que necesitamos es tomcat9, que instalaremos con pkg:

~$ sudo pkg install -y tomcat9

Tras la descarga e instalación de los paquetes y dependencias de Tomcat, se creará en FreeBSD 12.1 un nuevo servicio llamado tomcat9, que no queda habilitado para su inicio automático ni en ejecución.

Para habilitar Tomcat y que así inicie en cada arranque de FreeBSD 12.1 usaremos el comando service:

~$ sudo service tomcat9 enable

Y para iniciar el servicio por primera vez usaremos la opción start del mismo comando service:

~$ sudo service tomcat9 start

Podremos comprobar que el servicio ha quedado en ejecución con el comando sudo service tomcat9 status:

como instalar tomcat en freebsd 12.1

Cómo acceder a Tomcat en FreeBSD 12.1

Para acceder a Tomcat en FreeBSD 12.1 desde un navegador podemos utilizar la dirección IP o dominio del servidor, especificando el puerto 8080. Por ejemplo, en este tutorial trabajamos sobre una máquina accesible en el dominio freebsd121.local, así que usaremos http://freebsd121.local:8080 como URL:

instalar tomcat en freebsd 12.1

Podremos ver distintos enlaces internos a la documentación, que es la aplicación docs, y a las aplicaciones principales de gestión como «Server Status» y «Manager App«, que en realidad son la misma aplicación manager, y «Host Manager«, que es la aplicación host-manager.

Podemos probar la aplicación docs abriendo por ejemplo el enlace «Tomcat 9.0 Documentation» en una solapa nueva del navegador:

instalacion de tomcat en freebsd 12.1

Si embargo, si intentamos entrar a las aplicaciones «Server Status» o «Host Manager» encontraremos que no tenemos autorización si accedemos desde una máquina de la red:

instalando tomcat en freebsd 12.1

Veremos cómo solucionar esto a continuación.

Cómo configurar Tomcat en FreeBSD 12.1

Si quieres poder acceder a las aplicaciones administrativas de Tomcat desde la red es necesario configurar manualmente cada aplicación, ya que el acceso se regula en sus configuraciones individuales.

En el caso de la aplicación manager editaríamos su archivo de configuración context.xml:

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

Buscaremos la directiva Valve:

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

Para permitir el acceso remoto habrá que deshabilitar esta directiva encerrándola entre comentarios de XML:

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

Guardados los cambios y cerrado el archivo, la nueva configuración estará inmediatamente disponible.

Para la aplicación host-manager habría que hacer otro tanto con su archivo de configuración context.xml, ubicado en su propio directorio de instalación:

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

El proceso es idéntico al anteriormente descrito.

Ahora al intentar acceder a las aplicaciones administrativas se nos solicita usuario y contraseña:

como configurar tomcat en freebsd 12.1

Algunas aplicaciones pueden requerir inicio de sesión para poder acceder mediante usuarios con cierto nivel de privilegios o roles. Concretamente las aplicaciones manager y host-manager sólo permiten el acceso a usuarios con los roles admin-gui y manager-gui.

Para crear usuarios editaremos el archivo tomcat-users.xml de Tomcat:

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

Podremos crear un usuario para cada rol, o usuarios con varios roles. En este tutorial crearemos un mismo usuario administrador con los roles necesarios para acceder a ambas aplicaciones administrativas. Al final del archivo, pero dentro del bloque tomcat-users, añadiremos el nuevo usuario:

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

Guardados los cambios y cerrado el archivo ya podremos acceder por ejemplo a la aplicación «Server status«, o manager/status utilizando el usuario que acabamos de crear:

configurar tomcat en freebsd 12.1

Igual sucederá con «Manager App«, o manager/html, el gestor de aplicaciones web de Tomcat:

configuracion de tomcat en freebsd 12.1

Y también con «Host Manager» o host-manager, el gestor de máquina virtual de Tomcat:

configurando tomcat en freebsd 12.1

Desplegar aplicaciones en Tomcat para FreeBSD 12.1

Si quieres desplegar aplicaciones de servidor en Tomcat para FreeBSD 12.1 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«.

tomcat en freebsd 12.1

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:

tomcat para freebsd 12.1

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

Ahora que sabes cómo instalar Tomcat en FreeBSD 12.1 estás listo para poder desplegar aplicaciones de servidor o servlets Java, tanto si se trata de aplicaciones de terceros como tus propios desarrollos. La instalación y configuración de Tomcat es un proceso sencillo que no te llevará más allá de unos instantes.

Si te ha surgido alguna duda o tienes preguntas, tal vez alguna sugerencia de mejora o notificación de errores, dejar un comentario es lo indicado.

¡Apoya comoinstalar.me!

¿Todo preparado para desplegar tu primer servlet gracias a esta guía de instalación de Tomcat en FreeBSD 12.1? Si es así y te apetece agradecérnoslo, cualquier pequeña aportación ayuda mucho al mantenimiento de este sitio y la preparación de más artículos sobre FreeBSD 12.1 y Tomcat. ¡Gracias!

Valora esta entrada

1 estrella2 estrellas3 estrellas4 estrellas5 estrellas (1 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