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 usar 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 tiene varias configuraciones, pero para un rendimiento óptimo recomendamos lo siguiente:

• Usar un almacén de datos por defecto que guarde la información binaria directamente en el disco del servidor (en un formato no comprensible para humanos).
• El resto de información, carpetas, estructura de documentos, metadatos, etc., se almacena en una base de datos.

En ese caso:

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

Nota

Por defecto, todos los documentos se almacenan en $TOMCAT_HOME/repository. Esta carpeta por defecto puede cambiarse usando la propiedad “repository.home” en el fichero $TOMCAT_HOME/openkm.properties. Tenga en cuenta que, a partir de OpenKM versión 8.1.x, la ubicación de la ruta de los índices Lucene en el sistema de ficheros no se gestiona mediante “repository.home”. Para más información, consulte Change repository home.

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 cuando sea posible.

Pasos de la copia de seguridad:

• Detener Tomcat
• Hacer 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
• Hacer 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, después el sistema de ficheros) garantizará la consistencia de la copia.

Precaución

Contacte con soporte antes de iniciar la nueva instancia para evitar problemas de validación de licencia. Es importante no tener ambas instancias en ejecución simultáneamente para evitar problemas de validación de licencia.

Una alternativa a los métodos de copia de seguridad tradicionales 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 de copia de seguridad; para repositorios medianos o grandes sugerimos soluciones de copia de seguridad incremental.

Pasos detallados para Linux

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

Copia de seguridad

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

Tras esto, tendrá un archivo ZIP con toda la instalación de OpenKM y la base de datos exportada. Compruébelo antes de eliminar esta instalación. Siempre recomendamos restaurar la copia de seguridad para asegurarse de que tiene todos los ficheros necesarios.

Restauración

Tenga en cuenta que debe crear la base de datos si no se creó previamente. En Ubuntu, si usa MySQL o MariaDB, use 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;

Recuerde que los nombres de usuario y de base de datos pueden ser distintos 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 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 xvfb imagemagick libreoffice tesseract-ocr

En el caso de CentOS:

$ sudo yum install ImageMagick tesseract libreoffice libreoffice-headless

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

Pasos detallados para Windows

Puede seguir estos pasos para hacer copia de seguridad y restaurar si tiene OpenKM configurado con MySQL o MariaDB. Para otras bases de datos, consulte los 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, 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
• Crear una copia de seguridad de la carpeta de Tomcat
• Volver a iniciar el servicio de OpenKM

Tras esto, tendrá un archivo ZIP con toda la instalación de OpenKM y la base de datos exportada. Compruébelo antes de eliminar esta instalación. Siempre recomendamos restaurar la copia de seguridad para asegurarse de que tiene 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árguela desde:

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

Una vez instalada, ejecute las siguientes sentencias para crear el usuario 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 de usuario y de base de datos pueden ser distintos 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 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 realice una comprobación del repositorio. Vea Repository checker.

Scripts de copia de seguridad

• Linux backup and restore with BorgBackup (recomendado)
• Linux backup and restore with rdiff-backup tool
• Linux backup and restore with rsync
• Linux backup and restore with Duplicity
• Linux backup with LFTP

Información adicional

• Easy Automated Snapshot-Style Backups with Linux and Rsync
• BorgBackup documentation
• Rdiff-backup home page
• Duplicity Backup Howto