Cómo migrar Dolibarr a un nuevo servidor sin perder datos: una guía completa

Índice del Contenido

1. Introducción

2. ¿Por qué podría ser necesario migrar Dolibarr?

3. Comprensión de la estructura de archivos y bases de datos de Dolibarr

4. Preparación para una migración: estrategia de respaldo

5. Cómo elegir su nuevo entorno de alojamiento

6. Instalación de requisitos previos en el nuevo servidor

7. Copia de seguridad de la base de datos de Dolibarr

8. Exportación de documentos y archivos de configuración de Dolibarr

9. Transferencia segura de archivos al nuevo servidor

10. Restaurar la base de datos en el nuevo servidor

11. Ajustando el archivo de configuración (conf.php)

12. Configuración de permisos y propiedad de directorios

13. Prueba de la instancia restaurada

14. Consideraciones sobre DNS y propagación de dominios

15. Cómo manejar las diferencias de versiones durante la migración

16. Limpieza y optimización posterior a la migración

17. Errores comunes y cómo solucionarlos

18. Migración de módulos y complementos personalizados

19. Garantizar la compatibilidad con integraciones externas

20. Comprobaciones de integridad de los datos después de la migración

21. Manejo del acceso de usuarios durante el cambio

22. Plan final de copia de seguridad y reversión

23. Mejores prácticas de seguridad durante la migración

24. Programación de tiempos de inactividad y comunicación con las partes interesadas

25. Conclusión: Migración confiable sin pérdida de datos

1. Introducción

Migrar su sistema ERP/CRM Dolibarr a un nuevo servidor puede parecer abrumador, especialmente cuando la integridad de los datos y la continuidad del servicio son cruciales. Ya sea que esté cambiando de proveedor de alojamiento, actualizando hardware o migrando a una nube privada, esta guía le guiará paso a paso por el proceso de migración, sin perder ni un solo byte de datos.

2. ¿Por qué podrías necesitar migrar Dolibarr?

Los escenarios comunes incluyen:

• Cambiar de hosting compartido a VPS o hosting dedicado

• Pasar de un servidor de prueba a producción

• Cambiar a un proveedor de nube

• Actualización del sistema operativo o la infraestructura

La migración garantiza un mejor rendimiento, flexibilidad y seguridad cuando se realiza correctamente.

3. Comprensión de la estructura de archivos y bases de datos de Dolibarr

Dolibarr se basa en dos componentes principales:

• Database (MySQL/MariaDB): almacena todos los datos comerciales: clientes, facturas, inventario, etc.

• Sistema de archivos:Contiene archivos de configuración, módulos, documentos cargados por el usuario (PDF, imágenes) y /htdocs/ carpeta de la aplicación

Necesitas ambos para una migración completa.

4. Preparación para una migración: estrategia de respaldo

Antes de hacer cualquier cosa:

• Hacer una copia de seguridad de la base de datos usando mysqldump

• Archivar el directorio completo de Dolibarr (por ejemplo, /var/www/dolibarr)

• Almacene copias de seguridad en dos ubicaciones seguras

También es aconsejable notificar a los usuarios sobre la ventana de mantenimiento y deshabilitar temporalmente el acceso de escritura.

5. Elección de su nuevo entorno de alojamiento

Asegúrese de que su nuevo servidor admita:

• PHP 7.4+ o PHP 8.1+

• MySQL o MariaDB

• Apache o Nginx

• Extensiones PHP requeridas: gd, curl, mbstring, json, etc.

Evite pilas de servidores incompatibles o antiguas.

6. Instalación de requisitos previos en el nuevo servidor

Instalar los paquetes necesarios:

sudo apt update
sudo apt install apache2 mariadb-server php php-mysql php-gd php-curl php-mbstring php-xml unzip

A continuación, habilite los módulos Apache necesarios:

sudo a2enmod rewrite ssl
sudo systemctl restart apache2

7. Copia de seguridad de la base de datos de Dolibarr

Use mysqldump o phpMyAdmin:

mysqldump -u root -p dolibarr_db > dolibarr_backup.sql

Asegúrese de que su volcado incluya:

• Todas las tablas

• Estructura de la tabla y datos

• Juego de caracteres UTF-8 (para caracteres no ingleses)

8. Exportación de documentos y archivos de configuración de Dolibarr

Utilice tar o zip para archivar su carpeta Dolibarr:

tar czf dolibarr_files.tar.gz /var/www/dolibarr

Esto preserva la estructura del directorio, los permisos y los enlaces simbólicos.

9. Transferencia segura de archivos al nuevo servidor

Use scp or rsync Para una transferencia segura:

scp dolibarr_backup.sql user@newserver:/home/user/
scp dolibarr_files.tar.gz user@newserver:/home/user/

Como alternativa, utilice SFTP o un dispositivo USB en entornos con espacio de aire.

10. Restaurar la base de datos en el nuevo servidor

Inicie sesión en MySQL e importe:

mysql -u root -p
CREATE DATABASE dolibarr_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
exit
mysql -u root -p dolibarr_db < dolibarr_backup.sql

Asegúrese de que las credenciales del usuario coincidan con las de conf.php.

11. Ajuste del archivo de configuración (conf.php)

Abra el htdocs/conf/conf.php y actualizar:

• db_host

• db_user

• db_pass

• db_name

• dolibarr_main_url_root

Asegúrese de que las URL coincidan con el nuevo dominio o IP del servidor.

12. Configuración de permisos y propiedad de directorios

Establecer los permisos de usuario correctos:

chown -R www-data:www-data /var/www/dolibarr
chmod -R 755 /var/www/dolibarr

Estos garantizan el acceso del servidor web a los archivos de Dolibarr.

13. Prueba de la instancia restaurada

Accede a tu página de inicio de sesión de Dolibarr en la nueva URL. Verifica:

• Conectividad de base de datos

• Funcionalidad de inicio de sesión

• Generación de PDF

• Activación del módulo

Utilice herramientas de desarrollo del navegador o registros de errores de PHP para depurar problemas.

14. Consideraciones sobre DNS y propagación de dominios

Si estás cambiando de dominio:

• Actualizar los registros DNS A a la nueva IP del servidor

• Configurar HTTPS con Let's Encrypt u otro SSL

• Espere de 24 a 48 horas para la propagación global del DNS

15. Cómo manejar las diferencias de versión durante la migración

Si su nuevo servidor utiliza una versión más reciente de Dolibarr:

• Siga los procedimientos de actualización antes de la migración

• Ejecute el instalador de Dolibarr en /install/ para actualizar el esquema de la base de datos

Nunca restaure una copia de seguridad antigua en una instalación más nueva sin seguir los pasos de migración.

16. Limpieza y optimización posterior a la migración

Las tareas posteriores a la migración incluyen:

• Eliminación .sql y .tar.gz archivos de respaldo

• Eliminar carpetas temporales o de caché

• Ejecución de scripts de optimización de bases de datos

• Comprobación de módulos o datos no utilizados

17. Errores comunes y cómo solucionarlos

18. Migración de módulos y complementos personalizados

Copiar todos los módulos personalizados desde: /htdocs/custom/

También migran:

• Archivos de lenguaje

• Temas personalizados o CSS

• Plantillas y ganchos adicionales

Asegúrese de que sean compatibles con su versión de Dolibarr.

19. Garantizar la compatibilidad con integraciones externas

Después de la migración, prueba:

• Puntos finales API

• Puentes WooCommerce o Prestashop

• Configuración SMTP de correo electrónico

• Webhooks o scripts CRON

Actualice las IP o los tokens según sea necesario en las plataformas conectadas.

20. Verificaciones de integridad de datos después de la migración

Validar:

• Los totales de las facturas coinciden con los registros antiguos

• Los datos de clientes y proveedores están intactos

• Los informes coinciden con las instantáneas previas a la migración

• No faltan archivos en /documents/

Utilice consultas SQL para comprobar registros aleatorios.

21. Manejo del acceso de usuarios durante el cambio

Mejores prácticas:

• Informar a los usuarios con antelación

• Congelar el acceso durante la copia de seguridad

• Permitir el acceso sólo después de realizar pruebas en el nuevo servidor

Considere establecer un modo de solo lectura temporal si el tiempo de inactividad es mínimo.

22. Plan final de copia de seguridad y reversión

Always:

• Realizar una copia de seguridad del nuevo servidor después de una migración exitosa

• Conservar la instantánea del servidor antiguo durante al menos 7 días

• Documentar todos los pasos y problemas durante la migración

Esto proporciona una red de seguridad en caso de errores posteriores a la migración.

23. Mejores prácticas de seguridad durante la migración

• Utilice SSH/SFTP, no FTP

• Rotar las contraseñas de base de datos y de administrador después de la migración

• Asegure el firewall y la configuración PHP de su nuevo servidor

• Habilitar HTTPS inmediatamente

24. Programación del tiempo de inactividad y comunicación con las partes interesadas

Notificar a clientes y usuarios:

• Ventana de tiempo de inactividad prevista

• Cualquier cambio en las URL o inicios de sesión

• Contactos de soporte en caso de problemas

Programe la migración durante horas de menor actividad, si es posible.

25. Conclusión: Migración confiable sin pérdida de datos

Migrar Dolibarr a un nuevo servidor es seguro y fácil de gestionar si se siguen los pasos correctos. Con una planificación cuidadosa, copias de seguridad exhaustivas y la verificación de cada etapa, podrá migrar a una infraestructura o proveedor de alojamiento más potente sin interrupciones del servicio ni pérdida de datos.

Ya sea que esté ampliando sus operaciones o mejorando la seguridad, esta migración ayudará a garantizar que Dolibarr siga siendo una columna vertebral estable de sus operaciones comerciales.