Instalación en Windows

Precaución

Esta sección de la documentación intenta describir cómo instalar OpenKM manualmente. La herramienta OpenKM Installer hace la mayoría de las cosas automáticamente; más información en Using the installer.

Preliminares

Precaución

Si planea configurar OpenKM en modo cluster o sharding, lea las siguientes secciones antes de empezar el proceso de instalación:

• Cluster configuration
• Sharding configuration

Compruebe que tiene 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”).

Comprobando 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

Precaución

La versión de Java puede variar dependiendo de la que tenga instalada, pero recomendamos la última versión 1.8.

También recomendamos establecer la variable JAVA_HOME:

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

Instalar Java

Nota

Realice estos pasos solo si Java 11 no está instalado en su servidor.

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

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

Instalando la base de datos

Instale MySQL si todavía no lo tiene instalado:

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

Nota

También es buena idea instalar MySQL Workbench si no dispone de software cliente de MySQL.

Comprobar que InnoDB es el motor de MySQL por defecto

show engines;

Consejo

Debería mostrar algo como esto:

| InnoDB | DEFAULT | Supports transactions, row-level locking, and foreign keys | YES | YES | YES |

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

Precaución

Tras cambiar el motor de MySQL por defecto, el servicio de MySQL debe reiniciarse para que surta efecto.

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;

Instalando Tomcat

Descomprima Tomcat-9.0.76.zip en c:\

Precaución

La numeración de versión de Tomcat puede variar al actualizar a una versión mayor.

Configurando Tomcat como servicio

Registrar el servicio:

Precaución

Abra una terminal de Windows como administrador.

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:

Nota

También puede cambiar el “Startup type” a Automatic.

Nota

Más información sobre cómo configurar el servicio de Tomcat en Windows en: https://tomcat.apache.org/tomcat-9.0-doc/windows-service-howto.html

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

Configurando las 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 hacerse desde las variables de entorno de Windows:

Precaución

Las siguientes pantallas pueden variar bastante según la versión de su sistema operativo Windows.

Instalando 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	Required	Description
LibreOffice	Sí	Recomendamos usar LibreOffice porque es compatible con los formatos de Microsoft Office.
Tesseract	No	Descárguelo desde https://tesseract-ocr.github.io/tessdoc/Installation.html y siga el asistente de instalación.
ClamAV	No	Descárguelo desde http://www.clamav.net/download.html y siga el asistente de instalación.
ImageMagick	No	El paquete de Tomcat viene con una herramienta convert integrada. Si decide instalarla, 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 compilaciones 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 vez 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 viene con una herramienta Ghostscript integrada. Vaya a http://ghostscript.com/download/gsdnld.html y siga el asistente de instalación si decide instalarla.

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

Precaución

Asegúrese de que hibernate.dialect=com.openkm.db.dialect.MySQL5InnoDBDialect está habilitado si su base de datos es MySQL.

Primer arranque de la aplicación:

$ net start OpenKM

Nota

Use el programa mTail (o equivalente) para vigilar el fichero c:\tomcat-9.0.76\log\openkm.log.

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

Configurar 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');

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 viene con muchos parámetros de configuración. Consulte Recommended configuration parameters.

• Configuring Apache HTTP Reverse-Proxy
• Configuring Tomcat mail
• Configuring Tomcat memory utilization
• Configuring Tomcat ports
• Configuring Tomcat SSL/TLS
• Configuring Tomcat timezone