Instalación en un Tomcat limpio

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

Preliminares

Consulte la instalación del sistema completo según su sistema operativo:

Instalar Tomcat

Descargue la última versión de Tomcat desde la página de Apache Tomcat (Tomcat 7 o 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 el Tomcat ya configurado por el equipo de OpenKM, que puede descargarse desde http://download.openkm.com/okm/Tomcat-7.0.61.zip

unicode.ttf
directorio sigar
mail-1.5.2.jar
activemq-all-5.13.2.jar
El driver correspondiente a su base de datos:
- MySQL: mysql-connector-java-5.1.12-bin.jar
- Oracle: ojdbc6-11.2.0.3.jar
- PostgreSQL: postgresql-9.1-902.jdbc4.jar
- SQL Server: sqljdbc4.jar
- Hypersonic: hsqldb.jar
- H2: h2-1.4.191.jar

Copie los siguientes archivos en TOMCAT_HOME:

OpenKM.cfg
OpenKM.xml
logback.xml

Modificar los archivos de configuración

Modifique los siguientes archivos de TOMCAT_HOME/conf:

context.xml

Añada la siguiente configuración dentro de la sección Context:

<!-- OpenKM resources -->
<ResourceLink global="jdbc/OpenKMDS" name="jdbc/OpenKMDS" type="javax.sql.DataSource"/>
<ResourceLink global="mail/OpenKM" name="mail/OpenKM" type="javax.mail.Session"/>

server.xml

Añada la siguiente configuración dentro de la sección GlobalNamingResources:

En caso de Tomcat 7

<Resource name="jdbc/OpenKMDS" auth="Container" type="javax.sql.DataSource"
          maxActive="100" maxIdle="30" maxWait="10000" validationQuery="select 1"
          username="openkm" password="*****" driverClassName="com.mysql.jdbc.Driver"
          url="jdbc:mysql://localhost:3306/okmdb?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"/>

<Resource name="mail/OpenKM" auth="Container" type="javax.mail.Session"
          mail.smtp.host="localhost" mail.from="testing@openkm.com"/>

En caso de Tomcat 8

<Resource name="jdbc/OpenKMDS" auth="Container" type="javax.sql.DataSource"
          maxTotal="100" maxIdle="30" maxWaitMillis="10000" validationQuery="select 1"
          username="openkm" password="*****" driverClassName="com.mysql.jdbc.Driver"
          url="jdbc:mysql://localhost:3306/okmdb?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"/>

<Resource name="mail/OpenKM" auth="Container" type="javax.mail.Session"
          mail.smtp.host="localhost" mail.from="testing@openkm.com"/>

Estos dos recursos corresponden a los de conexión a la base de datos y al servidor de correo. Los parámetros correspondientes deben adaptarse a cada base de datos (este ejemplo es para una base de datos mysql) y al servidor de correo correspondiente.

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 -Xms256m -Xmx2048m -XX:+UseConcMarkSweepGC -Djava.awt.headless=true"
JAVA_OPTS="$JAVA_OPTS -Dlog4j.configuration=file://$CATALINA_HOME/conf/log4j.properties"
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -Dmail.mime.ignoreunknownencoding=true"
CATALINA_PID=$CATALINA_HOME/catalina.pid
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CATALINA_HOME/lib/sigar

Y este es el contenido en el caso de Windows:

set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx2048m -XX:+UseConcMarkSweepGC -Djava.awt.headless=true
set JAVA_OPTS=%JAVA_OPTS% -Dlog4j.configuration=file:///%CATALINA_HOME%/conf/log4j.properties
set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -Dmail.mime.ignoreunknownencoding=true
set PATH=%PATH%;%CATALINA_HOME%\lib\sigar

Instalar OpenKM

Con Tomcat detenido, copie el archivo OpenKM.war en TOMCAT_HOME \webapps

$ cp 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.cfg

$ vim TOMCAT_HOME/OpenKM.cfg

Su archivo de configuración debería contener algo como esto:

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

# Logback configuration file
logback.config=logback.xml

Primer inicio de la aplicación:

$ start tomcat

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.