Copia de seguridad y restauración

Una de las cosas más importantes es disponer de una copia de seguridad actualizada de su OpenKM.

Si ha seguido las instrucciones de instalación, habrá configurado OpenKM para utilizar una base de datos segura para producción y, opcionalmente, habrá establecido una ruta para el almacén de datos del repositorio de OpenKM.

Nota

OpenKM admite varias configuraciones, pero para un rendimiento óptimo recomendamos:

• Utilizar el almacén de datos por defecto, que guarda la información binaria directamente en el disco del servidor (en un formato no comprensible para las personas).
• Toda la demás información (estructura de carpetas y documentos, metadatos, etc.) se almacena en la base de datos.

En este caso:

1. Primero haga una copia de seguridad de su base de datos (un volcado SQL)
2. Después haga una copia de seguridad de sus datos en el sistema de archivos

Nota

Por defecto, todos los documentos se almacenan en $TOMCAT_HOME/repository. Esta carpeta por defecto puede cambiarse mediante la propiedad “repository.home” del archivo $TOMCAT_HOME/openkm.properties. A partir de la versión 7.0.x de OpenKM, la ubicación de los índices de Lucene en el sistema de archivos no se gestiona con “repository.home”. Para más información, consulte Cambiar el directorio home del repositorio

Consejo

Aunque OpenKM admite copias de seguridad en caliente de sus datos, se recomienda detener Tomcat antes de iniciar la copia de seguridad. Aplique esta buena práctica siempre que sea posible.

Pasos de la copia de seguridad:

• Detener Tomcat
• Copia de seguridad de la base de datos
  • En el caso de MariaDB, consulte Full Backup and Restore with Mariabackup
  • En el caso de PostgreSQL, consulte PostgreSQL Backup and Restore
  • En el caso de SQL Server, consulte Create a Full Database Backup
  • En el caso de MySQL, consulte MySQL Backup and Recovery
• Copia de seguridad de la carpeta de Tomcat o del repositorio
• Iniciar Tomcat

Nota

Realizar la copia de seguridad en ese orden (primero la base de datos y después el sistema de archivos) garantizará la coherencia de la copia.

Existe una alternativa a los métodos tradicionales de copia de seguridad: exportar todo el repositorio desde Administration > Utilities > Repository export de OpenKM y elegir las opciones de metadatos e historial. Sin embargo, no recomendamos este método para las copias de seguridad; para repositorios medianos o grandes recomendamos soluciones de copia de seguridad incremental.

Pasos detallados en Linux

Si tiene OpenKM configurado con MySQL o MariaDB, puede seguir estos pasos para hacer la copia de seguridad y restaurarla. Para otras bases de datos, consulte sus comandos correspondientes.

Copia de seguridad

$ /etc/init.d/tomcat stop
$ mysqldump -h localhost -u root -p okmdb > /path/to/openkm/okmdb.sql
$ zip -r /path/to/backup/okm-backup.zip /path/to/openkm
$ /etc/init.d/tomcat start

Después de esto, tendrá un archivo ZIP con toda la instalación de OpenKM y la base de datos exportada. Compruébelo antes de destruir la instalación. Siempre recomendamos restaurar la copia de seguridad para asegurarse de que dispone de todos los archivos necesarios.

Restauración

Tenga en cuenta que debe crear la base de datos si no se creó previamente. En el caso de MySQL o MariaDB en Ubuntu, utilice este comando para instalarlo:

$ sudo apt install mariadb-server

En el caso de CentOS:

$ sudo yum install mariadb-server

Y ejecute las siguientes sentencias:

CREATE USER 'openkm'@'localhost' IDENTIFIED BY 's3cr3t0';
CREATE DATABASE okmdb DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_bin;
GRANT ALL ON okmdb.* TO 'openkm'@'localhost' WITH GRANT OPTION;

Tenga en cuenta que el usuario y el nombre de la base de datos pueden ser diferentes en su caso. Consulte el informe de instalación o compruébelo en $TOMCAT_HOME/openkm.properties.

Una vez creada, restaure la base de datos y los archivos:

$ unzip /path/to/backup/okm-backup.zip -d /path/to/restore
 $ mysql -h localhost -u root -p okmdb < /path/to/restore/okmdb.sql

Establezca los permisos según el usuario que inicia OpenKM:

$ sudo chown openkm:openkm /path/to/openkm -R

Instale las dependencias necesarias. En el caso de Ubuntu:

$ sudo apt install gawk imagemagick libreoffice tesseract-ocr

En el caso de CentOS:

$ sudo yum install gawk ImageMagick libreoffice libreoffice-headless

Una vez restaurado, verifique los permisos de los archivos, inicie OpenKM y realice una comprobación del repositorio. Consulte Repository checker.

Pasos detallados en Windows

Si tiene OpenKM configurado con MySQL o MariaDB, puede seguir estos pasos para hacer la copia de seguridad y restaurarla. Para otras bases de datos, consulte sus comandos correspondientes.

Copia de seguridad

• Detener el servicio de OpenKM
• Crear una copia de seguridad de la base de datos
  • En el caso de MariaDB, consulte Full Backup and Restore with Mariabackup
  • En el caso de PostgreSQL, consulte PostgreSQL Backup and Restore
  • En el caso de SQL Server, consulte Create a Full Database Backup
  • En el caso de MySQL, consulte MySQL Backup and Recovery
• Crear una copia de seguridad de la carpeta de Tomcat
• Volver a iniciar el servicio de OpenKM

Después de esto, tendrá un archivo ZIP con toda la instalación de OpenKM y la base de datos exportada. Compruébelo antes de destruir la instalación. Siempre recomendamos restaurar la copia de seguridad para asegurarse de que dispone de todos los archivos necesarios.

Restauración

Tenga en cuenta que debe crear la base de datos si no se creó previamente. En el caso de MySQL o MariaDB, descárguelo desde:

• https://mariadb.org/download/
• https://www.mysql.com/downloads/

Una vez instalado, ejecute las siguientes sentencias para crear el usuario de la base de datos y la base de datos de OpenKM:

CREATE USER 'openkm'@'localhost' IDENTIFIED BY 's3cr3t0';
CREATE DATABASE okmdb DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_bin;
GRANT ALL ON okmdb.* TO 'openkm'@'localhost' WITH GRANT OPTION;

Tenga en cuenta que el usuario y el nombre de la base de datos pueden ser diferentes en su caso. Consulte el informe de instalación o compruébelo en $TOMCAT_HOME/openkm.properties.

Una vez creada, restaure la base de datos y los archivos:

C:\> unzip okm-backup.zip -d C:\
C:\> mysql -h localhost -u root -p okmdb < okmdb.sql

Establezca los permisos según el usuario que inicia OpenKM:

Una vez restaurado, verifique los permisos de los archivos, inicie OpenKM y realice una comprobación del repositorio. Consulte Repository checker.

Scripts de copia de seguridad

• Copia de seguridad y restauración en Linux con BorgBackup (recomendado)
• Copia de seguridad y restauración en Linux con la herramienta rdiff-backup
• Copia de seguridad y restauración en Linux con rsync
• Copia de seguridad y restauración en Linux con Duplicity
• Copia de seguridad en Linux con LFTP

Información adicional

• Easy Automated Snapshot-Style Backups with Linux and Rsync
• Documentación de BorgBackup
• Página de inicio de rdiff-backup
• Duplicity Backup Howto