Copia de seguridad y restauración

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

Si ha seguido las instrucciones de instalación, ha configurado OpenKM para usar una base de datos segura para producción y, opcionalmente, ha 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 legible 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, desde la versión 8.1.x de OpenKM, la ubicación de la ruta de los índices Lucene en el sistema de ficheros no la gestiona “repository.home”. Para más información, consulte Change repository home.

Consejo

Aunque OpenKM soporta 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, 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
• 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 ejecutándose simultáneamente para evitar problemas de validación de licencia.

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

Pasos detallados en 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

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 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 había creado previamente. En Ubuntu, si usa MySQL o MariaDB, use este comando para instalarla:

$ 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 el usuario y el nombre de la 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 en 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, 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 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 había creado 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 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 el usuario y el nombre de la 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