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 apta 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 obtener un rendimiento óptimo recomendamos lo siguiente:

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

En ese caso:

1. En primer lugar, haga una copia de seguridad de su base de datos (realice un volcado SQL)
2. A continuación, haga una copia de seguridad de sus datos en el sistema de ficheros

Nota

De forma predeterminada, todos los documentos se almacenan en $TOMCAT_HOME/repository. Esta carpeta predeterminada puede cambiarse mediante la propiedad “repository.home” del fichero $TOMCAT_HOME/openkm.properties. Tenga en cuenta que, a partir de la versión 7.1.x de OpenKM, la ubicación de la ruta del índice de Lucene en el sistema de ficheros no se gestiona mediante “repository.home”. Para más información, consulte Cambiar el directorio principal 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:

• Detenga Tomcat
• Haga una copia de seguridad de la base de datos
  • En el caso de MariaDB, visite Full Backup and Restore with Mariabackup
  • En el caso de PostgreSQL, visite PostgreSQL Backup and Restore
  • En el caso de SQL Server, visite Create a Full Database Backup
  • En el caso de MySQL, visite MySQL Backup and Recovery
• Haga una copia de seguridad de la carpeta de Tomcat o del repositorio
• Inicie Tomcat

Nota

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

Precaución

Póngase en contacto con el soporte antes de iniciar la nueva instancia para evitar problemas de validación de la licencia. No ejecute ambas instancias simultáneamente para evitar problemas de validación de la licencia.

Una alternativa a los métodos tradicionales de copia de seguridad es exportar todo el repositorio desde OpenKM Administration > Utilities > Repository export y elegir las opciones de metadatos e historial. Sin embargo, no recomendamos este método para las copias de seguridad; sugerimos utilizar soluciones de copia de seguridad incremental para repositorios de tamaño medio o grande.

Pasos detallados en Linux

Puede seguir estos pasos para hacer la copia de seguridad y restaurarla si tiene OpenKM configurado con MySQL o MariaDB. Para otras bases de datos, consulte los 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, dispondrá de un archivo ZIP con toda la instalación de OpenKM y la base de datos exportada. Compruébelo antes de destruir esta instalación. Recomendamos siempre restaurar la copia de seguridad para asegurarse de que dispone de todos los ficheros 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 y Ubuntu, utilice este comando para instalarlo:

$ sudo apt install mariadb-server

En el caso de CentOS:

$ sudo yum install mariadb-server

A continuación, 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;

Recuerde que los nombres del usuario y de la base de datos pueden ser diferentes en su caso. Consulte el informe de instalación o compruébelos en $TOMCAT_HOME/openkm.properties.

Una vez creados, restaure la base de datos y los ficheros:

$ 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 ficheros, inicie OpenKM y ejecute una comprobación del repositorio. Consulte Comprobador del repositorio.

Pasos detallados en Windows

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

Copia de seguridad

• Detenga el servicio de OpenKM
• Cree una copia de seguridad de la base de datos
  • En el caso de MariaDB, visite Full Backup and Restore with Mariabackup
  • En el caso de PostgreSQL, visite PostgreSQL Backup and Restore
  • En el caso de SQL Server, visite Create a Full Database Backup
  • En el caso de MySQL, visite MySQL Backup and Recovery
• Cree una copia de seguridad de la carpeta de Tomcat
• Inicie de nuevo el servicio de OpenKM

Después de esto, dispondrá de un archivo ZIP con toda la instalación de OpenKM y la base de datos exportada. Compruébelo antes de destruir esta instalación. Recomendamos siempre restaurar la copia de seguridad para asegurarse de que dispone de todos los ficheros 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árguelos desde:

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

Una vez instalados, 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;

Recuerde que los nombres del usuario y de la base de datos pueden ser diferentes en su caso. Consulte el informe de instalación o compruébelos en $TOMCAT_HOME/openkm.properties.

Una vez creados, restaure la base de datos y los ficheros:

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 ficheros, inicie OpenKM y ejecute una comprobación del repositorio. Consulte Comprobador del repositorio.

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 principal de Rdiff-backup
• Duplicity Backup Howto