Instalación en Windows

Preliminares

Compruebe que dispone de suficiente espacio en disco.

Recomendamos instalar estas herramientas:

Geany (editor de texto).
mTail (programa de Windows que funciona como el comando “tail” de Unix).

Comprobar la versión de Java

C:\> java -version

Si Java está correctamente instalado en su equipo, se mostrará el nombre y la versión de la máquina virtual de Java:

java version "1.8.0_101"
Java(TM) SE Runtime Environment (build 1.8.0_101-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.101-b13, mixed mode)

También recomendamos establecer la variable JAVA_HOME:

setx JAVA_HOME "C:\Program Files\Java\jdk1.8.0_101" /M

Instalar Java

Si la versión requerida de Java no está instalada en su equipo:

Descárguela desde el sitio web de Oracle (Java 8) y elija la plataforma adecuada para su hardware y su versión de Windows.
Ejecute el archivo .exe descargado y siga las instrucciones que aparecen.

Instalar la base de datos

Instale MySQL si no lo tiene ya instalado:

Descargue el instalador MSI de MySQL desde MySQL Community Server y siga los pasos del asistente de instalación.

Comprobar que InnoDB es el motor por defecto de MySQL

show engines;

Si no es el motor por defecto, modifique c:\ProgramData\MySQL\MySQL Server 5.6\my.ini

y bajo [mysqld] añada

default-storage-engine = innodb

Crear la base de datos

CREATE DATABASE okmdb DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_bin;
CREATE USER openkm@localhost IDENTIFIED BY 'password';
GRANT ALL ON okmdb.* TO openkm@localhost WITH GRANT OPTION;

Instalar Tomcat

Descomprima Tomcat-7.0.61.zip en c:\

Copie los archivos de C:\tomcat-7.0.61\bin\x86 o de C:\tomcat-7.0.61\bin\x64 a C:\tomcat-7.0.61\bin, según la arquitectura del servidor.

Configurar Tomcat como servicio

Registre el servicio:

cd c:\tomcat-7.0.61\bin
service.bat install

Establezca los parámetros de la JVM para el servicio de Tomcat:

cd c:\tomcat-7.0.61\bin
openkm //US//OpenKM ++JvmOptions="-XX:+UseG1GC"
openkm //US//OpenKM ++JvmOptions="-Djava.awt.headless=true"
openkm //US//OpenKM ++JvmOptions="-Djava.net.preferIPv4Stack=true"
openkm //US//OpenKM ++JvmOptions="-Dfile.encoding=utf-8"
openkm //US//OpenKM ++JvmOptions="-Dsun.jnu.encoding=UTF-8"
openkm //US//OpenKM ++JvmOptions="-Dmail.mime.ignoreunknownencoding=true"

Ejecute tomcat7w.exe como administrador:

Compruebe los parámetros de configuración:

Comprobar el servicio

Desde el terminal

Inicie el servicio:

$ net start tomcat7

Detenga el servicio:

$ net stop tomcat7

Desde el panel de servicios de Windows

Desde la herramienta tomcat7w

Configurar las variables de entorno

Añada a la variable de entorno path la carpeta sigar y la carpeta bin:

setx PATH "%PATH%;C:\tomcat-7.0.61\lib\sigar" /M
setx PATH "%PATH%;C:\tomcat-7.0.61\bin" /M

Estas operaciones también pueden hacerse desde las variables de entorno de Windows:

Añada la ruta de la carpeta sigar - c:\tomcat-7.0.61\lib\sigar\ - a su variable de entorno path:

Instalar OpenKM

Con Tomcat detenido, copie el archivo OpenKM.war en /home/openkm/tomcat-7.0.61/webapps

$ copy OpenKM.war c:\tomcat-7.0.61\webapps

Instale el software de terceros:

Software	Requerido	Descripción
OpenOffice	Sí	Recomendamos utilizar OpenOffice en lugar de Libreoffice, porque hemos encontrado problemas en algunos servidores al configurarlo como servicio desde OpenKM.
Tesseract	No	Descargue desde https://code.google.com/p/tesseract-ocr/ y siga el asistente de instalación.
Clamav	No	Descargue desde http://www.clamav.net/download.html y siga el asistente de instalación.
Imagemagick	No	El paquete de Tomcat incluye la herramienta convert integrada. Si decide instalarlo, vaya a http://www.imagemagick.org/script/binary-releases.php, descargue la última versión binaria y siga el asistente de instalación. Tenga en cuenta que 16 bits necesita más recursos de hardware que 8 bits. Sugerimos ImageMagick-6.9.1-7-Q8-x64-dll.exe en lugar de ImageMagick-6.9.1-7-Q16-x64-dll.exe (tenga en cuenta que la numeración de versión puede ser distinta debido a las actualizaciones de ImageMagick).
GhostScript	No	El paquete de Tomcat incluye la herramienta Ghostscript integrada. Si decide instalarlo, vaya a http://ghostscript.com/download/gsdnld.html y siga el asistente de instalación.

Iniciar la aplicación

Comprobar los parámetros de OpenKM.cfg

C:\> geany c:\openkm\OpenKM.cfg

Su configuración debería ser algo como esto:

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

# Initial configuration - Windows
system.openoffice.path=C:/Program Files (x86)/OpenOffice 4

Primer inicio de la aplicación:

$ net start tomcat7

Cuando la aplicación se haya iniciado, lo verá en el archivo de registro con las líneas:

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.

Configure las extensiones por defecto:

Vaya a Administration > Utilities > Database query y ejecute:

INSERT INTO OKM_EXTENSION (EXT_UUID, EXT_NAME) VALUES ('808e7a42-2e73-470c-ba23-e4c9d5c3a0f4', 'Live Edit');
INSERT INTO OKM_EXTENSION (EXT_UUID, EXT_NAME) VALUES ('58392af6-2131-413b-b188-1851aa7b651c', 'HTML Editor 4');
INSERT INTO OKM_PROFILE_MSC_EXTENSION (PEX_ID, PEX_EXTENSION) VALUES (1, '808e7a42-2e73-470c-ba23-e4c9d5c3a0f4');
INSERT INTO OKM_PROFILE_MSC_EXTENSION (PEX_ID, PEX_EXTENSION) VALUES (1, '58392af6-2131-413b-b188-1851aa7b651c');

Otras configuraciones adicionales habituales

OpenKM incluye una gran cantidad de parámetros de configuración; consulte: Parámetros de configuración recomendados.