Instalación en Windows

Precaución

Esta sección de la documentación describe cómo instalar OpenKM manualmente. Una herramienta instaladora de OpenKM realiza la mayor parte de los pasos de forma automática; encontrará más información en Uso del instalador.

Preliminares

Precaución

Si tiene previsto configurar OpenKM en modo clúster o de sharding, lea las siguientes secciones antes de iniciar el proceso de instalación:

• Configuración del clúster
• Configuración del sharding

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 muestran el nombre y la versión de la máquina virtual de Java:

java version "1.8.0_312."
Java(TM) SE Runtime Environment (build 1.8.0_312-b07)
Java HotSpot(TM) 64-Bit Server VM (build 25.312-b07, mixed mode)

Precaución

La versión de Java puede diferir según la versión 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\jdk1.8.0_312" /M

Instalar Java

Nota

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

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

1. Descárguela desde el sitio web de Oracle (Java 8) y elija la plataforma adecuada para su hardware y su versión de Windows.
2. Ejecute el fichero .exe descargado 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.

Nota

Si no dispone de un cliente de MySQL, instalar MySQL Workbench también es una buena idea.

Comprobar que InnoDB es el motor predeterminado de MySQL

show engines;

Consejo

Debería mostrar algo similar a esto:

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

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

y bajo [mysqld], añada

default-storage-engine = innodb

Precaución

Tras cambiar el motor predeterminado de MySQL, es necesario reiniciar el servicio de MySQL para que el cambio 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;

Instalar Tomcat

Descomprima Tomcat-8.5.69.zip en c:\

Precaución

El número de versión de Tomcat puede variar si se actualiza a una versión principal más reciente.

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

Configurar Tomcat como un servicio

Registre el servicio:

Precaución

Abra un terminal de Windows como administrador.

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

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

cd c:\tomcat-8.5.69\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

Además, puede cambiar “Startup type” a Automatic.

Nota

Encontrará más información sobre cómo configurar el servicio de Tomcat en Windows en: http://tomcat.apache.org/tomcat-8.5-doc/windows-service-howto.html

Comprobar el servicio

Desde el terminal

Inicie el servicio:

$ net start OpenKM

Detenga el servicio:

$ net stop OpenKM

Desde el panel de servicios de Windows

Desde la herramienta openkmw

Configurar las variables de entorno

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

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

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

Precaución

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

Instalar OpenKM

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

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

Instale el software de terceros:

Software	Requerido	Descripción
LibreOffice	Sí	Recomendamos utilizar LibreOffice en lugar de OpenOffice porque tiene mejor compatibilidad 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 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 compilaciones de 16 bits requieren 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 la versión puede diferir debido a las 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 similar a esta:

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

# Initial configuration - Windows
system.openoffice.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

Utilice el programa mTail, o uno equivalente, para vigilar el fichero c:\tomcat-8.5.69\log\catalina.log.

Cuando la aplicación se haya iniciado, lo verá en el fichero de registro 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: Gestión de usuarios y roles.

Configure las extensiones predeterminadas:

Vaya a Administration > Utilities > Consulta a la base de datos 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 será denegado de forma predeterminada 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 Parámetros de configuración recomendados.

• Configuración del proxy inverso HTTP de Apache
• Configuración del correo de Tomcat
• Configuración del uso de memoria de Tomcat
• Configuración de los puertos de Tomcat
• Configuración de SSL/TLS en Tomcat
• Configuración de la zona horaria de Tomcat