Hoy ante la falta de un manual de instalación unificado y en español quiero contribuir con quienes desde hace mucho tiempo estamos trabajando con datos de geo-referenciación como parte de la ciencias de le GEOMATICA: entendida como la Automatización de referencias Geográficas contenidas en una base de datos.

Aclaremos algunos detalles.

Geoserver.- es una aplicación para la web basado en Java que permite a los usuarios ver y editar datos geoespaciales; usando datos de estándares abiertos definidos por la Open Geospatial Consortium (OGC), Geoserver permite gran flexibilidad en la creación y compartición de mapas. Como referencia podríamos decir que una de las instituciones gubernamentales Ecuatorianas que utiliza este servidor es IGM (Instituto Geográfico Militar).

Tomcat.- por otra parte es una aplicación de código abierto implementada con lenguajes Java Servelets, JavaServer Pages, Java Expressions y Java WebSocket; combina el servidor web Apache como contenedor del servelets que pueden ejecutarse sobre el, esta definido bajo los estándares de JavaServer Pages (JSP) desarrollado por Sun Microsystem cuyas especificaciones están dadas por la JCP (Java Comunity Process).

Con estas aclaraciones podemos continuar; en primer lugar deberíamos instalar el tomcat, aunque la versión actual al momento de escribir este manual es la 9 por temas de compatibilidad y seguridad trataremos de usar una versión estable es decir: tomcat 8; sin embargo tomcat necesita de java SDK y JRE, entonces es MUY IMPORTANTE en primer lugar instalar java en la versión compatible con tomcat 8; por lo tanto instalaremos open java 8 desde la terminal:

1.- Instalación de JAVA 21

En Debian 13 viene por defecto instalado el java 7 u 8; si es superior a estos podemos desinstalarlo del sistema de la siguiente manera

# apt remove openjdk-8-jdk
# apt remove openjdk-8-jre

hecho esto siempre es conveniente limpiar los residuos de la aplicaciones removidas con el comando

# apt autoclear
# apt autoremove

Ahora ya podremos instalar la nueva versión de Open Java:

Para la instalación con las siguientes instrucciones:

# apt install openjdk-21-jdk
# apt install openjdk-21-jre

# apt update

Ahora bien debemos comprobar si en efecto se instalo la versión 8 de Java, para eso usamos el siguiente comando:

# java -version

y el resultado debe ser algo similar a esto:

Nótese que ya esta la versión 21 del Java instala !!

2.- Instalación de Tomcat 9

Link de referencia aqui

Una ves actualizado el java vamos a proceder con la instalación del tomcat-apache debo indicar que el Geoserver es compatible con versiones de java 8 .. 21 en adelante (con la 7 no funciona); bien instalar tomcat es muy fácil pues ya se encuentra en el repositorio de Debian, al momento de escribir este tutorial Geoserver es compatible con tomcat ver 9, si bien es cierto esta ya liberada la versión 11, instalarlo nos dará problemas; por lo tanto basta con usar el siguiente comando desde la terminal:

 # apt install tomcat9 tomcat9-admin

Estamos instalando el Tomcat y algo importante que es las herramientas de administraron del tomcat, que nos permitirá subir la los servelets al servidor apache-tomcat. Una ves instalado necesitamos afinar algunas configuraciones importantes, empezaremos por la pagina de administración colocando al usuario de administración con su nombre y password, para eso editamos el archivo tomcat-user.xml que se instalo previamente.

# nano /etc/tomcat11/tomcat-users.xml

y dentro de el agregamos la siguiente linea de instrucción casi al final, justo antes de la ultima linea:

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

Donde «admin» en este caso son el nombre de usuario y la clave; puedes elegir la que mejor te guste y distinto a esto porque en producción estas claves son facilitas de predecir. Guardas los cambios y vamos a editar otro archivo.

El tamaño máximo de los archivos que se pueden subir al tomcat son de máximo 50 MB; sin embargo el Geoserver pesa 60.1 MB es decir es mayor que el permitido por tomcat, para solucionar esto vamos a editar el archivo web-xml donde cambiaremos esos parámetros, así:

# nano /usr/share/tomcat11-admin/manager/WEB-INF/web.xml

Si la instalación se hizo con la versión 9

# nano /opt/tomcat9/webapps/manager/WEB-INF/web.xml

Nótese el directorio donde se encuentra, es distinto al de usuario que modificamos antes.

Una ves dentro localizamos las siguientes líneas:

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

una ves dentro al numero 52428800 agregamos un 0 lo que aumentara notablemente el tamaño de los archivos que vamos a subir.

Con todos estos cambios ahora debemos reiniciar a tomcat con el comando a continuación:

# service tomcat11 restart

Listo! ahora para probar si esta funcionando nuestro servidor podemos ingresar en el navegador y colocar la siguiente dirección URL.

localhost:8080

y veremos esto.

lo que significa que Funciona!!!

3.- Instalación de Geoserver

Finalmente instalaremos el Geoserver – ya falta poco – para poder instalarlo debemos primero bajar el archivo del servidor, debido a que es una servelets su extensión sera .WAR y el archivo que bajaremos es una comprimido desde la web oficial de Geoserver en la siguiente dirección:

http://geoserver.org/release/stable/

Bajaremos la versión 2.28 fíjate que hay varias versiones, según el sistema operativo nosotros escogeremos el «Web Archive», es decir el comprimido que contiene el geoserver.war.

o podemos descargarlo directamente con el siguiente comando:

# wget https://sourceforge.net/projects/geoserver/files/GeoServer/2.28.0/geoserver-2.28.0-war.zip

Una ves descargado debemos descomprimirlo puede ser en la mismo directorio de Descargas donde podrás localizar el geoserver.war.

Ahora ya podemos «subir» el geoserver al tomcat para eso desde la web del tomcat veremos el link: manager webapp. Al hacer click allí nos solicita el usuario y la clave que habíamos colocado con anterioridad (admin admin) y ahí ingresa a la pagina de gestión de los servelets buscamos la opción siguiente:

En la sección inferior tenemos la opción de subir el archivo .war, dando click en el botón Examinar, seleccionamos nuestro archivo .war y luego simplemente lo Desplegamos en el botón respectivo, tardara un poco en subirlo.

Ahora el siguiente paso es activarlo en la sección mas arriba donde están las Aplicaciones, dando click en el botón Activar y debe quedar el geoserver en «true», así:

Si al activar esta la columna Ejecutándose en true hemos terminado y nuestro Geoserver esta funcionando!!

Finalmente podemos ingresar con la siguiente URL:

http://localhost:8080/geoserver/web/

y veremos al Geoserver funcionando:

Bien! espero esto haya sido útil con paciencia se puede lograr hacerle funcionar perfectamente. estaré haciendo mas tutoriales que expliquen como subir los mapas al Geoserver.

Si usas esta información por favor cita la fuente; aunque todo mantiene copyleft respetar el trabajo de los demás es importante.

Ejemplos prácticos

Estos ejemplos son con el fin de demostrar el funcionamiento en mi servidor local he subido tres capas de líneas, puntos.. el próximo tutorial tratare de explicar como subir datos al servidor.

Y para demostrar que es posible trabajar con mapas que hemos generado para OSM, una muestra de la ciudad de Guaranda.