Migración de DSpace a un nuevo servidor

Resumen de enfoques de migración

Existen dos enfoques principales para migrar su instalación de DSpace a un nuevo servidor.

1. Instalar una copia nueva de DSpace y migrar la base de datos/archivos a dicha instalación - Este es el enfoque documentado en esta página. Es el enfoque recomendado, ya que garantiza cero pérdida de datos. No obstante, requiere más pasos para completar la migración.
2. Instalar una copia nueva de DSpace y utilizar la copia de seguridad y restauración AIP - Este es un enfoque alternativo en el que puede utilizar las herramientas de exportación AIP para exportar AIPs desde su sitio anterior y luego importarlos en el nuevo sitio. Aunque este método también funciona, tenga en cuenta que no todos los datos de DSpace pueden exportarse a AIPs, por lo que se perderán algunos datos durante esta migración (específicamente, cualquier envío que no haya sido completado o que aún esté en proceso de aprobación por flujo de trabajo se perderá. Consulte la documentación de copia de seguridad y restauración AIP para más detalles sobre qué datos no están incluidos actualmente en los AIPs).

Paso 1: Instalar una copia nueva de DSpace

En su nuevo servidor, siga las instrucciones de Instalación de DSpace e instale una copia nueva (vacía) de la versión más reciente de DSpace. ANTES DE CONTINUAR, asegúrese de que esta copia nueva de DSpace esté correctamente instalada y no muestre errores al iniciar el sitio. (Es normal que el sitio aparezca vacío en este punto, y eso está bien)

También puede aprovechar este momento para configurar adecuadamente sus archivos de configuración básicos tanto del backend (local.cfg) como del frontend (config.prod.yml).

Paso 2: Preparar sus datos para copiarlos desde el DSpace antiguo al nuevo

Hay tres áreas principales de datos que necesita migrar para garantizar que no haya pérdida de información.

Realice estos pasos en el servidor antiguo

1. Primero, debe detener Tomcat en el servidor antiguo. Estos pasos requieren que el sitio esté fuera de línea.

2. Actualizar secuencias (opcional) - Al migrar contenido, a veces los sitios descubren que las secuencias de la base de datos están desactualizadas o son incorrectas. Esto puede provocar errores de “clave duplicada” durante la migración de la base de datos a la versión más reciente. Para evitarlo, antes de exportar sus datos, ejecute esta versión antigua del comando "update-sequences" en su base de datos. Esto debería asegurar que las secuencias de su base de datos estén actualizadas antes de generar el volcado de datos.

   # If upgrading from DSpace 6 or below, run this on your old database
   psql -U [database-user] -f [dspace]/etc/postgres/update-sequences.sql [database-name]
   # e.g. psql -U dspace -f [dspace]/etc/postgres/update-sequences.sql dspace

   1. NOTA: Es importante ejecutar el script "update-sequences" que corresponde a la versión ANTIGUA de DSpace (la versión desde la cual está migrando). Si ha perdido esa versión anterior del script, puede descargarla desde nuestro repositorio de código y ejecutarla utilizando el comando "psql" mencionado anteriormente.
      1. Versión de DSpace 6.x del archivo "update-sequences.sql": https://github.com/DSpace/DSpace/blob/dspace-6_x/dspace/etc/postgres/update-sequences.sql
      2. Versión de DSpace 5.x del archivo "update-sequences.sql": https://github.com/DSpace/DSpace/blob/dspace-5_x/dspace/etc/postgres/update-sequences.sql

3. Los datos de la base de datos – Asegúrese de exportar los datos de la base de datos desde su sitio antiguo de DSpace utilizando una herramienta como "pg_dump" (para PostgreSQL). Si utiliza "pg_dump", obtendrá un archivo SQL grande que contiene todos los datos de su base de datos anterior.

   # Example of using pg_dump to export a database to an output file
   pg_dump -U [db_username] [db_name] > [output_file.sql]

4. La carpeta "assetstore" – Esta carpeta se encuentra en el directorio de instalación de su DSpace y contiene todos los archivos almacenados en el sistema. Necesitará todos los contenidos de esta carpeta (incluyendo todos los subdirectorios), por lo que puede optar por comprimirla en un archivo ZIP o copiarla directamente.
5. Los datos de Solr (opcional) – Tanto la autoridad como las estadísticas de DSpace se almacenan en Solr. Si desea conservar esta información, deberá exportarla desde el Solr antiguo y trasladarla al nuevo. Utilice la herramienta "solr-export-statistics" que se proporciona con DSpace; consulte la sección "Exportar estadísticas de SOLR" en la guía de Mantenimiento de estadísticas de Solr. (Esto requiere que Solr esté en funcionamiento. Tenga en cuenta que, si Solr se ejecuta dentro de Tomcat, es posible que deba volver a iniciarlo temporalmente).

Paso 3: Copiar los datos preparados e importarlos en el nuevo DSpace

Copie los datos que preparó en el Paso 2 al nuevo servidor.

Ahora, deberá importar estos datos en su nueva instalación de DSpace (creada en el Paso 1).

Realice estos pasos en el nuevo servidor.

1. Primero, debe detener Tomcat en el nuevo servidor.
2. Los datos de la base de datos – Antes de poder importar los datos, debe eliminar la base de datos nueva y vacía.

   1. Elimine/limpie la base de datos nueva y vacía (creada en el paso 1), ya que durante la instalación se habrán creado tablas vacías. La forma más sencilla de hacerlo es ejecutando el comando "./dspace database clean". Tenga en cuenta que este comando requiere habilitar temporalmente la opción "db.cleanDisabled=false" en su archivo local.cfg. (Una vez que el comando "clean" se ejecute correctamente, asegúrese de eliminar esta configuración).

      # Delete everything in your database
      # Requires temporarily setting "db.cleanDisabled=false" in your local.cfg
      ./dspace database clean

      1. Alternativamente, los usuarios de PostgreSQL pueden eliminar toda la base de datos (utilizando el comando dropdb, por ejemplo: "dropdb -U [db_usuario] [nombre_bd]") y volver a crearla siguiendo las instrucciones de "Configuración de la base de datos" en la guía de Instalación de DSpace.

   2. Importe el volcado de base de datos que creó en el Paso 2 (anterior), lo cual recreará esta base de datos con todos sus datos anteriores. Para PostgreSQL, puede utilizar el comando "psql".

      # Example of using psql to import data from a SQL file into a database
      psql -U [db_username] [db_name] < [output_file.sql]

      (NOTICE the direction of the angle character... in this command you are telling Postgres to execute all the commands contained in your "output_file.sql", which will cause it to recreate all the database data in your new database.)

3. La carpeta "assetstore" – Elimine la carpeta assetstore vacía en el nuevo servidor. Copie la carpeta assetstore completa (incluyendo todos sus subdirectorios) desde el servidor antiguo al nuevo. Al final, debería tener varias jerarquías de subdirectorios (que contienen sus archivos) dentro de la carpeta [dspace]/assetstore/ en el nuevo servidor.
4. Los datos de Solr (opcional) – Si exportó los datos de estadísticas o autoridad en el Paso 2, puede importar esta información desde los archivos exportados utilizando la herramienta "solr-import-statistics" que se proporciona con DSpace. Consulte la sección "Importar estadísticas de SOLR" en la guía de Mantenimiento de estadísticas de Solr. (Requiere que Solr esté en funcionamiento)

Paso 4: Actualizar la base de datos, iniciar DSpace y reindexar

Ahora que todos los datos han sido copiados, debe asegurarse de que estén actualizados y reindexados correctamente (para la nueva versión de DSpace).

Realice estos pasos en el nuevo servidor.

1. Migrar/Actualizar la base de datos a la versión más reciente – Ahora que sus datos antiguos han sido migrados, DEBE asegurarse de que estén utilizando las actualizaciones de base de datos más recientes correspondientes a la nueva versión de DSpace que ha instalado. Revise los pasos relacionados con la base de datos en la guía de Actualización de DSpace y siga las instrucciones allí indicadas.

   # Migrate your old data to the latest DSpace version
   # WARNING: You must review the Upgrading DSpace docs to see if there are any additional database steps listed there!
   ./dspace database migrate ignored

   NOTA: Debe revisar los registros (dspace.log) en busca de errores. Es posible que se documenten pasos adicionales en la guía de Actualización de DSpace.
2. Inicie Tomcat. Esto pondrá en funcionamiento su nuevo DSpace, con los datos ya migrados. Revise los registros del backend (dspace.log y el registro de Tomcat) para asegurarse de que no se presenten errores al iniciar.

3. Reindexar todo el contenido – Esto asegurará que toda la funcionalidad de búsqueda y navegación funcione correctamente en el sitio DSpace. Opcionalmente, si utiliza OAI-PMH, también querrá reindexar el contenido en ese servicio.

   # Reindex all your content in DSpace
   ./dspace index-discovery -b
   
   # (Optionally) also reindex everything into OAI-PMH endpoint
   ./dspace oai import

   NOTA: Hasta que este comando finalice (puede tardar en sitios grandes), no podrá navegar ni buscar completamente el contenido desde la interfaz de usuario. Para verificar el progreso de la reindexación, consulte el archivo dspace.log.

Paso 5: Revisar las instrucciones de actualización y realizar la limpieza final

Si ha cambiado la versión de DSpace que está utilizando, debe revisar la guía de Actualización de DSpace para consultar las instrucciones relacionadas con cambios de configuración necesarios u otras actualizaciones requeridas. Debe realizar cualquier paso de actualización que no haya ejecutado aún (tenga en cuenta que ya debió haber actualizado su base de datos y reindexado su contenido).

En este momento, también puede revisar sus configuraciones del sitio antiguo de DSpace y ver si hay alguna configuración que desee copiar al nuevo sitio. Este paso es opcional, ya que también puede optar por comenzar "desde cero" con un nuevo archivo local.cfg.

FINALMENTE, pruebe el nuevo sitio y verifique que todo el contenido, cuentas de usuario, etc., se hayan transferido correctamente. Si encuentra algún problema, consulte nuestra guía "Solucionar un error" para obtener sugerencias sobre cómo identificar el mensaje de error subyacente y reportarlo a las listas o canales de soporte. Además, asegúrese de revisar nuestra lista de Problemas Comunes de Instalación en la guía de Instalación de DSpace.