Instalación en Ubuntu y Debian (Manual)

Preliminares

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.
• https://www.safetydetectives.com/password-meter/

Comprobar si los canales de partners están habilitados

$ cat /etc/apt/sources.list

En caso de que no estén habilitados, por favor 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 el ulimit

$ sudo vim /etc/pam.d/su

descomente la siguiente línea

#session required pam_limits.so

por

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á 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

MySQL, en este caso, no se ha iniciado como servicio, y 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

MySQL, en este caso, 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 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

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 el paquete de OpenKM y Tomcat

$ cd /home/openkm
$ unzip openkm-6.3.2-community-tomcat-bundle.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 motivos 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
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

El script debe modificarse si utiliza otro usuario para iniciar el servicio o si su $TOMCAT_HOME no es /home/openkm/tomcat

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 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 otro archivo de idioma.
ClamAV	No	bash<br>$ apt-get install clamav<br>
Imagemagick	Sí	bash<br>$ apt-get install imagemagick<br>
Ghostscript	Yes	bash<br>$ apt-get install Ghostscript<br>

Iniciar la aplicación

Comprobar los parámetros de OpenKM.cfg

$ vim /home/openkm/tomcat/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/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 sobre Manage users and roles.

Configure las extensiones por defecto:

Vaya a Administration > 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 estándar 

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
• Configuring Tomcat memory utilization
• Configurar el puerto de Tomcat
• Configurar SSL/TLS en Tomcat
• Configurar la zona horaria de Tomcat

Reiniciar la instalación desde cero

El primer arranque de OpenKM realiza algunas configuraciones en segundo plano, como la creación de carpetas en el sistema de archivos y cambios en el OpenKM.cfg, que solo ocurren durante el primer arranque.

A veces puede haber algún error en la configuración de OpenKM, como por ejemplo una conexión incorrecta a la base de datos u otros problemas similares durante el primer arranque, lo que provoca un fallo en la aplicación. Para reiniciar la instalación desde cero, le sugerimos seguir los siguientes pasos.

1. Asegúrese de que OpenKM está detenido.
2. Edite el OpenKM.cfg y establezca el parámetro en hibernate.hbm2ddl=create
3. En caso de problemas con la conexión a la base de datos, le sugerimos comprobar el enlace desde el servidor de OpenKM. Recuerde que algunas bases de datos requieren habilitar al usuario para obtener conexión desde un servidor ( IP específica, rango de IP, cualquier servidor ).
4. Elimine la carpeta llamada “repository.”
5. Inicie OpenKM.