Cómo migrar a otro servidor

Linux

Preliminares

Asegúrese de tener suficiente espacio en disco en el nuevo servidor.
Compruebe que dispone de suficiente capacidad de CPU y RAM en el nuevo servidor.
Cree el usuario que será el propietario de los archivos de OpenKM (la carpeta $TOMCAT_HOME). Este usuario suele llamarse “openkm” (más información en Instalación en Ubuntu y Debian (manual)), pero puede elegirse otro durante la instalación.
Actualice el sistema operativo.

Detener el servicio de OpenKM

Es importante que, mientras se mueven los datos entre los dos servidores, no se produzcan cambios en el servidor antiguo. Por eso es una buena práctica detener OpenKM.

Copia de seguridad de la base de datos

La conexión con la base de datos se configura en el archivo “openkm.properties” (en la carpeta $TOMCAT_HOME). En el siguiente ejemplo, el usuario se llama “openkm”, su contraseña es “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 hacer una copia de seguridad de las bases 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 archivo okmdb.sql al nuevo servidor.
Restaure la copia de seguridad.

El siguiente ejemplo explica cómo restaurar las bases 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 archivos binarios

Copie la carpeta TOMCAT_HOME al nuevo servidor. Sugerimos mantener la misma ruta de carpeta original en el destino (de lo contrario, tendrá 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 del servidor antiguo al nuevo:

$ 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 archivo /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

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

ImageMagick
Ghostscript
LibreOffice
Motor de OCR Tesseract (recuerde instalar los paquetes de idioma que necesite en su entorno)

Iniciar el servicio de OpenKM

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

Pasos adicionales

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

Comprobaciones finales

Compruebe la vista previa de diferentes tipos de documento (PDF, Microsoft Office).
Compruebe las miniaturas de diferentes tipos de documento (PDF, Microsoft Office).
Cree una carpeta.
Suba un documento nuevo.
Descargue un documento que ya existiera.