Los usuarios de las aplicaciones JMap pueden generar ciertos datos que son almacenados en el entorno de JMap Server.
Estos datos son de naturaleza variada tales como las preferencias del usuario (selección de unidades, parámetros de impresión, etc.), los contextos cartográficos (JMap Pro, JMap Web y JMap NG) y las plantillas de impresión personalizadas (JMap Pro).
Los datos de los contextos cartográficos se almacenan en formato JSON en la tabla JMAP_CONTEXTS de la base de datos System.
Los otros datos se almacenan en distintas carpetas para cada usuario. El directorio de las carpetas de los usuarios es:
(JMap_Home)\workspaces<username>
Note que este directorio puede ser localizado en otro lugar, especificando un directorio diferente en la línea server.workspaces.path del archivo jmapserver.properties y copiando manualmente los archivos y subdirectorios.
En ciertos casos el administrador puede tener que copiar ciertos archivos, cuando se efectúan migraciones o se comparten con los archivos de otros usuarios. Las secciones siguientes describen en detalle cada caso.
Las herramientas de exportación e importación de las configuraciones de JMap comprenden también los datos de los usuarios.
Los contextos cartográficos están compuestos por el conjunto de parámetros que permiten que un usuario de aplicaciones JMap Pro, JMap Web o JMap NG recree un mapa. Permiten guardar los mapas y compartirlos con otros usuarios.
Los contextos existentes pueden ser activados fácilmente para recrear un entorno cartográfico. Todos los parámetros de las capas, las anotaciones, las temáticas, las selecciones, etc. forman parte del contexto y se recrean a la apertura del mismo.
Un contexto se asocia al proyecto en el que fue creado. No es accesible a partir de los otros proyectos.
La sección Capas personales ofrece más información sobre la gestión de las capas personales así como detalles sobre el procedimiento para volverlas públicas.
Los datos de las capas personales no se almacenan en el directorio workspaces sino que se almacenan directamente en la base de datos System de JMap Server (hay una tabla por cada capa personal).
Las herramientas de exportación e importación incluyen los datos de las capas personales.
De la misma manera que las capas personales, los datos de las capas editables de los proyectos JMap se almacenan directamente en la base de datos System de JMap Server, en tablas denominadas tablas JMap Spatial.
Las herramientas de exportación e importación incluyen los datos de las tablas JMap Spatial.
Los usuarios de las aplicaciones JMap Pro pueden crear sus plantillas de impresión personales. Los archivos se almacenan en el directorio
(JMap_Home)\workspaces<username>\printLayouts
Usted puede volver públicas las plantillas de impresión creadas por los usuarios. Para ello debe copiarlas en el directorio
JMap_Home)\workspaces\public\printLayouts
Las plantillas públicas están disponibles para todos los usuarios de la aplicación JMap Pro.
Esta sección describe las herramientas para exportar e importar la configuración de JMap Server, los datos de los usuarios así como crear copias de seguridad del servidor.
Su configuración de JMap Server (fuentes de datos espaciales, bases de datos, proyectos, capas, etc.) se almacena en disco en formato binario. Esta configuración sólo es accesible mediante JMap Server y sólo es compatible con su versión en curso (versión principal, por ejemplo Lima).
Al utilizar la herramienta de exportación, se produce una versión texto de esta configuración. Esta configuración exportada puede entonces ser importada de nuevo a JMap Server, e incluso a una nueva versión, con los mismos o distintos parámetros.
A continuación presentamos algunas situaciones en las que puede resultar útil exportar e importar su configuración:
Usted instaló una nueva versión de JMap que implica cambios importantes y desea reutilizar su configuración existente. Puede exportar esta configuración de su versión de JMap e importarla a continuación en la nueva versión de JMap.
Usted administra numerosas instancias de JMap Server y debe desplazar un proyecto de una instancia a otra. Puede efectuar una exportación parcial implicando sólo el proyecto que necesita, e importarlo en la otra instancia.
Debe reproducir su entorno de desarrollo en el entorno de producción. Puede efectuar una exportación completa de su servidor de desarrollo e importarlo al servidor de producción.
Las herramientas de exportación e importación están disponibles seleccionando Importar / Exportar en la sección Herramientas de JMap Admin.
Cuando usted exporta una configuración, debe determinar si desea exportar la configuración entera o sólo recursos específicos (exportación parcial).
Si decide exportar algunos recursos específicos, usted debe determinar si desea exportar bases de datos, fuentes de datos espaciales, proyectos, modelos de estilo o modelos de metadatos.
Existe una relación de dependencia entre estos recursos: los proyectos dependen de las fuentes de datos espaciales y de los modelos de estilo, mientras que las fuentes de datos espaciales pueden depender de las bases de datos. Por lo tanto, si exporta un proyecto, las fuentes de datos espaciales, los modelos de estilo y posiblemente también las bases de datos, serán exportadas también.
Si uno de los proyectos contiene capas por referencia de otro proyecto, usted debe exportar también el proyecto que tiene las capas originales.
El proceso de exportación genera cuatro archivos: el archivo .properties es el archivo de exportación principal y contiene la información de la configuración. Todos los archivos son necesarios para la importación. Usted puede determinar el directorio de destino y el nombre del archivo.
Cuando usted importa una configuración puede elegir importar una configuración completa (importación completa) o solamente una porción de la misma (importación parcial). Sólo puede efectuar una importación completa si los archivos de exportación contienen una exportación completa.
Cuando efectúa una importación completa, toda la configuración existente en JMap Server se suprime y se reemplaza por la configuración importada.
Cuando se termina una importación completa, usted es dirigido automáticamente a la página de conexión de JMap Admin.
Cuando efectúa una importación parcial se presentan situaciones en que los recursos importados ya existen (los nombres son idénticos). En estos casos usted debe indicar a JMap Admin la alternativa que elige: reemplazar el recurso existente o crear uno nuevo con un nombre diferente. Las fuentes de datos que usted importa deben ser actualizadas para poder ser utilizadas.
Si uno de los proyectos que importa contiene capas por referencia de otro proyecto, usted debe importar también el proyecto que tiene las capas originales.
Los datos de los usuarios de JMap comprenden todos los datos que son creados o modificados por los usuarios. Esto incluye las preferencias de los usuarios, los contextos, las capas personales, los datos de las capas editables JMap, etc. La sección Datos de los usuarios presenta más detalles de este tema.
Si usted cambia de instancia de JMap Server y desea conservar todos los datos de los usuarios, debe exportarlos del antiguo servidor e importarlos al nuevo servidor.
El archivo de configuración de la exportación e importación de los datos de los usuarios es un archivo .properties.
Para que la exportación e importación sean exitosas, debe validar que este archivo contiene la línea siguiente:
project.id.ID_OF_THE_PROJECT_BEFORE_EXPORT=ID_OF_THE_PROJECT_AFTER_EXPORT_SERVER_CONFIGURATION.
Cuando exporta los datos de usuarios, debe elegir entre exportar la totalidad de los datos, solamente las capas editables almacenadas en JMap (incluidas las capas personales) o solamente los espacios de trabajo (que incluyen los contextos, las preferencias de los usuarios, etc.).
Cuando importa los datos de los usuarios, pueden presentarse situaciones en las que los recursos importados ya existen (hay nombres idénticos). En esos casos debe indicar a JMap la alternativa a seguir: reemplazar el recurso existente por el importado o crear un nuevo recurso con un nombre diferente.
Durante las exportaciones e importaciones de configuraciones de JMap, los ID del proyecto cambian y esto tiene un impacto considerable en los datos del usuario, como los contextos asociados con un proyecto en particular.
Para resolver el problema, puede crear un archivo .mapping que establezca una correspondencia entre los ID antiguos y nuevos de cada proyecto. El siguiente texto detalla el procedimiento a seguir.
Desde el antiguo servidor JMap:
Exporte la configuración de JMap Server.
Exporte la configuración de datos de usuarios.
En el nuevo servidor JMap:
Importe la configuración del servidor JMap.
Tome nota del ID de cada proyecto en el servidor antiguo.
Tome nota del ID de cada proyecto en el nuevo servidor.
Cree un (1) archivo .mapping con la correspondencia para cada proyecto entre el ID antiguo y nuevo.
Importe la configuración de datos de usuarios especificando el archivo .mapping creado en el paso anterior.
Se recomienda fuertemente efectuar copias de seguridad del entorno de JMap Server.
Si su base de datos System de JMap Server ha sido desplazada a otro SGBD, usted debería incluirla en su procedimiento de copias de seguridad. Esta base de datos contiene información muy importante y sensible, tales como los datos de las capas personales.
La estrategia más simple para efectuar una copia de seguridad de JMap Server consiste en copiar el directorio completo de JMap con todos los subdirectorios.
Si desea efectuar copias de seguridad de menor tamaño, usted puede restringirse a estos directorios que contienen información importante.
Directorios
conf
Contiene los archivos de los parámetros, tales como jmapserver.properties, usermanager.properties, etc.
db
Contiene los archivos de configuración (proyectos, capas, etc.) así como la base de datos System de JMap Server, a menos que haya sido desplazada hacia otro SGBD.
backup
Directorio por defecto para almacenar los archivos de exportación.
workspaces
Los espacios de trabajo de los usuarios contienen principalmente los contextos y parámetros personales de los usuarios.
