Instalación en RedHat y CentOS (manual)

Preliminares

Comprobar el tamaño del disco

$ df -h

Crear un usuario llamado openkm

$ sudo adduser openkm

Comprobar la configuración del servidor

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

Aumentar 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

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)

Instalar Java

$ sudo yum install java-1.8.0-openjdk-devel

Establecer OpenJDK 1.8 como 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 servicio:

$ sudo chkconfig --levels 235 mysqld on

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

Inicie la base de datos:

$ sudo systemctl start mariadb

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;

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;

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;

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

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-7.0.61.zip

Configurar Tomcat como servicio

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

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 OpenKM

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

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

Instalar software de terceros

Software	Requerido	Descripción
OpenOffice o LibreOffice	Sí	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 este comando para comprobar los paquetes instalados: `bash<br>$ rpm -qa \| grep openoffice<br>` Tome los nombres de los paquetes como orientación. Si el paquete headless no está instalado, OpenKM no podrá 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-7.0.61/OpenKM.cfg

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

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

Primer inicio de la aplicación:

$ service tomcat start

Para comprobar el proceso de arranque puede ejecutar el comando:

$ tail -f /home/openkm/tomcat-7.0.61/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');

Resolución de problemas en Oracle Linux 7.X

Las herramientas libreoffice y tesseract no están en los repositorios por defecto; puede seguir los pasos descritos a continuación para instalarlas:

Instalar libreoffice desde RPM

$ 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

#!/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: Parámetros de configuración recomendados.