Sección de soporte
Quiero instalar DSpace desde cero
Instalación de DSpace desde cero
Esta sección está orientada a instituciones que van a implementar DSpace por primera vez.
Requisitos técnicos, arquitectura recomendada e instalación completa de backend, frontend y Solr para nuevas implementaciones.
Navegación
Documentación
Requisitos Técnicos
Sistema Operativo
Linux (Ubuntu 20.04/22.04, CentOS/RHEL 8+). DSpace también funciona en Windows y macOS para desarrollo, pero Linux es recomendado para producción.
Software Base
Java: OpenJDK 17 o 21
PostgreSQL: 12+ (recomendado 13+)
Apache Solr: 9.x
Node.js: 18.x LTS
Apache Ant: 1.10+
Maven: 3.6+
Recursos Mínimos
RAM: 4 GB (8+ GB recomendado)
CPU: 2 cores (4+ recomendado)
Almacenamiento: 50 GB base + espacio para colección
Arquitectura Recomendada
Para producción: servidor web reverso (Nginx/Apache), certificado SSL, firewall configurado, backups automatizados.
Instalación Paso a Paso
1. Preparar el Entorno
Instala Java, PostgreSQL, Solr, Node.js, Maven y Ant. Crea usuario del sistema para DSpace (ej: dspace).
2. Configurar PostgreSQL
Crea base de datos y usuario para DSpace. Configura permisos y ajusta pg_hba.conf para permitir conexiones locales.
3. Instalar Backend
Descarga código fuente, configura local.cfg, compila con Maven (mvn package), instala con Ant (ant fresh_install).
4. Configurar Solr
Copia configuración de Solr desde DSpace, crea cores necesarios, inicia Solr y verifica que esté accesible.
5. Instalar Frontend
Clona repositorio Angular, configura environment.prod.ts con URL del backend, instala dependencias (npm install), compila (npm run build:prod).
6. Configurar Servidor Web
Configura Nginx o Apache como proxy reverso para backend y para servir frontend. Habilita HTTPS con certificado SSL.
7. Validación
Accede a la interfaz, crea usuario administrador, verifica búsqueda, prueba depósito de ítem de prueba, confirma OAI-PMH.
Preguntas Frecuentes
Errores de Java
JAVA_HOME no configurado: Exporta variable de entorno apuntando a tu JDK.
OutOfMemoryError: Aumenta heap de JVM en configuración de Tomcat/servicio.
Problemas con Angular
npm install falla: Verifica versión de Node.js (debe ser 18.x LTS).
Build falla: Revisa logs de compilación, puede ser error de dependencias o configuración.
Solr no arranca
Verifica que el puerto no esté en uso, revisa logs en solr/server/logs, confirma permisos de archivos.
Configuración incorrecta
Errores comunes: URL de base de datos mal formada, rutas de directorios incorrectas, permisos de archivos insuficientes.
Autoevaluación
Antes de solicitar soporte, evalúa tu situación:
No tengo experiencia técnica suficiente
Si no tienes experiencia con Java, Linux o administración de sistemas y necesitas acompañamiento completo.
Tengo error en instalación
Si encontraste un error específico durante la instalación y necesitas ayuda para resolverlo.
Necesito validación de arquitectura
Si quieres que revisemos tu arquitectura propuesta antes de proceder con la instalación.
Derivación a Soporte
Si después de revisar la documentación y FAQ necesitas asistencia con tu instalación, puedes crear un ticket de tipo "Instalación".
¿Necesitas ayuda con tu instalación?
Nuestro equipo puede asistirte con la instalación completa, resolución de errores y validación de arquitectura.
Crear Ticket de Instalación