Cómo moverse a otro servidor

Precaución

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

Linux

Consejo

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

Preliminares

• Asegúrese de tener suficiente espacio en disco en el nuevo servidor.
• Compruebe si 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 puede haberse elegido un usuario distinto 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 realicen cambios en el servidor antiguo. Por eso es buena práctica detener OpenKM.

Precaución

Si no quiere detener el servicio de OpenKM, establezca OpenKM como de 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 una 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

Eche un vistazo al fichero OpenKM.cfg. Todo el repositorio normalmente está en la carpeta TOMCAT_HOME, pero según su configuración puede estar en otra ubicación. Esta carpeta del repositorio también debe copiarse.

Eche un vistazo a 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, tendría que 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 (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 a la misma ubicación en el nuevo servidor y regístrelo como un 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 requeridas. Algunas están en la carpeta $TOMCAT_HOME/bin, así que ya se copiaron en pasos anteriores como parte de la carpeta TOMCAT_HOME.

Los paquetes mínimos requeridos son (más información en Installing on Ubuntu and Debian):

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

Iniciar el servicio de OpenKM

Precaución

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

• Si el nuevo servidor tiene menos RAM que el antiguo, compruebe el fichero $TOMCAT_HOME/bin/setenv.sh y ajústelo en consecuencia.
• Compruebe 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 comprobar 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 mucho 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 existente previamente.