Instalación en RedHat y CentOS (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 describe cómo instalar OpenKM manualmente. Una herramienta instaladora de OpenKM realiza la mayor parte de los pasos de forma automática; encontrará más información en Uso del instalador.

Peligro

Si decide instalar Red Hat, tenga en cuenta que debe disponer de una versión de Red Hat con licencia; de lo contrario, los repositorios para instalar software estarán bloqueados.

Instalar Red Hat sin una suscripción tiene poco sentido. Apenas hay motivos para habilitar los repositorios de CentOS en un sistema Red Hat. Si ese es su planteamiento, es mejor instalar CentOS desde el principio.

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 del clúster
• Configuración del sharding

Comprobar el tamaño del disco

$ df -h

Crear un usuario llamado openkm

$ sudo adduser openkm

Nota

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

Comprobar la configuración del servidor

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

Precaución

Si no funciona, pruebe a instalar este paquete:

$ sudo yum install pciutils

Aumentar ulimit

$ 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

Ejecute limit -n y compruebe que los límites de ficheros abiertos están ahora actualizados.

Comprobar 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_352"
OpenJDK Runtime Environment (build 1.8.0_352-b08)
OpenJDK 64-Bit Server VM (build 25.352-b08, mixed mode)

Precaución

La numeración de la versión de Java puede diferir si ha actualizado a una versión principal más reciente.

Instalar Java

Nota

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

$ sudo yum install java-1.8.0-openjdk

Precaución

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

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

Nota

Realice este paso solo si Java 8 no es su versión de Java predeterminada.

$ alternatives --config Java

Instalar la base de datos

Instale MariaDB si aún no está instalado:

$ sudo yum install mariadb-server

Configúrelo como un servicio:

$ sudo systemctl enable mariadb

Nota

Si tiene problemas en el primer arranque de la base de datos porque no puede crear ficheros en la carpeta tmp, haga lo siguiente:

Edite el fichero /etc/SELinux/config:

$ sudo vim /etc/selinux/config

Aplique este cambio:

'SELINUX=disabled'

Para que surta efecto de inmediato, ejecute el siguiente comando:

$ sudo setenforce 0

Cambiar la contraseña de root de MariaDB

Haga esto solo si es necesario cambiar la contraseña de root de MariaDB.

Método 1

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

Método 2

$ sudo systemctl stop mariadb
$ 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, MariaDB no se inició como un servicio; es necesario terminar el proceso para detener MariaDB y así poder iniciarlo de nuevo como un servicio.

Método 3

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

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

Comprobar que InnoDB es el motor predeterminado de MariaDB

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

Consejo

Debería mostrar algo similar a esto:

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

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

$ vim /etc/mysql/my.cnf

Añada lo siguiente bajo [mysqld]:

default-storage-engine = InnoDB

Precaución

Tras cambiar el motor predeterminado de MariaDB, es necesario reiniciar el servicio de MariaDB para que el cambio 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.69.zip

Precaución

El número de versión de Tomcat puede diferir si actualiza a una versión principal más reciente.

Configurar Tomcat como un servicio

Precaución

Por motivos de seguridad, no debería ejecutar Tomcat como root. Es mejor utilizar el usuario ‘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:

$ sudo chkconfig openkm --level 2345 on

Comprobar el servicio

Inicie el servicio:

$ sudo service openkm start

Detenga el servicio:

$ sudo service openkm stop

Instalar 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

Instalar software de terceros

Software	Requerido	Descripción
LibreOffice	Sí	Ejecute el siguiente comando para comprobar los paquetes instalados: bash<br>$ rpm -qa | grep -i libreoffice<br> Utilice los nombres de los paquetes como guía. Si el paquete headless no está instalado, OpenKM no iniciará el servicio de ofimática.
Tesseract	No	Algunos enlaces útiles: - https://code.google.com/p/tesseract-ocr/wiki/Compiling - https://code.google.com/p/python-tesseract/wiki/HowToCompileForCentos - http://www.vicchiam.com/blog/?p=168
ClamAV	No	Algunos enlaces útiles: - http://www.clamav.net/doc/install.html#rhel
ImageMagick	Sí	bash<br>$ yum install ImageMagick<br>
GhostScript	Sí	bash<br>$ yum install ghostscript<br>
Top	No	Descárguelo desde http://pkgs.repoforge.org/htop/ bash<br>$ rpm -ivH htop-1.0.3-1.el6.rf.x86_64.rpm<br>

Abrir el puerto 8080

De forma predeterminada, este puerto está cerrado, por lo que es necesario abrirlo:

$ firewall-cmd --permanent --add-port 8080/tcp
$ firewall-cmd --reload

Más información en:

• Cómo abrir y cerrar puertos en RHEL 8 / CentOS 8 Linux

Iniciar la aplicación

Comprobar 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 arranque de la aplicación:

$ service tomcat start

Para comprobar si el proceso de arranque puede ejecutar el 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 estará 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 > Consulta a la base de datos 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 Linux Oracle 7.x

Precaución

Para los problemas de “OpenKM como servicio” e “ImageMagick”, consulte esta sección: Problemas en Red Hat y CentOS

Las herramientas LibreOffice y Tesseract no están en los repositorios predeterminados; puede seguir los pasos descritos en la siguiente URL para instalarlas:

Instalar LibreOffice desde RPM

Nota

Debe descargar la última versión del paquete RPM, que puede encontrar en https://www.libreoffice.org/download/download/?type=rpm-x86&version=6.0.4&lang=en

El proceso descrito a continuación está disponible en https://www.tecmint.com/install-libreoffice-on-rhel-centos-fedora-debian-ubuntu-linux-mint/

Instalar Tesseract

Nota

El script siguiente se ha obtenido de https://github.com/EisenVault/install-tesseract-redhat-centos/. Le sugerimos consultar la última versión del script en el proyecto de GitHub para ver las actualizaciones.

Antes de ejecutar el script, revíselo y considere modificarlo para descargar los diccionarios que necesite; por ejemplo, los diccionarios de español deben descargarse en https://github.com/tesseract-ocr/tessdata/raw/3.04.00/spa.traineddata. Estos no están presentes en el script de forma predeterminada.

#!/bin/sh

cd /opt

yum -y update
yum -y install libstdc++ autoconf automake libtool autoconf-archive pkg-config gcc gcc-c++ make libjpeg-devel libpng-devel libtiff-devel zlib-devel

#Install AutoConf-Archive
wget ftp://mirror.switch.ch/pool/4/mirror/epel/7/ppc64/a/autoconf-archive-2016.09.16-1.el7.noarch.rpm
rpm -i autoconf-archive-2016.09.16-1.el7.noarch.rpm

#Install Leptonica from Source
wget http://www.leptonica.com/source/leptonica-1.75.3.tar.gz
tar -zxvf leptonica-1.75.3.tar.gz
cd leptonica-1.75.3
./autobuild
./configure
make
make install
cd ..

#!/bin/sh

#Install Tesseract from Source
wget https://github.com/tesseract-ocr/tesseract/archive/3.05.01.tar.gz
tar -zxvf 3.05.01.tar.gz
cd tesseract-3.05.01
./autogen.sh
PKG_CONFIG_PATH=/usr/local/lib/pkgconfig LIBLEPT_HEADERSDIR=/usr/local/include ./configure --with-extra-includes=/usr/local/include --with-extra-libraries=/usr/local/lib
LDFLAGS="-L/usr/local/lib" CFLAGS="-I/usr/local/include" make
make install
ldconfig
cd ..

#Download and install tesseract language files
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/ben.traineddata
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/eng.traineddata
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/hin.traineddata
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/tha.traineddata
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/osd.traineddata
mv *.traineddata /usr/local/share/tessdata

#Download Hindi Cube data
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/hin.cube.bigrams
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/hin.cube.fold
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/hin.cube.lm
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/hin.cube.nn
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/hin.cube.params
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/hin.cube.word-freq
wget https://github.com/tesseract-ocr/tessdata/raw/3.04.00/hin.tesseract_cube.nn
mv hin.* /usr/local/share/tessdata

ln -s /opt/tesseract-3.05.01 /opt/tesseract-latest

Otras configuraciones adicionales estándar

OpenKM dispone de muchos parámetros de configuración; le sugerimos consultar Parámetros de configuración recomendados.

• Configuración del proxy inverso HTTP de Apache
• Configuración del correo
• Configuración del uso 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