Installing on Windows

Preliminares

Compruebe que dispone de suficiente espacio en disco.

Recomendamos instalar estas herramientas:

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

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:

openjdk version "11.0.20.1"
OpenJDK Runtime Environment
OpenJDK 64-Bit Server VM

También recomendamos establecer la variable JAVA_HOME:

setx JAVA_HOME "C:\Program Files\Java\jdk11.0.20.1" /M

Instalar Java

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

Descárguela del sitio web de Microsoft y elija la plataforma adecuada para su hardware y versión de Windows.
Ejecute el fichero MSI y siga las instrucciones que se muestran.

Instalar la base de datos

Instale MySQL si aún no lo tiene 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 8.0.34\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-9.0.76.zip en c:\

Configurar Tomcat como servicio

Registrar el servicio:

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

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

cd c:\tomcat-9.0.76\bin
openkm //US//OpenKM ++JvmOptions="-Xms1024m"
openkm //US//OpenKM ++JvmOptions="-Xmx4096m"
openkm //US//OpenKM ++JvmOptions="-XX:+UseG1GC"
openkm //US//OpenKM ++JvmOptions="-XX:+UseStringDeduplication"
openkm //US//OpenKM ++JvmOptions="-XX:+HeapDumpOnOutOfMemoryError"
openkm //US//OpenKM ++JvmOptions="-XX:HeapDumpPath=%CATALINA_HOME%"
openkm //US//OpenKM ++JvmOptions="-Djava.net.preferIPv4Stack=true"
openkm //US//OpenKM ++JvmOptions="-Dmail.mime.ignoreunknownencoding=true"
openkm //US//OpenKM ++JvmOptions="-Dfile.encoding=UTF-8"
openkm //US//OpenKM ++JvmOptions="-Dsun.jnu.encoding=UTF-8"
openkm //US//OpenKM ++JvmOptions="-Djava.awt.headless=true"
openkm //US//OpenKM ++JvmOptions="-Dsun.java2d.cmm=sun.java2d.cmm.kcms.KcmsServiceProvider"

Ejecute openkmw.exe como administrador:

Compruebe los parámetros de configuración:

Comprobar el servicio

Desde la terminal

Iniciar el servicio:

$ net start OpenKM

Detener el servicio:

$ net stop OpenKM

Desde el panel de servicios de Windows

Desde la herramienta openkmw

Configurar variables de entorno

Añada la carpeta bin a la variable de entorno PATH:

setx PATH "%PATH%;C:\tomcat-9.0.76\bin" /M

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

Instalar OpenKM

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

$ copy openkm.war c:\tomcat-9.0.76\webapps

Instale software de terceros:

Software	Requerido	Descripción
LibreOffice	Sí	Recomendamos usar LibreOffice porque es compatible con los formatos de Microsoft Office.
Tesseract	No	Descárguelo de https://tesseract-ocr.github.io/tessdoc/Installation.html y siga el asistente de instalación.
ClamAV	No	Descárguelo de http://www.clamav.net/download.html y siga el asistente de instalación.
ImageMagick	No	El paquete de Tomcat incluye una 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 las versiones de 16 bits necesitan más recursos de hardware que las de 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 variar por actualizaciones de ImageMagick).
GhostScript	No	El paquete de Tomcat incluye una herramienta Ghostscript integrada. Vaya a http://ghostscript.com/download/gsdnld.html y siga el asistente de instalación si decide instalarlo.

Iniciar la aplicación

Comprobar los parámetros de openkm.properties

C:\> geany c:\openkm\openkm.properties

Su configuración debería ser algo así:

# OpenKM Hibernate configuration values
hibernate.dialect=com.openkm.db.dialect.MySQL5InnoDBDialect
hibernate.hbm2ddl=create-only

# Initial configuration - Windows
system.libreoffice.path=C:/Program Files (x86)/LibreOffice

Primer inicio de la aplicación:

$ net start OpenKM

Cuando la aplicación se inicie, lo verá en el fichero de log en 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 estará accesible en http://YOUR_IP:8080/openkm con el usuario okmAdmin y la contraseña: admin. (No olvide cambiarla). Para más información: Manage users and roles.

Habilite las extensiones que necesite (por ejemplo Live Edit y HTML Editor) en el selector Misc > Extensions del perfil. Consulte Habilitar extensiones para más detalles.

Acceso desde otros equipos

El acceso desde otros equipos se denegará por defecto debido a la configuración del Firewall de Windows. Para habilitar el acceso desde cualquier lugar, ejecute este comando:

netsh advfirewall firewall add rule name="OpenKM" dir=in action=allow protocol=TCP localport=8080

Otras configuraciones adicionales estándar

OpenKM incluye muchos parámetros de configuración. Consulte Recommended configuration parameters.