Instalación en un Tomcat limpio

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

Preliminares

Eche un vistazo a la instalación del sistema completo para su sistema operativo:

• Installing on RedHat and CentOS (ANTIGUA)
• Installing on Ubuntu and Debian (ANTIGUA)
• Installing on Windows

Instalando Tomcat

Descargue la última versión de Tomcat ( Tomcat 9 ) desde la página de Apache Tomcat y extráigala en el directorio donde quiera 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 encuentran en la distribución de Tomcat ya configurada por el equipo de OpenKM, que puede descargarse desde http://download.openkm.com/okm/tomcat-9.0.82.zip

• unicode.ttf

Copie los siguientes ficheros a 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 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

Instalando OpenKM

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

$ mv openkm.war $TOMCAT_HOME/webapps

Instalar software de terceros

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

• Installing on WindowsInstalling on Ubuntu and Debian
• Installing on RedHat and CentOS
• Installing on Windows

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

Precaución

Esta configuración funciona si su base de datos es MySQL. Si no, consulte la documentación o abra un ticket de soporte.

Primer arranque de la aplicación:

$ start openkm

Nota

Use mTail u otro programa equivalente para vigilar el fichero TOMCAT_HOME\log\openkm.log.

Cuando la aplicación arranque, 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!) Más información: Manage users and roles.