Instalación en RedHat y CentOS (Manual)

Peligro

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

No tiene mucho sentido instalar Redhat sin una suscripción con licencia en la misma línea y habilitar los repositorios de CentOS en un Redhat; si es su caso, es mejor instalar CentOS desde el principio.

Preliminares

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, intente instalar este paquete:

$ sudo yum install pciutils

Aumentar el ulimit

$ sudo vim /etc/security/limits.conf

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

Ejecute ulimit -n y compruebe que 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-b04)
OpenJDK 64-Bit Server VM (build 25.212-b04, mixed mode)

Precaución

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

Instalar Java

Nota

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

$ sudo yum install java-1.8.0-openjdk-devel

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.

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.

$ alternatives --config java

Instalar la base de datos

Instale MySQL si no lo tiene ya instalado:

$ sudo yum install mysql-server mysql

Configúrelo como un servicio:

$ sudo chkconfig --levels 235 mysqld on

Nota

En las últimas versiones de Centos, el paquete MySQL ha sido sustituido en los repositorios por MariaDB.

Instale MariaDB:

$ sudo yum install mariadb-server

Configúrelo como servicio:

$ sudo systemctl enable mariadb

Nota

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

Edite el archivo /etc/selinux/config:

$ sudo vim /etc/selinux/config

Y aplique este cambio:

'SELINUX=disabled'

Para que surta efecto inmediatamente, ejecute desde la línea de comandos:

$ sudo setenforce 0

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

En este caso, MySQL no se ha iniciado como servicio, y 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 mostrar algo como 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 chkconfig tomcat --level 2345 on

Comprobar el servicio

Inicie el servicio:

$ sudo service tomcat start

Detenga el servicio:

$ sudo service tomcat stop

Instalar software de terceros

Software	Requerido	Descripción
OpenOffice or LibreOffice	Yes	Compruebe que estos paquetes están presentes: - openoffice.org-ure-3.1.1-19.5.el5_5.6 - openoffice.org-headless-3.1.1-19.5.el5_5.6 - openoffice.org-pyuno-3.1.1-19.5.el5_5.6 Ejecute esta línea de comandos para comprobar los paquetes instalados: bash<br>$ rpm -qa | grep openoffice<br> Tome los nombres de los paquetes como orientación. Si no está instalado el paquete headless, OpenKM no puede iniciar el servicio soffice.
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>
Htop	No	Descargue desde http://pkgs.repoforge.org/htop/ bash<br>$ rpm -ivH htop-1.0.3-1.el6.rf.x86_64.rpm<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 comprobar 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, consulte: 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');

Resolución de problemas de Linux Oracle 7. X 

Las herramientas libreoffice y tesseract no están en los repositorios por defecto; puede seguir los pasos descritos en la URL siguiente para instalarlas:

Instalar LibreOffice desde RPM

Nota

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

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

Al final, Libreoffice quedará instalado en la carpeta /opt/libreoffice6.0

$ yum remove openoffice* libreoffice*
$ cd /opt
$ wget https://www.libreoffice.org/donate/dl/rpm-x86_64/6.0.4/es/LibreOffice_6.0.4_Linux_x86-64_rpm.tar.gz
$ tar -xvf LibreOffice_6.0.4_Linux_x86-64_rpm.tar.gz
$ cd LibreOffice_6.0.4_Linux_x86-64_rpm/RPMS
$ yum localinstall *.rpm

Instalar Tesseract

Nota

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

Antes de ejecutar el script, revíselo y considere aplicar cambios para descargar los diccionarios que necesite; por ejemplo, el diccionario en español debería descargarse en https://github.com/tesseract-ocr/tessdata/raw/3.04.00/spa.traineddata. ¿Qué no está presente en el script por defecto?

#!/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 habituales

OpenKM incluye una gran cantidad de parámetros de configuración. Le sugerimos consultar Recommended configuration parameters.

• 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 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.