Cómo migrar a otro servidor

Precaución

Aunque el sistema no debería verse afectado, antes de realizar este tipo de acciones le recomendamos crear una copia de seguridad. Consulte la sección Copia de seguridad y restauración.

Linux

Consejo

En la siguiente documentación, en algunas secciones nos referiremos a Instalación en Ubuntu y Debian (manual) porque las acciones son las mismas.

Tareas previas

• Asegúrese de disponer de suficiente espacio en disco en el nuevo servidor.
• Compruebe que dispone de suficiente potencia de CPU y RAM en el nuevo servidor.
• Cree el usuario que es el propietario de los ficheros de OpenKM (carpeta $TOMCAT_HOME). Este usuario suele llamarse “openkm” (más información en Instalación en Ubuntu y Debian (manual)), aunque la instalación puede haber elegido otro distinto.
• Actualice el sistema operativo.

Detener el servicio de OpenKM

Es importante que, mientras se trasladan los datos entre los dos servidores, no se realice ningún cambio en el servidor antiguo. Por ello es una buena práctica detener OpenKM.

Precaución

Si no desea detener el servicio de OpenKM, configure OpenKM en modo de solo lectura con el parámetro de configuración “system.readonly”.

Copia de seguridad de la base de datos

En el fichero “openkm.properties” (en la carpeta $TOMCAT_HOME) se configura la conexión con la base de datos. En el siguiente ejemplo el usuario se llama “openkm” con contraseña “openkm” y la URL de conexión es “jdbc:mariadb://localhost:3306/okmdb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8&nullNamePatternMatchesAll=true”:

# Database connection
spring.datasource.driver-class-name=org.mariadb.jdbc.Driver
spring.datasource.url=jdbc:mariadb://localhost:3306/okmdb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8&nullNamePatternMatchesAll=true
spring.datasource.username=openkm
spring.datasource.password=openkm

El siguiente comando explica cómo realizar la copia de seguridad de la base de datos MySQL y MariaDB. La base de datos suele llamarse “okmdb”:

$ mysqldump -h localhost -u openkm -popenkm okmdb > okmdb.sql

Restaurar la base de datos

• Instale el mismo motor de base de datos en el nuevo servidor.
• Cree el usuario de la base de datos con las mismas credenciales (más información en Instalación en Ubuntu y Debian (manual)).
• Copie el fichero okmdb.sql al nuevo servidor.
• Restaure la copia de seguridad.

El siguiente ejemplo explica cómo restaurar la base de datos MySQL y MariaDB. De nuevo, la base de datos suele llamarse “okmdb”:

$ mysql -h localhost -u openkm -popenkm okmdb < okmdb.sql

Copiar los ficheros binarios

Precaución

Revise el fichero OpenKM.cfg; normalmente todo el repositorio está en la carpeta TOMCAT_HOME, pero según su configuración puede estar configurado en otra ubicación. Esta carpeta del repositorio también debe copiarse.

Consulte los parámetros de Cambiar el directorio raíz del repositorio.

• Copie la carpeta TOMCAT_HOME al nuevo servidor. Le sugerimos mantener en el destino la misma ruta de carpeta original (de lo contrario tendría que realizar pasos de configuración adicionales).
• Establezca los permisos para el propietario de la carpeta TOMCAT_HOME en el nuevo servidor (normalmente el usuario llamado openkm).

El siguiente ejemplo muestra cómo copiarla (desde el servidor antiguo al nuevo servidor):

$ rsync -avh --progress --stats /home/openkm/tomcat-8.5.69 root@newServer:/home/openkm/tomcat-8.5.69

El siguiente ejemplo muestra cómo establecer el propietario (debe ejecutarlo como root):

$ chown openkm:openkm -Rf /home/openkm/tomcat-8.5.69

Configurar el servicio en el nuevo servidor

• Copie el fichero /etc/init.d/openkm al nuevo servidor en la misma ubicación y regístrelo como servicio. (más información en Instalación en Ubuntu y Debian (manual)).

Instalar herramientas de terceros

Precaución

En Administration > Configuration parameters de OpenKM encontrará información sobre la mayoría de las aplicaciones necesarias. Algunas de ellas se encuentran en la carpeta $TOMCAT_HOME/bin, por lo que ya se copiaron en los pasos anteriores como parte de la carpeta TOMCAT_HOME.

Los paquetes mínimos necesarios son (más información en Instalación en Ubuntu y Debian (manual)):

• ImageMagick
• Ghostscript
• LibreOffice
• Motor OCR Tesseract (recuerde los paquetes de idioma necesarios en su entorno)

Iniciar el servicio de OpenKM

Precaución

Hasta que la licencia se traslade al nuevo servidor, solo podrá acceder a la interfaz de usuario de administración.

• Si el nuevo servidor dispone de menos RAM que el antiguo, debe revisar el fichero $TOMCAT_HOME/bin/setenv.sh y adaptarlo adecuadamente.
• Revise el fichero openkm.log durante el proceso de arranque y busque posibles errores.

Pasos adicionales

• Si el nuevo servidor tiene un número distinto de núcleos, debe revisar el valor de los parámetros de configuración “text.extraction.threads” y “text.extraction.batch”.
• Abra la administración en http://localhost:8080/openkm/management/ y ejecute un verificador del repositorio (esta acción puede tardar mucho tiempo en completarse).

Traslado de la licencia

Peligro

Coordínese con el equipo de OpenKM para trasladar la licencia del servidor antiguo al nuevo.

Comprobaciones finales

• Compruebe la vista previa de distintos tipos de documento (PDF, Microsoft Office).
• Compruebe las miniaturas de distintos tipos de documento (PDF, Microsoft Office).
• Cree una carpeta.
• Suba un nuevo documento.
• Descargue un documento existente previamente.