Copia de seguridad y restauración de un servidor Medulla
Es imprescindible establecer una política de copias de seguridad periódicas para permitir la restauración de una plataforma Medulla en caso de avería, corrupción de datos, pérdida del servidor Medulla o error durante una operación de mantenimiento.
Para una instalación de Medulla On-Premise, se recomienda establecer varios niveles de protección:
- una copia de seguridad completa del servidor o de la máquina virtual;
- un volcado periódico de la instancia de MariaDB;
- una copia de seguridad lógica del directorio OpenLDAP con
slapcatcuando se utilice; - una copia de seguridad de los principales directorios de configuración y datos de Medulla.
Importante:
Todos los comandos que figuran en esta documentación deben ejecutarse con la cuenta root.
Recomendación:
Siempre que su infraestructura lo permita, la copia de seguridad completa del servidor o de la máquina virtual debe seguir siendo el método principal de copia de seguridad. Los volcados de MariaDB, las exportaciones de OpenLDAP y los archivos de los directorios de Medulla constituyen medidas de protección complementarias que, entre otras cosas, facilitan la restauración en un nuevo servidor.
1. Copia de seguridad completa del servidor Medulla
Cuando Medulla está instalado en una máquina virtual, se recomienda utilizar la solución de copias de seguridad de su infraestructura de virtualización para realizar copias de seguridad periódicas de toda la máquina.
En el caso de un servidor físico, utilice su solución habitual de copias de seguridad del sistema.
La copia de seguridad debe almacenarse en una infraestructura distinta al servidor Medulla.
En particular, debe realizarse una copia de seguridad antes de:
- una actualización de Medulla;
- una modificación importante de la configuración;
- una intervención en MariaDB;
- una intervención en OpenLDAP;
- una modificación importante del sistema;
- una operación de migración.
Importante:
Una instantánea de la máquina virtual puede resultar útil antes de una operación de mantenimiento, pero no debe constituir por sí sola su política de copias de seguridad. Debe conservarse una copia de seguridad propiamente dicha, independiente del servidor Medulla.
2. Copia de seguridad de las bases de datos de MariaDB
Medulla utiliza MariaDB para almacenar una parte importante de sus datos.
Además de la copia de seguridad del servidor, se recomienda realizar un volcado periódico de toda la instancia de MariaDB.
Realizar una copia de seguridad de toda la instancia permite evitar tener que mantener manualmente una lista de las diferentes bases de datos que necesita Medulla.
Crear manualmente un volcado de MariaDB
Inicie sesión en el servidor con la cuenta root y, a continuación, ejecute:
mkdir -p /var/backups/medulla
mariadb-dump --all-databases \
--single-transaction \
--routines \
--events \
--triggers \
--hex-blob \
| gzip > /var/backups/medulla/medulla_mariadb_$(date +%Y%m%d_%H%M%S).sql.gz
Este comando permite, entre otras cosas, realizar una copia de seguridad de:
- todas las bases de datos de MariaDB;
- las tablas y sus datos;
- los procedimientos y funciones almacenadas;
- los eventos de MariaDB;
- los disparadores.
La opción --single-transaction permite obtener una copia de seguridad coherente de las tablas transaccionales, como las tablas InnoDB, sin mantener un bloqueo global sobre ellas durante todo el proceso de volcado.
Se generará un archivo similar al siguiente:
/var/backups/medulla/medulla_mariadb_20260828_100000.sql.gz
Importante:
Los volcados de MariaDB pueden contener información confidencial. Deben protegerse y transferirse a su infraestructura de copias de seguridad.
3. Automatizar la copia de seguridad de MariaDB
En un servidor en producción, se recomienda automatizar la creación de volcados de MariaDB.
Por ejemplo, puede crear el script:
/usr/local/sbin/backup_medulla_mariadb.sh
Con el siguiente contenido:
#!/bin/bash
set -e
BACKUP_DIR="/var/backups/medulla"
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p "$BACKUP_DIR"
mariadb-dump --all-databases \
--single-transaction \
--routines \
--events \
--triggers \
--hex-blob \
| gzip > "$BACKUP_DIR/medulla_mariadb_${DATE}.sql.gz"
find "$BACKUP_DIR" \
-type f \
-name "medulla_mariadb_*.sql.gz" \
-mtime +7 \
-delete
A continuación, haga que el script sea ejecutable:
chmod 700 /usr/local/sbin/backup_medulla_mariadb.sh
Puede probarlo manualmente:
/usr/local/sbin/backup_medulla_mariadb.sh
Nota:
El periodo de conservación local de 7 días que se muestra en este ejemplo puede adaptarse a su política de copias de seguridad. Las copias de seguridad también deben transferirse a una infraestructura externa.
4. Copia de seguridad de OpenLDAP con slapcat
Cuando se utiliza OpenLDAP en el servidor Medulla, se recomienda realizar una copia de seguridad lógica del directorio en formato LDIF mediante el comando slapcat.
slapcat permite exportar directamente el contenido de las bases de datos de OpenLDAP sin pasar por el protocolo LDAP.
Recomendación:
Se recomienda realizar una copia de seguridad tanto de la configuración de OpenLDAP como de los datos del directorio.
Realizar una copia de seguridad de la configuración de OpenLDAP
La base de datos cn=config corresponde a la base de datos número 0.
Cree el directorio de copia de seguridad si es necesario:
mkdir -p /var/backups/medulla
A continuación, ejecute:
slapcat -n 0 | gzip > /var/backups/medulla/openldap_config_$(date +%Y%m%d_%H%M%S).ldif.gz
Realizar una copia de seguridad de los datos de OpenLDAP
La base de datos que contiene los datos del directorio también debe exportarse.
Puede empezar por identificar las bases de datos configuradas con:
slapcat -n 0 | grep "^dn: olcDatabase"
Obtendrá, por ejemplo, entradas similares a las siguientes:
dn: olcDatabase={-1}frontend,cn=config
dn: olcDatabase={0}config,cn=config
dn: olcDatabase={1}mdb,cn=config
En este ejemplo, la base de datos que contiene los datos corresponde al número 1.
A continuación, puede realizarse una copia de seguridad con:
slapcat -n 1 | gzip > /var/backups/medulla/openldap_data_$(date +%Y%m%d_%H%M%S).ldif.gz
Importante:
Debe comprobarse el número de la base de datos LDAP antes de utilizar el comando. No dé por sentado sistemáticamente que la base que contiene los datos es la número 1.
De este modo, estarán disponibles los siguientes archivos:
openldap_config_YYYYMMDD_HHMMSS.ldif.gz
openldap_data_YYYYMMDD_HHMMSS.ldif.gz
Importante:
Las exportaciones LDIF pueden contener información confidencial sobre su directorio. Deben protegerse y almacenarse externamente, al igual que el resto de copias de seguridad de Medulla.
5. Automatizar la copia de seguridad de OpenLDAP
Una vez identificado el número de la base de datos que contiene los datos LDAP, se puede automatizar la copia de seguridad.
Por ejemplo, puede crear:
/usr/local/sbin/backup_medulla_openldap.sh
Con el siguiente contenido, adaptando la variable LDAP_DATABASE a su instalación:
#!/bin/bash
set -e
BACKUP_DIR="/var/backups/medulla"
DATE=$(date +%Y%m%d_%H%M%S)
LDAP_DATABASE="1"
mkdir -p "$BACKUP_DIR"
slapcat -n 0 \
| gzip > "$BACKUP_DIR/openldap_config_${DATE}.ldif.gz"
slapcat -n "$LDAP_DATABASE" \
| gzip > "$BACKUP_DIR/openldap_data_${DATE}.ldif.gz"
find "$BACKUP_DIR" \
-type f \
-name "openldap_*.ldif.gz" \
-mtime +7 \
-delete
Haga que el script sea ejecutable:
chmod 700 /usr/local/sbin/backup_medulla_openldap.sh
A continuación, pruébelo:
/usr/local/sbin/backup_medulla_openldap.sh
Importante:
Antes de automatizar esta copia de seguridad, compruebe que LDAP_DATABASE se corresponde efectivamente con la base de datos que contiene los datos OpenLDAP de su servidor.
6. Copia de seguridad de los directorios de Medulla
Además de los volcados de MariaDB, las exportaciones de OpenLDAP y la copia de seguridad completa del servidor Medulla, se pueden realizar copias de seguridad de los principales directorios que contienen la configuración, los datos y algunos componentes de Medulla.
Los directorios en cuestión son:
/etc/mmc
/etc/pulse-xmpp-agent
/etc/pulse-xmpp-agent-substitute
/var/lib/pulse2
/usr/lib/python3/dist-packages/pulse
/usr/lib/python3/dist-packages/mmc
Importante:
Es imprescindible que la copia de seguridad conserve los propietarios, los grupos, los permisos y los atributos de los archivos. Esta información es necesaria para garantizar una restauración correcta.
7. Crear un archivo comprimido de los archivos de Medulla
Inicie sesión con la cuenta root.
Cree el directorio de copia de seguridad si es necesario:
mkdir -p /var/backups/medulla
A continuación, puede crear un archivo de copia de seguridad con:
tar --acls --xattrs -czpf \
/var/backups/medulla/medulla_files_$(date +%Y%m%d_%H%M%S).tar.gz \
/etc/mmc \
/etc/pulse-xmpp-agent \
/etc/pulse-xmpp-agent-substitute \
/var/lib/pulse2 \
/usr/lib/python3/dist-packages/pulse \
/usr/lib/python3/dist-packages/mmc
Se generará un archivo similar al siguiente:
/var/backups/medulla/medulla_files_20260828_100000.tar.gz
El uso de las opciones --acls y --xattrs permite conservar las ACL y los atributos extendidos al crear el archivo comprimido.
Consejo:
Una vez creado el archivo de copia de seguridad, transfiéralo a su infraestructura de copias de seguridad. No se recomienda mantener la única copia de seguridad en el propio servidor Medulla.
8. Base de datos de ejabberd
La base de datos de ejabberd no requiere ningún procedimiento específico de copia de seguridad o restauración en el marco de este proceso.
Se genera automáticamente al iniciar Medulla.
9. Restauración de los archivos de Medulla
Los archivos archivados previamente pueden restaurarse, especialmente en el marco de la reconstrucción de un servidor Medulla.
La restauración debe realizarse con la cuenta root.
Ejemplo:
tar --acls --xattrs -xzpf medulla_files_YYYYMMDD_HHMMSS.tar.gz -C /
Atención:
La restauración de los directorios de Medulla no constituye, por sí sola, un procedimiento completo de reconstrucción de un servidor Medulla. La versión del sistema, la versión de Medulla, MariaDB, OpenLDAP y los archivos restaurados deben ser coherentes entre sí.
En el marco de una restauración en un nuevo servidor, se recomienda utilizar una versión de Medulla idéntica a la correspondiente a la copia de seguridad antes de restaurar los datos.
10. Restauración de MariaDB
Una vez que el entorno de MariaDB esté listo, se puede restaurar un volcado generado previamente.
Con la cuenta root:
gunzip -c medulla_mariadb_YYYYMMDD_HHMMSS.sql.gz | mariadb
Atención:
Un volcado realizado con la opción --all-databases contiene todas las bases de datos de las que se ha realizado una copia de seguridad. Por lo tanto, su restauración debe realizarse únicamente en el marco de un procedimiento de restauración controlado.
11. Restauración de OpenLDAP
Las copias de seguridad LDIF creadas con slapcat pueden restaurarse con el comando slapadd.
Atención:
La restauración de OpenLDAP debe realizarse con el servicio slapd detenido. Debe llevarse a cabo únicamente en el marco de un proceso de restauración controlado, comprobando la configuración, las rutas de almacenamiento y los propietarios de los archivos de OpenLDAP.
Detenga el servicio:
systemctl stop slapd
Restaurar la configuración
La restauración de cn=config debe realizarse en un entorno OpenLDAP limpio y compatible con la copia de seguridad.
El archivo LDIF puede descomprimirse con:
gunzip -c openldap_config_YYYYMMDD_HHMMSS.ldif.gz > /tmp/openldap_config.ldif
A continuación, podrá volver a importarse con slapadd, según la configuración de OpenLDAP del servidor.
Restaurar los datos
Descomprima el archivo:
gunzip -c openldap_data_YYYYMMDD_HHMMSS.ldif.gz > /tmp/openldap_data.ldif
A continuación, restaure la base de datos correspondiente; por ejemplo, si se trata de la base de datos número 1:
slapadd -n 1 -l /tmp/openldap_data.ldif
Importante:
El número de base utilizado con slapadd debe coincidir con la configuración de OpenLDAP restaurada. No debe suponerse automáticamente.
Tras la restauración, compruebe los propietarios y los permisos de los archivos de OpenLDAP antes de reiniciar el servicio.
A continuación, reinicie OpenLDAP:
systemctl start slapd
A continuación, compruebe su estado:
systemctl status slapd
12. Comprobar las copias de seguridad
La mera generación de un archivo de copia de seguridad no garantiza por sí sola que sea posible realizar una restauración.
Se recomienda comprobar periódicamente:
- que las copias de seguridad se realicen correctamente;
- que los archivos generados no estén vacíos;
- que los archivos TAR sean legibles;
- que los volcados de MariaDB sean utilizables;
- que las exportaciones de OpenLDAP sean utilizables;
- que las copias de seguridad se transfieran correctamente a un sistema externo;
- que haya varias generaciones de copias de seguridad disponibles;
- que se haya probado un procedimiento de restauración.
Para comprobar el contenido de un archivo Medulla sin descomprimirlo:
tar -tzf medulla_files_YYYYMMDD_HHMMSS.tar.gz
Para comprobar que un volcado comprimido de MariaDB no está dañado:
gzip -t medulla_mariadb_YYYYMMDD_HHMMSS.sql.gz
Para comprobar las copias de seguridad de OpenLDAP:
gzip -t openldap_config_YYYYMMDD_HHMMSS.ldif.gz
gzip -t openldap_data_YYYYMMDD_HHMMSS.ldif.gz
También es posible consultar el inicio de una exportación LDIF sin descomprimirla:
zcat openldap_data_YYYYMMDD_HHMMSS.ldif.gz | head
13. Frecuencia de las copias de seguridad
La frecuencia exacta debe adaptarse a las limitaciones y a la política de copia de seguridad de su organización.
| Elemento | Recomendación |
|---|---|
| Servidor / VM Medulla | Copia de seguridad periódica |
| MariaDB | Volcado automático periódico |
| OpenLDAP | Exportación periódica y automatizada de slapcat |
| Directorios de Medulla | Copia de seguridad periódica |
| Antes de una actualización de Medulla | Se recomienda encarecidamente realizar una copia de seguridad |
| Antes de realizar una modificación importante | Se recomienda encarecidamente realizar una copia de seguridad |
14. ¿Dónde se deben almacenar las copias de seguridad?
Las copias de seguridad no deben guardarse únicamente en el servidor Medulla.
Se recomienda transferirlas automáticamente a:
- un servidor de copias de seguridad;
- una solución de copias de seguridad centralizada;
- un almacenamiento remoto seguro;
- o cualquier otra infraestructura prevista en la política de copia de seguridad de su organización.
Importante:
Un fallo o una pérdida total del servidor Medulla también provocaría la pérdida de las copias de seguridad si estas se almacenaran únicamente en /var/backups/medulla.
15. Resumen
| Elemento | Copia de seguridad recomendada |
|---|---|
| Servidor Medulla | Copia de seguridad completa del servidor o de la máquina virtual |
| MariaDB | Volcado completo periódico con mariadb-dump |
| Configuración de OpenLDAP | Exportación LDIF con slapcat -n 0 |
| Datos de OpenLDAP | Exportación LDIF con slapcat de la base de datos correspondiente |
| Configuración de MMC | /etc/mmc |
| Configuración de XMPP | /etc/pulse-xmpp-agent |
| Configuración de XMPP Substitute | /etc/pulse-xmpp-agent-substitute |
| Datos de Pulse | /var/lib/pulse2 |
| Componentes de Pulse | /usr/lib/python3/dist-packages/pulse |
| Componentes de MMC | /usr/lib/python3/dist-packages/mmc |
| Base de datos de ejabberd | Se genera automáticamente al iniciar Medulla |
| Permisos necesarios | root |
Recomendación:
Para garantizar la restauración de una plataforma Medulla On-Premise, establezca una copia de seguridad completa y periódica del servidor, complementada con volcados periódicos de MariaDB, exportaciones de OpenLDAP con slapcat cuando se utilice el directorio y una copia de seguridad de los principales directorios de Medulla conservando sus permisos y atributos. Las copias de seguridad deben almacenarse externamente y debe comprobarse periódicamente su restauración.