Instalación en Ubuntu y Debian (manual)

Peligro

Esta página contiene información obsoleta y se eliminará en un futuro próximo.

Precaución

Esta sección de la documentación intenta describir cómo instalar OpenKM manualmente. Una herramienta instaladora de OpenKM realiza automáticamente la mayor parte de los pasos; más información en Uso del instalador.

Preliminares

Precaución

Si tiene previsto configurar OpenKM en un modelo de clúster o de sharding, lea las siguientes secciones antes de iniciar el proceso de instalación:

• Configuración de clúster
• Configuración de sharding

Compruebe el tamaño del disco

$ df -h

Cree un usuario llamado openkm

$ sudo adduser openkm

Nota

Puede generar fácilmente contraseñas aleatorias en https://www.random.org/passwords.

Compruebe si los canales de socios (partners) están habilitados

$ cat /etc/apt/sources.list

Si no están habilitados, habilítelos.

$ sudo vim /etc/apt/sources.list
$ sudo apt-get update

Compruebe la configuración del servidor

$ wget -Nc smxi.org/inxi
$ sudo chmod +x inxi
$ sudo ./inxi -F

Aumente el límite

$ sudo vim /etc/pam.d/su

Descomente la siguiente línea

#session required pam_limits.so

para que quede

session required pam_limits.so

$ sudo vim /etc/security/limits.conf

Añada las siguientes líneas al final del fichero (antes de la línea # End of file)

* soft nofile 6084

* hard nofile 6084

Precaución

Ahora reinicie el servidor, ejecute ulimit -n, y compruebe si se han actualizado los límites de ficheros abiertos.

Comprobación de la versión de Java

$ java -version

Si Java está correctamente instalado en su equipo, se muestran el nombre y la versión de la máquina virtual de Java:

openjdk version "1.8.0_212"
OpenJDK Runtime Environment (build 1.8.0_212-8u212-b03-0ubuntu1.18.04.1-b03)
OpenJDK 64-Bit Server VM (build 25.212-b03, mixed mode)

Precaución

La versión de Java puede diferir según la versión que tenga instalada, pero recomendamos la última versión 1.8.

Instalación de Java

Nota

Realice estos pasos únicamente si Java 8 no está ya instalado en su servidor.

Precaución

En Ubuntu 20.04, es posible que OpenJDK-8-JDK no esté disponible en los repositorios predeterminados; si es así, pruebe a ejecutar el siguiente comando:

$> add-apt-repository universe

Para Ubuntu

$ sudo apt-get update
$ sudo apt-get install openjdk-8-jdk

Para Debian

$ su -
$ apt-get update
$ apt-get install openjdk-8-jdk
$ exit

En el caso de Debian 10 “Buster”, los paquetes de Java 8 no están incluidos en los repositorios predeterminados. Por lo tanto, puede que deba cambiar a SID (no recomendado para servidores de producción) o utilizar los paquetes de https://adoptopenjdk.net/. Ejecute estos comandos como root:

$ apt install wget gnupg software-properties-common
$ wget -qO - https://adoptopenjdk.jfrog.io/adoptopenjdk/api/gpg/key/public | apt-key add -
$ add-apt-repository --yes https://adoptopenjdk.jfrog.io/adoptopenjdk/deb/
$ apt-get update
$ apt-get install adoptopenjdk-8-hotspot

Establezca OpenJDK 1.8 como su versión de Java predeterminada.

Nota

Haga esto únicamente si Java 8 no es su versión de Java predeterminada.

$ sudo update-alternatives --config java

Instalación de la base de datos

Instale MySQL si no lo tiene ya instalado:

$ sudo apt-get install mysql-server

Al instalar MySQL, el instalador le pedirá una contraseña para el usuario root. Tenga esta contraseña a mano.

También puede instalar MariaDB, que sustituye a MySQL en las últimas versiones:

$ sudo apt-get install mariadb-server

Cambie la contraseña de root de MySQL

Haga esto únicamente si es necesario cambiar la contraseña de root de MySQL.

Método 1

$ /usr/bin/mysqladmin -u root -h localhost password 'password.'

Método 2

$ sudo /etc/init.d/mysql stop
$ sudo mysqld --skip-grant-tables &
$ mysql -u root MySQL
> UPDATE user SET Password=PASSWORD('YOURNEWPASSWORD') WHERE User='root';
> FLUSH PRIVILEGES;
> exit;

Precaución

En este caso, MySQL no se está ejecutando como servicio; debe matar el proceso para detener MySQL y volver a iniciarlo después como servicio.

Método 3

$ mysql
> UPDATE mysql.user SET Password=PASSWORD('MyNewPass') WHERE User='root';
> flush privileges;

Método 4

$ sudo /etc/init.d/mysql stop
$ mysqld_safe --skip-grant-tables &
$ mysql -u root mysql
> UPDATE user SET Password=PASSWORD('YOURNEWPASSWORD') WHERE User='root';
> FLUSH PRIVILEGES;
> exit;

Precaución

En este caso, MySQL no se está ejecutando como servicio; debe matar el proceso para detener MySQL y volver a iniciarlo después como servicio.

Más información en MySQL: Resetting permissions.

Compruebe que InnoDB es el motor predeterminado de MySQL

$ mysql -h localhost -u root -p
> show engines;

Consejo

Debería verse algo parecido a esto:

| InnoDB | DEFAULT | Supports transactions, row-level locking, and foreign keys | YES | YES | YES |

Si no es el predeterminado, modifique /etc/mysql/my.cnf

$ vim /etc/mysql/my.cnf

En la sección [mysqld], añada

default-storage-engine = innodb

Precaución

Tras cambiar el motor predeterminado de MySQL, es necesario reiniciar el servicio MySQL para que el cambio surta efecto.

Cree la base de datos

CREATE DATABASE okmdb DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_bin;
CREATE USER openkm@localhost IDENTIFIED BY 'password';
GRANT ALL ON okmdb.* TO openkm@localhost WITH GRANT OPTION;

Instalación de Tomcat

$ cd /home/openkm
$ unzip Tomcat-8.5.69.zip

Precaución

La numeración de versiones de Tomcat puede variar al actualizar a una versión mayor.

Configuración de Tomcat como servicio

Precaución

Por motivos de seguridad, no debería ejecutar Tomcat como root. Es mejor utilizar el usuario llamado openkm.

Cree un fichero con el script:

$ sudo vim /etc/init.d/openkm

#!/bin/sh

### BEGIN INIT INFO
# Provides:          tomcat
# Required-Start:    $remote_fs $syslog
# Required-Stop:     $remote_fs $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Start and stop Apache Tomcat
# Description:       Enable Apache Tomcat service provided by daemon.
### END INIT INFO

ECHO=/bin/echo
TEST=/usr/bin/test
TOMCAT_USER=openkm
TOMCAT_HOME=/home/openkm/tomcat-8.5.69
TOMCAT_START_SCRIPT=$TOMCAT_HOME/bin/startup.sh
TOMCAT_STOP_SCRIPT=$TOMCAT_HOME/bin/shutdown.sh

$TEST -x $TOMCAT_START_SCRIPT || exit 0
$TEST -x $TOMCAT_STOP_SCRIPT || exit 0

start() {
    $ECHO -n "Starting Tomcat"
    su - $TOMCAT_USER -c "$TOMCAT_START_SCRIPT &"
    $ECHO "."
}

stop() {
    $ECHO -n "Stopping Tomcat"
    su - $TOMCAT_USER -c "$TOMCAT_STOP_SCRIPT 60 -force &"
    while [ "$(ps -fu $TOMCAT_USER | grep java | grep tomcat | wc -l)" -gt "0" ]; do
        sleep 5; $ECHO -n "."
    done
    $ECHO "."
}

case "$1" in
    start)
        start
        ;;
    stop)
        stop
        ;;
    restart)
        stop
        sleep 30
        start
        ;;
    *)
        $ECHO "Usage: tomcat {start|stop|restart}"
        exit 1
esac
exit 0

Precaución

Debe modificar el script si utiliza otro usuario para iniciar el servicio o si su $TOMCAT_HOME no es /home/openkm/tomcat-8.5.69

Hágalo ejecutable:

$ sudo chmod 755 /etc/init.d/openkm

Actualice los niveles de ejecución (run-levels):

$ sudo update-rc.d openkm defaults

Compruebe el servicio

Inicie el servicio:

$ sudo service openkm start

Detenga el servicio:

$ sudo service openkm stop

Instalación de OpenKM

Con Tomcat detenido, copie el fichero openkm.war en /home/openkm/tomcat-8.5.69/webapps

$ cp openkm.war /home/openkm/tomcat-8.5.69/webapps

Instalación de software de terceros

Software	Requerido	Comando
LibreOffice	Yes	bash<br>$ apt-get install libreoffice<br>
Tesseract	No	bash<br>$ apt-get install tesseract-ocr tesseract-ocr-eng<br> Dependiendo de su configuración regional, puede que desee instalar otro fichero de idioma.
ClamAV	No	bash<br>$ apt-get install ClamAV<br>
ImageMagick	Yes	bash<br>$ apt-get install imagemagick<br>
Ghostscript	Yes	bash<br>$ apt-get install ghostscript<br>

Inicio de la aplicación

Compruebe los parámetros de openkm.properties

$ vim /home/openkm/tomcat-8.5.69/openkm.properties

Su configuración debería ser similar a esta:

# OpenKM Hibernate configuration values
spring.jpa.properties.hibernate.dialect=com.openkm.db.dialect.MySQL5InnoDBDialect
spring.jpa.hibernate.ddl-auto=create-only

Precaución

Asegúrese de que spring.jpa.properties.hibernate.dialect=com.openkm.db.dialect.MySQL5InnoDBDialect esté habilitado si su base de datos es MySQL.

Primer inicio de la aplicación:

$ service tomcat start

Para ver el proceso de arranque, ejecute el siguiente comando:

$ tail -f /home/openkm/tomcat-8.5.69/log/catalina.log

Cuando la aplicación se haya iniciado, verá en el fichero de registro las líneas:

2015-07-04 18:28:10,680 [main] INFO  org.apache.coyote.http11.Http11Protocol - Starting ProtocolHandler ["http-bio-0.0.0.0-8080"]
2015-07-04 18:28:10,688 [main] INFO  org.apache.coyote.ajp.AjpProtocol - Starting ProtocolHandler ["ajp-bio-127.0.0.1-8009"]
2015-07-04 18:28:10,692 [main] INFO  org.apache.catalina.startup.Catalina - Server startup in 41456 ms

La aplicación será accesible en http://YOUR_IP:8080/OpenKM con el usuario okmAdmin y la contraseña admin. (¡No olvide cambiarla!) Para más información, consulte Gestión de usuarios y roles.

Configure las extensiones predeterminadas:

Vaya a Administration > Utilities > Database query y ejecute:

INSERT INTO OKM_EXTENSION (EXT_UUID, EXT_NAME) VALUES ('808e7a42-2e73-470c-ba23-e4c9d5c3a0f4', 'Live Edit');
INSERT INTO OKM_EXTENSION (EXT_UUID, EXT_NAME) VALUES ('58392af6-2131-413b-b188-1851aa7b651c', 'HTML Editor 4');
INSERT INTO OKM_PROFILE_MSC_EXTENSION (PEX_ID, PEX_EXTENSION) VALUES (1, '808e7a42-2e73-470c-ba23-e4c9d5c3a0f4');
INSERT INTO OKM_PROFILE_MSC_EXTENSION (PEX_ID, PEX_EXTENSION) VALUES (1, '58392af6-2131-413b-b188-1851aa7b651c');

Resolución de problemas

En el caso de Debian 10, cómo instalar Java:

$ apt-get install software-properties-common
$ apt-add-repository 'deb http://security.debian.org/debian-security stretch/updates main'
$ apt-get update
$ apt-get install openjdk-8-jdk

Otras configuraciones adicionales estándar

OpenKM incluye una gran cantidad de parámetros de configuración. Asegúrese de revisar: Parámetros de configuración recomendados.

• Configuración de Apache HTTP como proxy inverso
• Configuración del correo
• Configuración de la utilización de memoria de Tomcat
• Configuración del puerto de Tomcat
• Configuración de SSL/TLS en Tomcat
• Configuración de la zona horaria de Tomcat