Documentos de Académico
Documentos de Profesional
Documentos de Cultura
configuración del
sistema
Proyectos
Asistencia Técnica Especializada para el Desarrollo e Implantación de un Sistema de
Información
Geográfica (GIS) Corporativo para Nueve Empresas Hidrogeológicas Regionales
N° HVEN-PRAC-CC-NN-17-0011
1
1 CONTENIDO
1 CONTENIDO ........................................................................................................................ 2
2 INTRODUCCIÓN .................................................................................................................. 6
5 CONFIGURACIÓN .............................................................................................................. 11
5.1 POSTGRESQL + POSTGIS ..................................................................................................... 11
5.1.1 INCREMENTAR EL NÚMERO DE CONEXIONES A LA BASE DE DATOS ....................................................... 11
5.1.2 CREACIÓN Y RESTAURACIÓN DE LAS BASES DE DATOS DEL SISTEMA (HIDROVEN_DATOS E HIDROSGC)........ 11
5.2 APACHE TOMCAT ............................................................................................................... 12
5.2.1 USUARIO PARA LA APLICACIÓN MANAGER ...................................................................................... 12
5.2.2 INSTALACIÓN DEL DRIVER PARA POSTGRESQL................................................................................. 12
5.2.3 PUERTOS DE ESCUCHA ................................................................................................................ 13
5.3 GEOSERVER ...................................................................................................................... 13
5.3.1 SEGURIDAD............................................................................................................................... 13
5.3.2 WORKSPACES............................................................................................................................ 13
5.3.3 DATASTORES ............................................................................................................................. 13
5.3.4 LAYERS..................................................................................................................................... 14
5.3.5 LAYER GROUPS .......................................................................................................................... 14
5.3.6 SIMBOLOGÍA ............................................................................................................................. 15
2
5.4 APACHEDS ....................................................................................................................... 15
5.4.1 CONEXIÓN CON EL SERVIDOR ....................................................................................................... 15
5.4.2 CONFIGURACIÓN DE LAS PARTICIONES ........................................................................................... 17
5.4.3 IMPORTACIÓN DEL FICHERO LDIF BASE CON USUARIOS Y ROLES DEL SISTEMA ....................................... 19
5.4.4 GESTIÓN DE ROLES EN EL SERVIDOR LDAP ..................................................................................... 22
5.4.5 GESTIÓN DE USUARIOS EN EL SERVIDOR LDAP ................................................................................ 22
3
• Introducción
• Hardware mínimo aconsejado
• Instalación del software base
o Java JDK
o PostgreSQL + PostGIS
o Apache Tomcat
▪ Instalación en Linux - Debian Strecth 9
▪ Instalación en Windows
▪ Verificación de la instalación
o Geoserver
o ApacheDS
o Otros componentes opcionales
▪ pgAdmin
▪ Apache Directory Studio
• Configuración
o PostgreSQL + PostGIS
▪ Incrementar el número de conexiones a la base de datos
▪ Creación y restauración de las bases de datos del sistema (hidroven_datos e
hidrosgc)
• hidroven_datos
• hidrosgc
o Apache Tomcat
▪ Usuario para la aplicación manager
▪ Instalación del driver para PostgreSQL
▪ Puertos de escucha
o Geoserver
▪ Seguridad
▪ Workspaces
▪ Datastores
▪ Layers
▪ Layer groups
▪ Simbología
4
o ApacheDS
▪ Conexión con el servidor
▪ Configuración de las particiones
▪ Importación del fichero LDIF base con usuarios y roles del sistema
▪ Gestión de roles en el servidor LDAP
• Crear un nuevo rol
• Eliminar un rol existente
▪ Gestión de usuarios en el servidor LDAP
• Crear un nuevo usuario
• Modificar la clave de un usuario existente
• Eliminar un usuario existente
• Asignar un rol a un usuario del sistema
• Instalación del sistema
o Servidor
o Cliente
• Configuración del sistema
o Servidor
o Cliente
▪ Configuración general de rutas y acceso al servidor
▪ Generación del proyecto base para cada módulo
• Crear un proyecto base desde cero
• Crear un proyecto base usando uno ya existente en la bbdd del sistema
• Crear un proyecto base a partir de un proyecto plantilla genérico
• Verificación de la instalación
o Autenticación
• Preguntas frecuentes (F.A.Q)
5
2 INTRODUCCIÓN
El objetivo del presente documento es describir de manera pormenorizada los pasos necesarios
para la instalación y configuración de la solución de la UTE GISA para Hidroven.
6
3 HARDWARE MÍNIMO ACONSEJADO
• RAM>= 10Gb
• Procesador >= Intel Core i5-5675R @ 3.10GHz (ejemplo servidor medio/básico)
• Disco >= 50 Gb, preferible SSD
• Tarjeta Red
7
4 INSTALACIÓN DEL SOFTWARE BASE
En este apartado se comentarán los diferentes componentes que deben instalarse en el equipo que
hará de servidor del sistema.
Sistema operativo
El sistema operativo del equipo servidor determinará los pasos concretos para la instalación
de cada uno de los componentes de software base. No es posible definir los pasos concretos
para todas las posibilidades existentes, por lo que se comentarán sólo los pasos genéricos y,
en algunos casos, los pasos concretos encontrados. Para determinar los pasos concretos a
seguir en el sistema operativo anfitrión, es necesario buscar las guías correspondientes a
través de Internet.
Se muestra a continuación una tabla resumen con las versiones mínimas y recomendadas de cada
uno de los componentes del software base que deben instalarse:
8
4.1 JAVA JDK
Los binarios para la instalación de Java en el servidor pueden obtenerse en la página
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
En los sistemas operativos donde no esté disponible, es posible también hacer uso de
OpenJDK como máquina virtual de Java del sistema
4.4 GEOSERVER
Para la instalación de Geoserver se deben seguir los pasos indicados a continuación:
1. Descargar la versión war de Geoserver de la página oficial http://geoserver.org/download/
(versión estable actual → 2.14.2)
9
2. Descomprimir el fichero geoserver-2.14.war.zip
3. Mediante el manager de Tomcat, desplegar el war directamente
Si todo es correcto se podrá acceder al servidor en la dirección http://localhost:8080/geoserver/
4.5 APACHEDS
4.6.1 PGADMIN
La aplicación "pgAdmin" facilita el trabajo con el gestor de bases de datos PostgreSQL.
Los binarios para la instalación de pgAdmin están disponibles en la página
https://www.pgadmin.org/download/.
10
5 CONFIGURACIÓN
a
o max_connections = 200
o shared_buffers = 80MB
3. Reiniciar el servidor PostgreSQL.
5.1.2.1 HIDROVEN_DATOS
Se debe crear una base de datos "hidroven_datos" y restaurar el fichero de backup correspondiente
que se vaya a usar para el sistema. Si no se quiere partir de un backup ya existente, puede usarse
como base el backup "semilla" disponible en la ruta
http://www.kosmoland.es/public/clientes/hidroven/instalacion/bbdd/hidroven_datos_semilla.ba
ckup (en este backup no existen datos de la red, tan sólo las capas genéricas de cartografía y las
tablas maestras).
11
5.1.2.2 HIDROSGC
Si no se dispone de acceso a la base de datos del sistema comercial, se dispone de un backup para
restaurar que permite emular dicha base de datos en la dirección
http://www.kosmoland.es/public/clientes/hidroven/instalacion/bbdd/hidrosgc.backup
Se debe crear una base de datos "hidrosgc" y restaurar el fichero de backup anterior (solo si no se
puede acceder al sistema comercial)
Driver PostgreSQL
12
El fichero está disponible en la ruta
http://www.kosmoland.es/public/clientes/hidroven/instalacion/apache_tomcat/postgresql-
42.2.2.jar
5.3 GEOSERVER
5.3.1 SEGURIDAD
Se deben modificar las contraseñas maestras y del usuario admin de Geoserver a una adecuada (p.e.
inorca_saig_2018)
5.3.2 WORKSPACES
Se deben eliminar todos los workspaces que se incluyen por defecto en la instalación y crear un
nuevo workspace gis.inorca.es
5.3.3 DATASTORES
Se debe crear un nuevo datastore por cada uno de los esquemas con capas de la bbdd:
• hidroven_datos_acometidas
• hidroven_datos_auxiliares
• hidroven_datos_cartografia_base
• hidroven_datos_cartografia_urbana
• hidroven_datos_red_abastecimiento
• hidroven_datos_red_saneamiento
13
5.3.4 LAYERS
Se debe crear una capa por cada una de las tablas geométricas del modelo:
• Datastore hidroven_datos_acometidas
o Acometidas (acometidas_tuberias)
o Nudos de acometidas (acometidas_nudos)
• Datastore hidroven_datos_auxiliares
o Acotaciones (acotaciones)
• Datastore hidroven_datos_cartografia_base
o Estados (estados)
o Municipios (municipios)
o Parroquias (parroquias)
o Centros poblados (centros_poblados)
o Hidrografías (hidrografias)
• Datastore hidroven_datos_cartografia_urbana
o Sectores (sectores)
o Manzanas (manzanas)
o Lotes (lotes)
o Lotes - Temáticos (lotes_tematicos)
o Puntos - Órdenes de trabajo (puntos_trabajos)
o Vías (vias)
o Vías - Informe (vias_informe)
• Datastore hidroven_datos_red_abastecimiento
o Nudos de abastecimiento (nudos_abastecimiento)
o Tuberías de abastecimiento (tuberias_abastecimiento)
• Datastore hidroven_datos_red_saneamiento
o Nudos de saneamiento (nudos_saneamiento)
o Tuberías de saneamiento (tuberias_saneamiento
14
• Cartografía urbana → Capas Sectores, Manzanas, Lotes y Vías
• Red de abastecimiento → Capas Nudos de abastecimiento y Tuberías de abastecimiento
• Red de saneamiento → Capas Nudos de saneamiento y Tuberías de saneamiento
5.3.6 SIMBOLOGÍA
Para cada una de las capas generadas en el punto correspondiente, aplicar la simbología deseada.
5.4 APACHEDS
Para la configuración del servidor de LDAP se usará la herramienta "Apache Directory Studio"
comentada en un punto anterior.
15
3. En la pestaña "Autenthication", configurar el usuario (1) y la clave de acceso (2) al servidor
ApacheDS (por defecto la contraseña del usuario admin del servidor es "secret"):
16
4. Pulsar el botón "Apply and close" para guardar los cambios
17
2. Crear la partición para el proyecto Hidroven (o=hidroven):
18
3. Reiniciar el servidor LDAP
19
2. Seleccionar el fichero LDIF a importar (1) , activar el log (2) y pulsar el botón "Finish" (3):
20
3. Una vez terminado el proceso de importación debemos obtener un árbol de usuarios y roles
similar al siguiente:
21
Los usuarios que se crearán por defecto con la importación son los siguientes:
22
5.4.5.4 ASIGNAR UN ROL A UN USUARIO DEL SISTEMA
// TODO
23
6 INSTALACIÓN DEL SISTEMA
6.1 SERVIDOR
Para la instalación del servidor, se debe desplegar el fichero hidroven_server.war a través de la
aplicación manager de Apache Tomcat.
Si todo es correcto se debe poder acceder al sistema a través de la dirección
http://localhost:8080/hidroven_server
6.2 CLIENTE
En cada uno de los equipos clientes se debe instalar la versión 3.X de QGIS. Se pueden acceder a los
binarios de QGIS en la página https://qgis.org/es/site/forusers/download.html.
Se recomienda la instalación de las versiones estables de la rama 3.X (en este momento, la versión
3.6.X)
Una vez instalado e iniciado QGIS, se deben instalar los módulos del sistema correspondientes
siguiendo los pasos detallados en el manual del cliente GIS. Como mínimo debe instalarse el módulo
"Común", el resto se instalarán según el perfil del usuario del sistema que vaya a hacer uso del
mismo.
24
7 CONFIGURACIÓN DEL SISTEMA
7.1 SERVIDOR
La configuración establecida en el hidroven_server.war desplegado por defecto puede no ser
correcta. Para establecer los parámetros correctos deben modificarse las siguientes propiedades en
los ficheros indicados, con el servidor Apache Tomcat parado:
• Fichero WEB-INF/classes/application.properties (se indican entre <> los valores que habría que
comprobar y modificar si fuesen necesarios)
# ####################################################################
# ##################### CONFIGURACIÓN BBDD GIS #######################
# ####################################################################
.....
.....
# #########################################################################
# ##################### CONFIGURACIÓN BBDD COMERCIAL ######################
# #########################################################################
.....
.....
25
# ##################################################################
# ##################### CONFIGURACIÓN BBDD BI ######################
# ##################################################################
.....
.....
# #####################################################################
# ##################### CONFIGURACIÓN SEGURIDAD #######################
# #####################################################################
.....
.....
security.ldap_url=ldap://<host_servidor_apacheds>:10389/o=hidroven
security.ldap_base_path=o=hidroven
security.ldap_manager_dn=uid=admin,ou=system
security.ldap_manager_password=secret
.....
# #########################################################################
# ##################### CONFIGURACIÓN SERVICIOS WMS #######################
# #########################################################################
wms-server-type=geoserver
informes-poligono-corte-peticion-wms-
general=<url_peticion_wms_para_poligono_corte_seccion_general>
informes-poligono-corte-peticion-wms-
valvula=<url_peticion_wms_para_poligono_corte_valvulas>
informes-poligono-corte-peticion-wms-valvula-
etq=<url_peticion_wms_para_poligono_corte_valvulas_etiquetas>
informes-perfil-peticion-wms-general=<url_peticion_wms_para_perfil>
incidencias-url=<url_peticion_sistema_incidencias_hidrosgc>
Una vez se hayan modificado las propiedades deseadas, es necesario reiniciar el servidor
26
7.2 CLIENTE
27
7.2.2.1 CREAR UN PROYECTO BASE DESDE CERO
Para generar un proyecto base desde cero para el módulo deseado se deben seguir los pasos
indicados a continuación:
1. Pulsar sobre el botón "Nuevo proyecto":
3. Pulsar sobre el apartado SRC (1), filtrar por el código EPSG de nuestra zona de trabajo (2),
seleccionar el código EPSG correcto (3) y pulsar el botón "Aceptar" (4):
28
4. Crear los grupos y subgrupos deseados para alojar las distintas capas:
5. Incluir en cada grupo/subgrupo las capas WMS de referencia deseadas, a partir de las existentes
en la instalación de Geoserver que hayamos realizado:
29
6. Una vez añadidas todas las capas, guardar el proyecto y subirlo al módulo correspondiente
usando la herramienta "Enviar proyecto" del módulo deseado.
30
http://www.kosmoland.es/public/clientes/hidroven/instalacion/proyecto_base/proyecto_base.qg
s
Se debe modificar el mismo para adaptar la URL de la instalación de Geoserver a la que hayamos
realizado. Para ello, abrir el fichero descargado con un editor de texto y reemplazar todas las
ocurrencias de la cadena "http://localhost:8080/" por la URL definitiva de nuestro servidor. Una vez
realizada la modificación, se debe cargar el proyecto en QGIS y subir al sistema con la herramienta
"Enviar proyecto" del módulo donde queramos establecer el proyecto como proyecto base.
31
8 VERIFICACIÓN DE LA INSTALACIÓN
8.1 AUTENTICACIÓN
Desde el cliente, intentar autenticarse contra el servidor instalado con la herramienta "Iniciar
sesión" del módulo Común usando el par usuario / contraseña del administrador del sistema por
defecto (admin / a):
32
9 PREGUNTAS FRECUENTES (F.A.Q)
// TODO
33