Instalación en un Tomcat limpio

En esta sección se describe cómo desplegar OpenKM en un Apache Tomcat limpio.

Preliminares

Consulte las instrucciones de instalación según su sistema operativo:

Instalar 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 archivos de configuración

Copie las siguientes bibliotecas requeridas en TOMCAT_HOME/lib. Estos archivos se encuentran en la distribución de Tomcat ya configurada por el equipo de OpenKM, que puede descargarse desde https://sourceforge.net/projects/openkm/files/common/

unicode.ttf

Copie los siguientes archivos en TOMCAT_HOME:

openkm.properties
logback.xml

Modificar los archivos de configuración

Modifique los siguientes archivos de TOMCAT_HOME/conf:

setenv.sh o setenv.bat

Según su sistema operativo, debe crear un archivo llamado setenv.sh en Linux o setenv.bat en Windows. Este archivo debe ubicarse en TOMCAT_HOME/bin. Este es el contenido en el caso de 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 en el caso de 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

Instalar OpenKM

Con Tomcat detenido, copie el archivo OpenKM.war en 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 archivo 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 con el usuario: okmAdmin y la contraseña: admin (no olvide cambiarla). Para más información: Gestionar usuarios y roles.