Instalación en RedHat y CentOS

Preliminares

Asegúrese de tener suficiente espacio en disco para instalar OpenKM y almacenar el repositorio de documentos:

$ df -h

Una vez comprobado, cree el usuario “openkm”:

$ adduser openkm

Si Java 11 todavía no está instalado, instálelo con:

$ yum install java-1.11.0-openjdk

OpenKM actualmente solo funciona con Java 11, así que una vez completado el proceso de instalación, verifique que la versión por defecto sea Java 11:

# java -version
openjdk version "11.0.20.1" 2023-08-24
OpenJDK Runtime Environment (build 11.0.20.1+1)
OpenJDK 64-Bit Server VM (build 11.0.20.1+1, mixed mode, sharing)

Si no lo es, establezca Java 11 como la versión por defecto:

$ update-alternatives --config java

Si no tiene ninguna otra preferencia de base de datos, sugerimos instalar MariaDB:

$ yum install mariadb-server

Después, habilite e inicie el servicio de MariaDB:

$ systemctl enable mariadb
$ systemctl start mariadb

Instalando OpenKM

Puede elegir entre instalar OpenKM en “/home/openkm” o en “/opt”. En cualquier caso, vaya a la ruta elegida y descargue el instalador.

Es un instalador basado en texto, así que debe ejecutarlo desde la consola como root. Esto se debe a que necesita instalar dependencias de paquetes y configurar OpenKM como un servicio:

$ java -jar OKMInstaller.jar

Recuerde consultar Using the installer si está usando un proxy para acceder a Internet.

Cuando el proceso de instalación haya finalizado, asegúrese de que Java 8 sea la versión por defecto:

$ java -version

Si no lo es, establézcala como predeterminada:

$ update-alternatives --config java

Una vez comprobado, inicie los servicios necesarios:

$ systemctl start xvfb openkm

Puede verificar el estado de estos servicios de esta forma:

$ systemctl status xvfb openkm

Más información en:

Habilitar el acceso remoto

Red Hat no permite conexiones al puerto 8080 por defecto, así que necesita abrir este puerto en el firewall:

$ firewall-cmd --zone=public --permanent --add-port=8080/tcp
$ firewall-cmd --reload

Checklist posterior a la instalación

Para verificar que la instalación se ha realizado correctamente, use esta checklist:

Verifique que el Java por defecto es Java 11.
Verifique que puede acceder a OpenKM desde otro equipo.
Intente iniciar sesión con el usuario y contraseña por defecto okmAdmin / admin.
Suba un documento Word y compruebe si se genera la miniatura y se muestra la vista previa.

Resolución de problemas

Si tiene un problema con la generación de miniaturas, verifique que tiene instalado el paquete ImageMagick y que la aplicación “convert” funciona.

Descargue una imagen de muestra desde Sample PNG Image e intente generar una miniatura:

$ wget https://www.sample-videos.com/img/Sample-png-image-1mb.png
$ convert -thumbnail '80x80>' -background 'white' -flatten Sample-png-image-1mb.png sample-output.png