Saltar al contenido
Facturador

Migración con respaldos SQL

Guía para transferir los datos del facturador (bases de datos multi-tenant, certificados digitales y archivos de comprobantes) a un facturador ya instalado en otro servidor, usando volcados SQL.

¿Cuál guía usar? Este método sirve aunque el servidor nuevo tenga otra versión de MariaDB o una instalación distinta. Si quieres clonar la instalación Docker completa tal como está (proxy, certificados SSL y volumen de MariaDB), usa Migración de servidor con Docker. Para elegir entre todas las opciones, ver Actualizar o migrar el sistema.


📦 Fase 1: Preparación en Servidor A (Origen)

1. Respaldo de Archivos Físicos

# Comprimir el directorio storage/app desde la raíz del facturador
cd /ruta/facturador
tar -czvf storage_backup.tar.gz storage/app/

2. Extracción de Registros de Tenants

Conéctese a MariaDB y obtenga la base de datos de cada empresa. La base central es la de DB_DATABASE en el .env:

USE [base_central];
SELECT c.number, c.name, h.fqdn, w.uuid AS base_de_datos
FROM clients c
JOIN hostnames h ON h.id = c.hostname_id
JOIN websites w ON w.id = h.website_id;

3. Volcado de Bases de Datos

Genere el dump de la base central y de cada tenant (repita la segunda línea por cada base tenancy_* de la consulta anterior):

docker exec [contenedor_mariadb] mysqldump -u root -p[clave] [base_central] > base_central.sql
docker exec [contenedor_mariadb] mysqldump -u root -p[clave] [tenancy_empresa] > [tenancy_empresa].sql

4. Transferencia al Servidor B

Transfiera los respaldos vía SCP o rsync:

scp storage_backup.tar.gz *.sql usuario@ip_servidor_b:/root/backups/

🚀 Fase 2: Restauración en Servidor B (Destino)

1. Despliegue Limpio del Facturador

Instale la aplicación en el nuevo servidor con la misma versión base del sistema.

2. Restauración de Archivos de Storage

Descomprima el respaldo desde la raíz del facturador (el archivo ya incluye la ruta storage/app/):

cd /ruta/nuevo_facturador
tar -xzvf /root/backups/storage_backup.tar.gz
chmod -R 775 storage bootstrap/cache

3. Restauración de Bases de Datos

Restaure la base de datos central y cada tenant. Si la base del tenant aún no existe en el servidor B, créela antes con CREATE DATABASE [tenancy_empresa];:

cat base_central.sql | docker exec -i [contenedor_mariadb] mysql -u root -p[clave] [base_central]
cat [tenancy_empresa].sql | docker exec -i [contenedor_mariadb] mysql -u root -p[clave] [tenancy_empresa]

4. Verificación de Permisos y Caché

docker exec -ti [contenedor_fpm] php artisan optimize:clear