Instalación en Ubuntu y Debian

Preliminares

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

$ df -h

Una vez verificado, cree el usuario “openkm”:

$ adduser openkm

Si Java 8 todavía no está instalado, instale lo siguiente:

$ apt install openjdk-8-jre

Por problemas de licencias, Java 8 no está disponible para instalar desde los repositorios de Debian, por lo que debe descargarlo e instalarlo desde Eclipse Temurin. Una vez descargado e instalado, ejecute este comando para instalar las dependencias que falten:

$ apt install -f

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

$ java -version
openjdk version "1.8.0_352"
OpenJDK Runtime Environment (build 1.8.0_352-8u352-ga-1~22.04-b08)
OpenJDK 64-Bit Server VM (build 25.352-b08, mixed mode)

En caso contrario, establezca Java 8 como versión por defecto:

$ update-alternatives --config java

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

$ apt install mariadb-server

Después, compruebe si el servicio MariaDB ya está iniciado:

$ systemctl status mariadb

Instalar 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 en modo texto, por lo que debe ejecutarlo desde la consola como root. Esto es así porque necesita instalar dependencias de paquetes y configurar OpenKM como un servicio:

$ java -jar OKMInstaller.jar

Recuerde consultar Uso del instalador en caso de utilizar un proxy para acceder a Internet.

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

$ java -version

En caso contrario, establézcala como la versión por defecto:

$ update-alternatives --config java

Una vez verificado, inicie los servicios necesarios:

$ systemctl start xvfb openkm

Puede comprobar el estado de estos servicios de esta forma:

$ systemctl status xvfb openkm

Más información en:

Lista de comprobación posterior a la instalación

Para verificar que la instalación se ha realizado correctamente, utilice esta lista de comprobación:

Verifique que el Java por defecto es Java 8.
Verifique que puede acceder a OpenKM desde otro equipo.
Intente iniciar sesión con el usuario y la contraseña por defecto okmAdmin / admin.
Suba un documento de 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 ejemplo 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