Sección de soporte
Quiero actualizar o migrar una instalación
Actualización y migración de instalaciones DSpace
Esta sección está orientada a instituciones que necesitan migrar entre versiones de DSpace o actualizar una instalación existente.
Guías paso a paso para migrar entre versiones, con checklists previas, FAQ de errores comunes y mejores prácticas regionales.
Documentación
Checklist Previa a la Migración
1. Backup Completo
Respalda base de datos PostgreSQL, directorio assetstore, configuraciones locales y personalizaciones de código.
2. Verificar Requisitos
Confirma que el servidor cumple los requisitos de la nueva versión: Java, Node.js, PostgreSQL, Solr.
3. Revisar Notas de Versión
Lee las release notes oficiales para identificar cambios importantes, deprecaciones y nuevas funcionalidades.
4. Planificar Downtime
Estima el tiempo de inactividad necesario y comunica a los usuarios con anticipación.
Proceso de Migración
Migración de Base de Datos
Ejecuta los scripts de migración de esquema incluidos en la nueva versión. Verifica que no haya errores en los logs.
Actualización Backend
Compila el nuevo backend con Maven, actualiza configuraciones en local.cfg y dspace.cfg.
Actualización Frontend
Instala dependencias con npm, ajusta configuraciones en environment.*.ts y compila para producción.
Reindexación Solr
Ejecuta dspace index-discovery -b para reindexar todo el contenido con el nuevo esquema de Solr.
Validación Final
Verifica funcionalidades críticas: búsqueda, navegación, depósito de ítems, OAI-PMH, autenticación.
Preguntas Frecuentes
Errores frecuentes en migraciones
Error de esquema de BD: Verifica que ejecutaste todos los scripts de migración en orden.
Permisos de archivos: Asegúrate de que el usuario de DSpace tiene permisos sobre assetstore.
Problemas con Angular
Si el frontend no arranca, verifica versiones de Node.js y npm. Limpia caché con npm cache clean --force y reinstala dependencias.
Problemas con Solr
Si la búsqueda no funciona tras migrar, verifica que Solr esté usando el esquema correcto y reindexar completamente.
Personalizaciones rotas
Las personalizaciones de código pueden romperse entre versiones. Revisa cambios en la API y adapta tu código personalizado.
Autoevaluación
Antes de solicitar soporte, evalúa tu situación:
Tengo un error puntual
Si encontraste un error específico durante la migración y necesitas ayuda para diagnosticarlo.
La migración falló
Si la migración no se completó exitosamente y necesitas asistencia para recuperar el servicio.
Necesito acompañamiento completo
Si prefieres que el equipo de soporte te acompañe durante todo el proceso de migración.
Derivación a Soporte
Si después de revisar la documentación y FAQ necesitas asistencia con tu migración, puedes crear un ticket de tipo "Migración".
¿Necesitas ayuda con tu migración?
Nuestro equipo puede asistirte con diagnóstico de errores, planificación de migración y acompañamiento técnico durante el proceso.
Crear Ticket de Migración