Instalación sobre un Tomcat limpio

Esta sección explica cómo desplegar OpenKM en un Apache Tomcat limpio (sin configurar previamente).

Preliminares

Consulte la instalación del sistema completo para su sistema operativo:

Installing on RedHat and CentOS (OLD)
Installing on Ubuntu and Debian (OLD)
Installing on Windows

Instalar Tomcat

Descargue la última versión de Tomcat ( Tomcat 9 ) desde la página de Apache Tomcat y extráigala en el directorio donde desea instalarla.

Una vez extraído Tomcat, son necesarias algunas modificaciones.

Copiar librerías y ficheros de configuración

Copie las siguientes librerías necesarias a TOMCAT_HOME/lib. Estos ficheros se pueden encontrar en la distribución de Tomcat ya configurada por el equipo de OpenKM, que puede descargarse de http://download.openkm.com/okm/tomcat-9.0.82.zip

unicode.ttf

Copie los siguientes ficheros a TOMCAT_HOME:

openkm.properties
logback.xml

Modificar ficheros de configuración

Modifique los siguientes ficheros en TOMCAT_HOME/conf:

setenv.sh o setenv.bat

Dependiendo de su sistema operativo, puede que tenga que crear un fichero llamado setenv.sh en Linux o setenv.bat en Windows. Este fichero debe colocarse en TOMCAT_HOME/bin. Este es el contenido en el caso de Linux:

JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx4096m -XX:+UseG1GC -XX:+UseStringDeduplication"
JAVA_OPTS="$JAVA_OPTS -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=$CATALINA_HOME"
JAVA_OPTS="$JAVA_OPTS -Djava.net.preferIPv4Stack=true -Dmail.mime.ignoreunknownencoding=true"
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -Djava.awt.headless=true"
JAVA_OPTS="$JAVA_OPTS -Dsun.java2d.cmm=sun.java2d.cmm.kcms.KcmsServiceProvider"
CATALINA_PID=$CATALINA_HOME/catalina.pid
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CATALINA_HOME/bin/cadviewer

Y este es el contenido en el caso de Windows:

set JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx4096m -XX:+UseG1GC -XX:+UseStringDeduplicationset JAVA_OPTS=%JAVA_OPTS% -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=%CATALINA_HOME%set JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=true -Dmail.mime.ignoreunknownencoding=trueset JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -Djava.awt.headless=trueset PATH=%PATH%;%CATALINA_HOME%\bin\cadviewer

Instalar OpenKM

Con Tomcat detenido, copie el fichero OpenKM.war a TOMCAT_HOME/webapps

$ mv openkm.war $TOMCAT_HOME/webapps

Instalar software de terceros

Para ello, vaya a la sección correspondiente a su sistema operativo:

Iniciar la aplicación

Comprobar los parámetros de openkm.properties

$ vim TOMCAT_HOME/openkm.properties

Su fichero de configuración debería contener algo así:

# OpenKM Hibernate configuration valuesspring.datasource.driver-class-name=com.mysql.jdbc.Driverspring.datasource.url=jdbc:mysql://localhost:3306/okmdb?autoReconnect=true&useUnicode=true&characterEncoding=UTF8&nullNamePatternMatchesAll=true&serverTimezone=Europe/Madridspring.datasource.username=openkmspring.datasource.password=openkm
# JPA stuffspring.jpa.hibernate.ddl-auto=createspring.jpa.properties.hibernate.dialect=com.openkm.db.dialect.MySQL5InnoDBDialect

# Logback configuration file
logback.config=logback.xml

Primer arranque de la aplicación:

$ start openkm

Cuando la aplicación arranca, debería ver estos mensajes de log:

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 usando el usuario okmAdmin y la contraseña admin. (¡No olvide cambiarla!) Para más información: Manage users and roles.