Exportación e importación

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.

Exportación e importación de la configuración de JMap

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.

Exportación

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.

Importación

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.

Exportación e importación de los datos de los usuarios en JMap

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.

Exportación

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.).

Importación

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.

Archivo .mapping

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:

1. Exporte la configuración de JMap Server.

2. Exporte la configuración de datos de usuarios.

En el nuevo servidor JMap:

1. Importe la configuración del servidor JMap.

2. Tome nota del ID de cada proyecto en el servidor antiguo.

3. Tome nota del ID de cada proyecto en el nuevo servidor.

4. Cree un (1) archivo .mapping con la correspondencia para cada proyecto entre el ID antiguo y nuevo.

   
5. Importe la configuración de datos de usuarios especificando el archivo .mapping creado en el paso anterior.

Copias de seguridad

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.