Manual de Administración de MapGUI

MapGUI
Manual de Administración de MapGUI
Tafyesa S.L ● www.tafyesa.com
Parque Tecnológico Walqa, Edif. III,
Ctra. Zaragoza, N330A, Km 566, 22197 Cuarte, Huesca ● España
[email protected] ● T: +34 974 242 276 ● F: +34 974 238 477
Índice de contenido
1 Manual de Administración............................................................................................................ 1
1.1 Introducción.......................................................................................................................... 1
1.2 Estructura de este manual....................................................................................................1
1.3 Obtención del Software.........................................................................................................2
1.4 Servidor de aplicaciones.......................................................................................................2
1.5 Instalación de la aplicación Web...........................................................................................4
1.6 Configuración de la base de datos........................................................................................6
1.7 Acceso de las aplicaciones a la base de datos.....................................................................7
1.8 Prueba de funcionamiento....................................................................................................9
1.9 Utilización de los usuarios demo.........................................................................................10
1.10 Carga de datos en la base de datos.................................................................................13
1.11 Creación de un nuevo usuario..........................................................................................13
1.12 Creación de estaciones.....................................................................................................14
1.13 Operaciones asociadas a cada elemento.........................................................................15
1.14 Capas complementarias de servidores de mapas............................................................17
1.15 Elementos de configuración..............................................................................................18
MapGUI
Manual de Administración de MapGUI
1 Manual de Administración
1.1 Introducción
El presente documento constituye la primera versión del manual de administración del proyecto
MapGUI. Se plantea como punto de partida para que los administradores de la herramienta puedan
realizar las las principales tareas de instalación, configuración y despliegue del proyecto.
Los siguientes apartados tratarán cada uno de los las tareas necesarias para desplegar una instancia
de un servicio MapGUI.
1.2 Estructura de este manual
Antes de comenzar a trabajar con este manual se recomienda revisar el Manual de Usuario de la
Aplicación.
El manual está estructurado en los siguientes apartados:
1. Obtención del Software (MapGUI).
2. Instalación del servidor de aplicaciones Web (Apache Tomcat).
3. Despliegue del Software obtenido en [1] en el servidor de aplicaciones Web [2].
4. Instalación del sistema gestor de bases de datos (MySQL).
5. Creación de la base de datos de demostración (demo).
6. Configuración del conector entre la aplicación Web [3] y la base de datos demo [5] (JDBC).
Una vez presentadas las tareas de administración se explicarán las indicaciones básicas para la
administración de usuarios y recursos de la herramienta:
1. Creación de usuarios.
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
1 ● 21
MapGUI
Manual de Administración de MapGUI
2. Creación de estaciones o elementos.
3. Creación de operaciones.
4. Creación de capas adicionales de servicios de mapas adicionales.
5. Parámetros de configuración de la aplicación.
Los siguientes apartados de este manual de administración desarrollan cada uno de los puntos
mencionados en este resumen.
1.3 Obtención del Software
El software se distribuye en formato WAR (Web Application Archive) para facilitar su despliegue.
La última versión de la herramienta puede obtenerse en la página del proyecto MapGUI en
SourceForge, accediendo a la sección de ficheros del proyecto:
•
http://sourceforge.net/projects/mapgui/files/
Además del formato WAR también puede obtenerse el fichero en los siguientes formatos:
•
MapGUI.war
•
MapGUI.zip
•
MapGUI.tar.gz
Todos los paquetes contienen los componentes necesarios para poder desplegar la aplicación.
1.4 Servidor de aplicaciones
El primer paso en la administración de servicios para MapGUI consiste en desplegar el paquete de la
herramienta en un servidor de aplicaciones Java con soporte básico para Servlets. El presente manual
presenta las indicaciones para el caso de un servidor de aplicaciones web Apache Tomcat 6.
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
2 ● 21
MapGUI
Manual de Administración de MapGUI
Puede obtenerse la última versión disponible de Apache Tomcat 6 en:
•
http://tomcat.apache.org/download-60.cgi
Una vez descargado el servidor de aplicaciones, es necesario establecer los permisos y usuarios
necesarios para poder realizar el despliegue. El fichero de configuración para establecer estos
parámetros es:
•
/opt/MapGUI/apache-tomcat-6.0.37/conf/tomcat-users.xml
A continuación se muestra un ejemplo de configuración del fichero:
Fichero de configuración tomcat­users.xml
<?xml version="1.0" encoding="UTF­8"?> <tomcat­users> <role rolename="manager"/> <role rolename="admin"/> <user password="MapGUI" roles="manager,admin" username="admin"/> </tomcat­users> Una vez instalado el servidor de aplicaciones se pueden realizar las siguientes pruebas para confirmar
el correcto funcionamiento de Tomcat:
Pruebas de funcionamiento de Tomcat
# inicio del servicio
/opt/tomcat/bin/startup.sh
# parada del servicio
/opt/tomcat/bin/shutdown.sh
# log del servicio
tail ­f /opt/tomcat/logs/catalina.out
# acceso al servicio
http://localhost:8080/
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
3 ● 21
MapGUI
Manual de Administración de MapGUI
1.5 Instalación de la aplicación Web
Una vez en funcionamiento el servidor de aplicaciones podemos utilizar las herramientas de despliegue
de ficheros WAR accediendo el servicio de Tomcar de administración:
Tomcat Manager ­ http://localhost:8080/manager/html/
Se utilizará el despliegue de aplicaciones basado en ficheros WAR:
Tomcat Manager – Desplegando la aplicación
Una vez realizado el despliegue la nueva aplicación MapGUI deberá aparecer en la lista de aplicaciones
web disponibles
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
4 ● 21
MapGUI
Manual de Administración de MapGUI
MapGUI Desplegado
Una vez desplegado MapGUI puede comprobarse su funcionamiento en:
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
5 ● 21
MapGUI
Manual de Administración de MapGUI
http://localhost:8080/MapGUI/index_map.html
Finalizada la instalación de la aplicación todavía no es posible utilizar el servicio ya que no existe un
servicio de base de datos disponible.
1.6 Configuración de la base de datos
Aunque pueden utilizarse múltiples sistemas gestores de bases de datos, en este manual, se utilizará
como referencia el sistema gestor de bases de datos MySQL Server.
Para facilitar la creación inicial de un modelo de base de datos para la aplicación se ofrecen ficheros de
ejemplo que permiten crear rápidamente una base de datos con la que comenzar a trabajar. Los
ficheros son:
•
db/demo/MapGUI-demo-db.sql
•
db/demo/MapGUI-demo-db-data.sql
El primer fichero contiene las definiciones necesarias para la creación de las tablas y su estructura en la
base de datos, utilizando como base de datos de referencia “MapGUI”. El segundo, contiene la misma
información de diseño pero carga las tablas con valores iniciales que permite comenzar a utilizar la
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
6 ● 21
MapGUI
Manual de Administración de MapGUI
aplicación con valores de ejemplo creando un entorno funcional para iniciar el uso de la herramienta.
Para cargar los ficheros en MySQL puede utilizarse cualquier entorno de gestión, a continuación se
muestran a modo de ejemplo, los comandos más importantes que pueden utilizarse:
Creación de la base de datos
mysql ­u admindb ­p < db/demo/MapGUI­demo­db­data.sql
A continuación se muestras las tablas de la base de datos que deben haberse creado y usuarios para el
entorno demo:
Tablas y usuario demo creados
1.7 Acceso de las aplicaciones a la base de datos
Una vez se ha comprobado que la base de datos ha sido creada correctamente y que contamos con
valores, en los ejemplos anteriores los del entorno de demostración, cargados; es necesario configurar
el acceso de las aplicaciones Web a la base de datos.
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
7 ● 21
MapGUI
Manual de Administración de MapGUI
Para ello y por motivos de seguridad es necesario crear un nuevo usuario que gestione el acceso de las
aplicaciones a la base de datos “MapGUI”. A continuación se muestra los comandos que permiten
realizar esta tarea:
Creación un usuario para acceso a la base de datos
CREATE USER 'MapGUI'@'localhost' IDENTIFIED BY '***'; GRANT USAGE ON * . * TO 'MapGUI'@'localhost' IDENTIFIED BY '***' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ; GRANT ALL PRIVILEGES ON `MapGUI` . * TO 'MapGUI'@'localhost';
Para finalizar a la configuración, es necesario actualizar estos datos de acceso en el contexto
de la aplicación Web.
Modificaciones en el contexto de la aplicación Web
/opt/tomcat/webapps/MapGUI/META­INF/context.xml <Context path="/tafyesa" debug="5" reloadable="true" crossContext="true"> <Resource auth="Container" type="javax.sql.DataSource" name="jdbc/MapGUI" username="MapGUI" password="MapGUI" url="jdbc:mysql://localhost:3306/MapGUI" driverClassName="com.mysql.jdbc.Driver" removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true" maxActive="100" maxIdle="50" validationQuery="SELECT 1" testOnBorrow="true" testWhileIdle="true" timeBetweenEvictionRunsMillis="10000" minEvictableIdleTimeMillis="60000" /> </Context> Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
8 ● 21
MapGUI
Manual de Administración de MapGUI
En el ejemplo anterior, se han señalado los valores modificados para establecer la configuración de
usuario, credenciales y tipo de base de datos en el ejemplo de configuración que tratamos.
1.8 Prueba de funcionamiento
Llegados a este punto podemos podemos asumir que se han realizado las siguientes tareas:
1. Servidor de aplicaciones instalado.
2. Aplicación MapGUI.war desplegada en el servidor de aplicaciones.
3. Sistema gestor de bases de datos instalado.
4. Creación de la base de datos de demostración.
5. Conector entre las aplicaciones Web y la base de datos.
Para verificar que todos los procesos anteriores se han completado correctamente podemos realizar la
carga inicial de la configuración de la aplicación y los resultados mostrará la carga inicial de parámetros
con sus valores por defecto:
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
9 ● 21
MapGUI
Manual de Administración de MapGUI
Prueba en la carga inicial de parámetros
http://localhost:8080/MapGUI/ActivarParametros
Puesto que estos parámetros son los iniciales y han sido obtenidos por una de las aplicaciones Web
(ActivarParametros) de la base de datos MapGUI podemos concluir que el proceso de instalación ha
terminado correctamente y utilizar los usuarios demo tal y como se muestra en el siguiente apartado.
1.9 Utilización de los usuarios demo
El entorno de demostración de la aplicación está formado por dos usuarios con las siguientes
credenciales:
•
demo – demo
•
demo1 - demo1
A continuación se muestra el entorno de cada uno de estos usuarios:
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
10 ● 21
MapGUI
Manual de Administración de MapGUI
Entorno de usuario demo y demo1
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
11 ● 21
MapGUI
Manual de Administración de MapGUI
Descripción del usuario demo:
•
•
Dos capas base:
◦
IDEE (http://www.idee.es/)
◦
CARTOCIUDAD (http://www.cartociudad.es)
Una capa de servidor de mapas complementaria
◦
•
CATASTRO (http://www.catastro.meh.es/eng/wms.asp)
Dos capas de operaciones
Capa Demo Operaciones 1
◦
Un elemento de operación (marca verde)
Tres operaciones para cada uno de los elementos
Capa Demo Operaciones 2
◦
Un elemento de operación (marca azul)
Tres operaciones para cada uno de los elementos
Descripción del usuario demo1:
•
Una capa base: OpenStreetMaps (http://www.openstreetmap.org)
•
Dos capas de operaciones
Capa operaciones Grupo – 1
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
12 ● 21
MapGUI
Manual de Administración de MapGUI
◦
Tres elementos de operación (marcas azules)
Tres operaciones para cada uno de los elementos
Capa operaciones Grupo – 2
◦
Dos elementos de operación (marcas verdes)
Tres operaciones para cada uno de los elementos
En los siguientes apartados se explicarán las principales tareas de administración y configuración de
usuarios y su entorno de aplicación, tomando como referencia este entorno de demostración.
1.10 Carga de datos en la base de datos
Para cargar los valores de usuario en la base de datos, puede utilizarse cualquier entorno de gestión y
administración de sistemas gestores de base de datos. En los ejemplos tratados en este manual se
utilizará la carga de valores basada en XML para facilitar estandarización y posibles integraciones con
otros proyectos.
1.11 Creación de un nuevo usuario
En la siguiente tabla se muestra un ejemplo de creación de usuario y se presentan las explicaciones
necesarias para cada uno de los valores registrados
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
13 ● 21
MapGUI
Manual de Administración de MapGUI
Creación de un usuario
<!­­ Table Usuario ­­> <table name="Usuario"> <column name="nombre_usuario">demo</column> <column name="clave">fe01ce2a7fbac8fafaed7c982a04e229</column> <column name="lon">­0.40917</column> <column name="lat">42.14195</column> <column name="zoom">10</column> <column name="zoom_max">15</column> <column name="op_map">
{ controls:[
new OpenLayers.Control.Navigation(),
new OpenLayers.Control.PanZoomBar(),
new OpenLayers.Control.LayerSwitcher(),
new OpenLayers.Control.Attribution(),
new OpenLayers.Control.MousePosition({element: $('pie2')})],
units: 'degrees',
projection: new OpenLayers.Projection("EPSG:4326"),
displayProjection: new OpenLayers.Projection("EPSG:4326")
}
</column> </table>
Descripción de los campos utilizados:
•
nombre_usuario. Nombre del usuario (login).
•
clave. Password del usuario codificado en MD5.
•
lon, lat. Posición inicial, centro, del mapa que se visualizará al iniciar sesión el usuario.
•
zoom. Zoom inicial en el mapa al iniciar sesión el usuario.
•
zoom_max. Máximo zoom permitido para el usuario.
•
op_map. Aquellos controles que el administrador considere oportuno indicar respecto a la
conguración de OpenLayers. En el ejemplo utilizado, el administrador está definiendo las
siguientes indicaciones: barra de navegación, componente de Zoom para el usuario, etc. El
resto de opciones disponibles pueden consultarse en la documentación del proyecto
OpenLayers:
◦
http://trac.osgeo.org/openlayers/wiki/Documentation
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
14 ● 21
MapGUI
Manual de Administración de MapGUI
Una vez definidos los valores básicos del usuario (nombre, pass, punto inicial de mapas, zoom y
componentes de OpenLayers) será necesario crear el resto de componentes:
•
Capas para los servicios de mapas
•
Estaciones
•
Capas para los grupos de elementos
1.12 Creación de estaciones
En la siguiente tabla se muestra un ejemplo de creación de una estación y se presentan las
explicaciones necesarias para cada uno de los valores registrados.
Creación de una estación
<!­­ Table Estacion ­­> <table name="Estacion"> <column name="id_e">101</column> <column name="alias">Nombre de la estación 100</column> <column name="lon">­0.40844</column> <column name="lat">42.14232</column> </table>
Descripción de los campos utilizados:
•
id_e. Identificador numérico para la estación.
•
alias. Texto que representa el nombre de la estación.
•
lon, lat. Posición de la estación
Habiendo definido las estaciones o elementos que pueden utilizar los usuarios, el siguiente paso
consistirá en definir cuales son las operaciones que tiene cada elemento o estación y cómo deben
organizarse en capas del mapa.
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
15 ● 21
MapGUI
Manual de Administración de MapGUI
1.13 Operaciones asociadas a cada elemento
En la siguiente tabla se muestra un ejemplo la asociación de operaciones a cada estación (elemento) y
se presentan las explicaciones necesarias para cada uno de los valores registrados.
Asociación de operaciones a cada elemento
<!­­ Table usuario_tiene_estaciones_operaciones ­­> <table name="usuario_tiene_estaciones_operaciones"> <column name="usuario">demo</column> <column name="texto">
<link rel='stylesheet' href='popup.css'><a href='http://www.tafyesa.com' target='_blank'>Operación 1</a></br><a href='http://www.tafyesa.com' target='_blank'>Operación 2</a></br><a href='http://www.tafyesa.com' target='_top'>Operación 3</a></column> <column name="capa_estaciones">Capa Demo Operaciones 2</column> <column name="lon">­0.40906</column> <column name="lat">42.14065</column> <column name="iconos_imagen">js/img/marker­blue.png</column> <column name="iconos_tam_x">15</column> <column name="iconos_tam_y">15</column> <column name="size_popups_x">300</column> <column name="size_popups_y">100</column> <column name="id_e">101</column> </table>
Descripción de los campos utilizados:
•
usuario. Identificador del usuario.
•
texto. Código HTML en el que se indica el acceso a las operaciones que podrá realizar el
usuario.
•
capa_estaciones. Capa, representando el grupo de estaciones a la que pertenece el elemento o
estación.
•
lon – lat. Posición en el mapa.
•
iconos_imagen. Imagen asociada al elemento.
•
iconos_tam_x, iconos_tam_y. Tamaño y posición de la imagen asociada al elemento.
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
16 ● 21
MapGUI
Manual de Administración de MapGUI
•
size_popups_x, size_popups_y. Dimensiones de la ventana en la que se presentan las
operaciones.
•
id_e. Identificador de la estación.
Habiendo definido las estaciones o elementos que pueden utilizar los usuarios, el siguiente paso
consistirá en definir las operaciones asociadas a ese elemento.
1.14 Capas complementarias de servidores de mapas
Aunque no es estrictamente necesario, ya que ya se ha definido una capa base para el usuario,
podemos agregar servicios de mapas adicionales.
En la siguiente tabla se muestra un ejemplo según el cual añadiremos un nuevo servicio de mapas al
usuario demo. Los datos del nuevo servicio son:
•
Servidor de mapas: SITAR (http://sitar.aragon.es). Plataforma de información sobre el territorio
de la Comunidad Autónoma de Aragón.
•
URL del WMS: http://sitar.aragon.es/AragonWMS
•
Capas disponibles en el servicio que se utilizarán: Carretera,Comarca.
•
Otros parámetros a tener en cuenta para la utilización del servidor de mapas:
•
◦
format: 'image/png'
◦
projection: 'EPSG:4326'
Se incluirá como capa adicional y no como capa base.
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
17 ● 21
MapGUI
Manual de Administración de MapGUI
Creación de una capa adicional con un servicio de mapas
SITAR
<table name="usuario_tiene_capas"> <column name="url">http://sitar.aragon.es/AragonWMS</column> <column name="parametro">
{ layers: 'Carretera,Comarca',
format: 'image/png',
transparent:true,
projection: 'EPSG:4326' }
</column> <column name="opcion">{ isBaseLayer:false }</column> <column name="usuario">demo</column> <column name="nombre">SITAR</column> </table>
A continuación se muestra el resultado de registrar esta nueva capa:
Servicio SITAR incluido en el usuario demo
1.15 Elementos de configuración
Por último, la base de datos permite almacenar varios elementos que permiten personalizar el
funcionamiento de la aplicación tanto en parámetros tecnológicos como aspectos de presentación.
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
18 ● 21
MapGUI
Manual de Administración de MapGUI
La tabla “Parametros” incluye un campo “descripción” que ofrece información sobre el significado de
cada uno de los parámetros de configuración utilizados.
IMPORTANTE:
Es importante destacar que una vez iniciado el servicio por primera vez o cuando se han realizado
modificaciones en los valores de esta tabla, es necesario ejecutar la siguiente aplicación Web para que
los cambios tengan efecto o, en el caso de iniciar la herramienta, para cargar los valores iniciales:
http://localhost:8080/MapGUI/ActivarParametros
Ref.: Manual de Administración MapGUI
Memoria Técnica / La Información contenida en este documento es confidencial
Tafyesa S.L ● www.tafyesa.com ● 28/10/2013
19 ● 21