Instalación en Ubuntu y Debian (manual)

Preliminares

Precaución

En caso de configurar OpenKM en modo clúster, antes de comenzar con el proceso de instalación lea las secciones:

• Configuración de clúster

Comprobar el tamaño del disco

$ df -h

Crear un usuario llamado openkm

$ sudo adduser openkm

Nota

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

Comprobar si los canales de partners están habilitados

$ cat /etc/apt/sources.list

En caso de que no estén habilitados, habilítelos.

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

Comprobar la configuración del servidor

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

Aumentar ulimit

$ 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

y añada las siguientes líneas al final del archivo (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 los límites de archivos abiertos se han actualizado.

Comprobar la versión de Java

$ java -version

Si Java está correctamente instalado en su equipo, se mostrará 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 ser diferente según la que tenga instalada, pero siempre recomendamos la última versión 1.8.

Instalar Java

Nota

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

En el caso de Ubuntu

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

En el caso de Debian

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

Establecer OpenJDK 1.8 como su versión de Java por defecto

Nota

Realice esto solo si Java 8 no es su versión de Java por defecto.

$ sudo update-alternatives --config java

Instalar 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. Téngala a mano.

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

$ sudo apt-get install mariadb-server

Cambiar la contraseña de root de MySQL

Hágalo solo 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 ha iniciado como servicio. Debe matarse el proceso para detener MySQL y volver a iniciarlo 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 ha iniciado como servicio. Debe matarse el proceso para detener MySQL y volver a iniciarlo como servicio

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

Comprobar que InnoDB es el motor por defecto de MySQL

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

Consejo

Debería verse algo como esto:

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

Si no es el motor por defecto, modifique /etc/mysql/my.cnf

$ vim /etc/mysql/my.cnf

y bajo [mysqld] añada

default-storage-engine = innodb

Precaución

Tras cambiar el motor por defecto de MySQL, debe reiniciarse el servicio MySQL para que surta efecto.

Crear 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;

Instalar Tomcat

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

Precaución

El nombre con la numeración de versión de Tomcat puede variar al actualizar a una versión mayor.

Configurar Tomcat como servicio

Precaución

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

Cree un archivo con el script:

$ sudo vim /etc/init.d/tomcat

#!/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.24
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.24

Hágalo ejecutable:

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

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

$ sudo update-rc.d tomcat defaults

Comprobar el servicio

Inicie el servicio:

$ sudo service tomcat start

Detenga el servicio:

$ sudo service tomcat stop

Instalar OpenKM

Con Tomcat detenido, copie el archivo OpenKM.war en /home/openkm/tomcat-8.5.24/webapps

$ cp OpenKM.war /home/openkm/tomcat-8.5.24/webapps

Instalar software de terceros

Software	Requerido	Comando
LibreOffice u OpenOffice	Sí	bash<br>$ apt-get install libreoffice<br>
Tesseract	No	bash<br>$ apt-get install tesseract-ocr tesseract-ocr-eng<br> Según su configuración regional, quizá desee instalar otros archivos de idioma.
Clamav	No	bash<br>$ apt-get install clamav<br>
Imagemagick	Sí	bash<br>$ apt-get install imagemagick<br>
Ghostscript	Sí	bash<br>$ apt-get install ghostscript<br>

Iniciar la aplicación

Comprobar los parámetros de OpenKM.cfg

$ vim /home/openkm/tomcat-8.5.24/OpenKM.cfg

Su configuración debería ser algo como esto:

# OpenKM Hibernate configuration values
hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect
hibernate.hbm2ddl=create

Precaución

Asegúrese de que hibernate.dialect=org.hibernate.dialect.MySQL5Dialect está habilitado si su base de datos es MySQL.

Primer inicio de la aplicación:

$ service tomcat start

Para ver el proceso de arranque puede ejecutar el comando:

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

Cuando la aplicación se haya iniciado, verá en el archivo 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 Gestionar usuarios y roles.

Configure las extensiones por defecto:

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');

Otras configuraciones adicionales habituales

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

• Configurar Apache HTTP Reverse-Proxy
• Configurar el correo
• Configurar el uso de memoria de Tomcat
• Configurar el puerto de Tomcat
• Configurar SSL/TLS en Tomcat
• Configurar la zona horaria de Tomcat