Skip to main content

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 slapcat cuando 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.