Cómo migrar a otro servidor

Precaución

Aunque el sistema no debería verse afectado, antes de realizar este tipo de acción, recomendamos hacer una copia de seguridad. Consulte la sección Backup and restore.

Linux

Consejo

En la siguiente documentación, nos referiremos a Installing on Ubuntu and Debian en algunas secciones porque son las mismas acciones.

Preliminares

• Asegúrese de tener suficiente espacio en disco en el nuevo servidor.
• Compruebe que tiene suficiente potencia de CPU y RAM en el nuevo servidor.
• Cree el usuario que sea el propietario de los ficheros de OpenKM (carpeta $TOMCAT_HOME). Este usuario normalmente se llama “openkm” (más información en Installing on Ubuntu and Debian), pero es posible que se haya elegido un usuario distinto durante la instalación.
• Actualice el sistema operativo.

Detener el servicio OpenKM

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

Precaución

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

Copia de seguridad de la base de datos

La conexión a la base de datos se configura en el fichero “openkm.properties” (en la carpeta $TOMCAT_HOME). 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 hacer copia de seguridad de la base de datos MySQL y MariaDB. La base de datos normalmente se llama “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 base de datos con las mismas credenciales (más información en Installing on Ubuntu and Debian).
• Copie el fichero okmdb.sql al nuevo servidor.
• Restaure la copia de seguridad.

El siguiente ejemplo explica cómo restaurar una base de datos MySQL o MariaDB. De nuevo, la base de datos normalmente se llama “okmdb”:

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

Copiar los ficheros binarios

Precaución

Revise el fichero OpenKM.cfg. Todo el repositorio normalmente está en la carpeta TOMCAT_HOME, pero dependiendo de su configuración puede estar en otra ubicación. Esta carpeta del repositorio también debe copiarse.

Revise los parámetros en Change repository home.

• Copie la carpeta TOMCAT_HOME al nuevo servidor. Sugerimos mantener la misma ruta de carpeta original en el destino (de lo contrario necesitaría realizar pasos de configuración adicionales).
• Establezca el propietario y los permisos 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 servidor):

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

El siguiente ejemplo muestra cómo establecer el propietario (necesita 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 a la misma ubicación en el nuevo servidor y regístrelo como servicio. (más información en Installing on Ubuntu and Debian).

Instalar herramientas de terceros

Precaución

En OpenKM Administration > Configuration parameters encontrará información sobre la mayoría de las aplicaciones necesarias. Algunas están en la carpeta $TOMCAT_HOME/bin, así 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 Installing on Ubuntu and Debian):

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

Iniciar el servicio OpenKM

Precaución

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

• Si el nuevo servidor tiene menos RAM que el antiguo, revise el fichero $TOMCAT_HOME/bin/setenv.sh y ajústelo en consecuencia.
• Revise el fichero openkm.log del 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 llamados “text.extraction.threads” y “text.extraction.batch”.
• Abra la interfaz de administración en http://localhost:8080/openkm/management/ y ejecute un repository checker (esta acción puede tardar bastante en completarse).

Mover la licencia

Peligro

Coordine con el equipo de OpenKM para mover 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 documento nuevo.
• Descargue un documento ya existente.