Instalación en un Tomcat limpio

Esta sección describe cómo desplegar OpenKM en un Apache Tomcat limpio.

Preliminares

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

Instalación de Tomcat

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

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

Copiar las bibliotecas y los ficheros de configuración

Copie las siguientes bibliotecas necesarias en TOMCAT_HOME/lib. Estos ficheros se encuentran en el paquete de Tomcat ya configurado por el equipo de OpenKM, que puede descargarse desde http://download.openkm.com/okm/tomcat-8.5.69.zip

unicode.ttf

Copie los siguientes ficheros en TOMCAT_HOME:

openkm.properties
logback.xml

Modificar los 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 para Linux:

JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx2048m -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 para Windows:

set JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx2048m -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

Instalación de OpenKM

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

$ mv openkm.war $TOMCAT_HOME/webapps

Instalar el 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 como esto:

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

# Logback configuration file
logback.config=logback.xml

Primer inicio de la aplicación:

$ start openkm

Cuando la aplicación se inicie, debería ver estos mensajes de registro:

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 utilizando el usuario: okmAdmin con la contraseña: admin. ¡No olvide cambiarla! Para más información: Gestión de usuarios y roles.