Requisitos de hardware y software

Esta sección presenta información sobre el entorno necesario para ejecutar un servidor OpenKM. Enumera el software obligatorio y opcional, y ofrece datos sobre su configuración.

Precaución

Esta sección pretende ayudarle a validar o definir el entorno de producción. Sin embargo, la lista de comprobación no es exhaustiva y debe completarse teniendo en cuenta la experiencia del usuario.

Peligro

Para obtener el mejor rendimiento, OpenKM almacena el contenido binario del documento en el sistema de ficheros. Por eso, si tiene un servidor para la base de datos y otro para la propia aplicación, recuerde que el servidor de OpenKM necesita suficiente espacio libre en disco para almacenar todos estos documentos, más espacio adicional para otros ficheros como la caché de previsualización, el texto extraído y los índices de Lucene.

Requisitos

OpenKM puede instalarse en cualquier sistema operativo (Linux, Windows, Mac OS X), ya que es una aplicación multiplataforma.

Consejo

Un host Linux es una buena elección porque maneja bien las aplicaciones con mucha E/S, funciona bien con OpenKM y tiene un precio conveniente.

El único requisito para ejecutar OpenKM es tener instalado Java 17.

Comprobar la versión de Java

1. Abra una terminal:
   • En Linux o Mac OS X: abra una terminal.
   • En Windows: pulse la tecla “Windows” + R, escriba cmd (o command) en la ventana Run, y pulse “OK”, o abra el “Símbolo del sistema” desde el menú “Inicio > Programas > Accesorios”.
2. Escriba java -version y pulse Intro.
   Si Java está instalado correctamente en su equipo, se mostrará el nombre y la versión de la máquina virtual de Java:

openjdk version "17.0.18" 2026-01-20
OpenJDK Runtime Environment (build 17.0.18+8-Ubuntu-124.04.1)
OpenJDK 64-Bit Server VM (build 17.0.18+8-Ubuntu-124.04.1, mixed mode, sharing)

Si Java no está instalado en su equipo, fallará al mostrar la versión de Java. En ese caso, deberá instalar Java (vea más abajo).

Si Java está instalado pero no incluido en el PATH, fallará al encontrar el comando java. En ese caso, deberá añadir $JAVA_HOME/bin a su PATH (vea How do I set or change the PATH system variable?).

Instalar Java

Para usuarios de Windows

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

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

Más información en Installing on Windows

Para usuarios de Linux

Puede descargarlo desde los repositorios de Linux.

apt install openjdk-17-jdk

De esta forma, su OpenJDK se actualizará cada vez que haya una nueva versión disponible.

En caso de que tenga instalado otro OpenJDK (como GCJ), puede seleccionar el correcto así:

$ sudo update-alternatives --config Java

Más información sobre la instalación en Installing on Ubuntu and Debian.

Recomendaciones

Configuración de hardware

Consejo

OpenKM funciona bastante bien en cualquier equipo con una configuración de hardware estándar. Para un mejor rendimiento, recomendamos al menos 4 GB de RAM (>= 2 GB de RAM) y un disco duro rápido como SATA o mejor.

Una CPU Intel de doble núcleo a 3,20 GHz debería ser suficiente para menos usuarios (30-50 usuarios concurrentes).

Tenga suficiente espacio en disco para el repositorio de documentos y sus versiones.

Un host Linux es una buena elección porque este sistema operativo maneja bastante bien aplicaciones con mucha E/S como esta, y es económico.

Se recomienda encarecidamente una arquitectura de 64 bits.

Precaución

Sugerimos disponer de un servidor moderno con buen rendimiento.

Aunque OpenKM puede instalarse en un servidor con otras aplicaciones, el mejor escenario es un servidor dedicado. Recuerde que otras aplicaciones pueden perjudicar a OpenKM en un escenario compartido.

Para más información sobre los requisitos de hardware, consulte a sus representantes comerciales. Deberían proporcionarle una estimación de los requisitos de hardware.

(Vea el cuestionario al final de la página)

Nota

Puede usar el histórico de sus documentos y carpetas para obtener algunos de estos valores.

Consideraciones de dimensionamiento

Precaución

No existe una fórmula universal para obtener una estimación exacta de hardware. Variables como la calidad del hardware, la infraestructura de red, la tecnología de almacenamiento y los patrones de carga de trabajo influyen todas en el rendimiento de formas que no pueden anticiparse completamente de antemano. Trate cualquier estimación como un punto de partida, no como una garantía.

Tenga en cuenta las siguientes directrices al dimensionar su entorno de OpenKM:

• Prefiera Linux siempre que sea posible. Debido a su rendimiento de E/S de disco superior, un servidor Linux superará de forma consistente a un servidor Windows equivalente con las mismas especificaciones de hardware. Cuando ambas opciones estén disponibles, Linux es la opción recomendada.
• Planifique al menos cinco años de crecimiento. El dimensionamiento del hardware debería contemplar un horizonte mínimo de cinco años. Tenga en cuenta el crecimiento de usuarios, el aumento del volumen de documentos y la expansión del repositorio durante ese periodo.
• Entornos virtualizados frente a dedicados. En entornos virtualizados, los recursos pueden añadirse bajo demanda, así que es aceptable empezar cerca del mínimo e ir escalando según se necesite. En despliegues de servidor dedicado, se aplica la política contraria: dimensione generosamente desde el principio, o al menos asegúrese de que el servidor admite futuras ampliaciones de RAM y CPU.
• Tenga en cuenta los escenarios de demanda máxima. Los periodos de alta demanda, como importaciones masivas programadas o subidas automatizadas por robots concentradas en franjas horarias concretas, pueden someter al sistema a un estrés considerable. Estos escenarios deben tenerse en cuenta durante la fase de estimación.
• Aplique buenas prácticas de rendimiento en despliegues de alto rendimiento. Además de invertir en hardware capaz, los entornos de alto rendimiento se benefician de buenas prácticas como usar peticiones de API a medida, deshabilitar funcionalidades o módulos innecesarios, y ajustar la configuración de la aplicación a la carga de trabajo real.
• Las operaciones de escritura son el principal factor de demanda de hardware. Las operaciones que modifican los datos de la aplicación —creación, actualización y eliminación de documentos— son significativamente más costosas en recursos que las operaciones de lectura, ya que implican escrituras en disco, actualizaciones de índices y transacciones de base de datos. Las operaciones de lectura, por el contrario, suelen manejarse bien con configuraciones de hardware estándar y rara vez son la causa raíz de problemas de rendimiento. Al dimensionar el hardware, preste especial atención al volumen y frecuencia esperados de operaciones de escritura, ya que serán el factor principal que determine los recursos necesarios.

Ejemplos de dimensionamiento de hardware

Los siguientes ejemplos ilustran recomendaciones de hardware para tres niveles de despliegue representativos. Se ofrecen como referencia, no como prescripciones exactas. Valide siempre las estimaciones frente a su carga de trabajo específica usando el cuestionario siguiente.

Precaución

Las cifras siguientes asumen un servidor Linux. Para despliegues en Windows, añada al menos 2 núcleos de CPU y 2 GB de RAM a cada nivel para tener en cuenta la sobrecarga adicional del sistema operativo.

Nivel básico

Uso moderado, con la mayoría de usuarios realizando operaciones de lectura. Sin procesos de ingesta automatizados: todas las subidas y consultas las inician usuarios humanos. Hasta 20 usuarios concurrentes, menos de 100.000 documentos añadidos al año, y un repositorio total por debajo de 1 millón de ficheros.

Consejo

4 núcleos de CPU · 6 GB de RAM
MariaDB es la base de datos preferida para este nivel. Esta configuración es adecuada para equipos pequeños y despliegues departamentales con cargas de trabajo predecibles y de baja intensidad.

Nivel medio

Uso más extenso, con una base de usuarios predominantemente orientada a lectura, pero con aproximadamente un 25% de usuarios realizando operaciones de escritura. Sin ingesta automatizada. Entre 20 y 100 usuarios concurrentes, menos de 500.000 documentos añadidos al año, y un repositorio total por debajo de 5 millones de ficheros.

Consejo

8 núcleos de CPU · 12 GB de RAM
MariaDB es la base de datos preferida para este nivel. Esta configuración es adecuada para organizaciones de tamaño medio con un volumen significativo de actividad documental y una base de usuarios mixta de lectores y contribuyentes.

Nivel alto

Uso intensivo con más de 100 usuarios concurrentes, procesos de ingesta automatizados (robots), más de 500.000 documentos añadidos al año, y un repositorio total que supera los 5 millones de ficheros. Deben tenerse en cuenta los periodos de demanda máxima provocados por subidas masivas programadas.

Consejo

16 núcleos de CPU · 24 GB de RAM
Oracle o PostgreSQL son las bases de datos recomendadas para este nivel. Se recomienda encarecidamente un servidor de base de datos dedicado para aislar la E/S de la base de datos de la carga de trabajo de la aplicación y garantizar un rendimiento constante en condiciones de máxima demanda.

Dimensionamiento del disco

La capacidad de disco del servidor OpenKM debería ser al menos 1,3 veces el tamaño esperado del repositorio, para acomodar ficheros temporales, caché de previsualización, texto extraído e índices de Lucene.

En cuanto a la tecnología de almacenamiento:

• El sistema operativo, la aplicación y la base de datos deberían residir en una SSD. Estos componentes son muy sensibles a la latencia de E/S, y el almacenamiento SSD tiene un impacto directo y significativo en el rendimiento general de la plataforma.
• El datastore de documentos (donde se almacena el contenido binario) es menos sensible a la latencia de E/S. En despliegues de alto volumen, puede montarse en discos giratorios de menor coste, como unidades SATA de 7200 RPM o equivalentes, sin un impacto significativo en la experiencia de usuario.

Compatibilidad de navegadores

La interfaz de usuario de OpenKM está basada en el framework GWT, lo que significa que los navegadores compatibles vienen determinados por la compatibilidad de navegadores de GWT.

Navegadores compatibles actualmente:

• Mozilla Firefox
• Google Chrome y Chromium
• Microsoft Edge

Precaución

Aunque puede usar otros navegadores, como Safari u Opera, sugerimos usar la última versión de Google Chrome.

Consejo

Le animamos a mantener su navegador actualizado a la última versión.

Recomendamos Mozilla Firefox y Google Chrome porque ofrecen el mejor rendimiento, tienen menos agujeros de seguridad y siguen los estándares.

Sistemas operativos

Linux (configuraciones conocidas que funcionan):

• Ubuntu
• Debian
• CentOS
• Red Hat Linux

Precaución

Red Hat Linux es un escenario más complejo porque algunos paquetes no están en los repositorios oficiales de Red Hat por defecto.

Consejo

Ubuntu es la opción Linux preferida. Ejecutamos las pruebas contra distribuciones Linux y construimos los paquetes para ellas. Sin embargo, cualquier distribución Linux reciente debería ser utilizable siempre que:

• OpenJDK 17 esté disponible.
• Pueda adaptar los scripts de Linux proporcionados.
• Thirdparty software requirements

Windows (configuraciones conocidas que funcionan):

• Para desarrollo: Windows 7, Windows 8
• Para producción: Windows Server 2003, 2008, 2012, 2016, 2019, 2022 y versiones posteriores

Bases de datos

Configuraciones conocidas que funcionan:

• MySQL
• Oracle
• PostgreSQL
• SQL Server

Nota

La aplicación usa Hibernate internamente; de hecho, debería poder ejecutarla con cualquier dialecto de Hibernate compatible; para más información, lea Hibernate: SQL Dialects.

JVM

Aunque OpenKM puede ejecutarse con otros JDK, recomendamos usar OpenJDK 17. Se recomienda encarecidamente una arquitectura de 64 bits.

LDAP

• Open LDAP
• Microsoft Active Directory

Pequeño cuestionario

Precaución

El valor medio es especialmente interesante en preguntas donde las respuestas esperadas son numéricas.

Intente darles la información más detallada posible para obtener una estimación más precisa, usando este conjunto básico de preguntas:

• Número estimado de usuarios concurrentes.
• Tipo de usuarios (% de lectores y % de escritores).
• Número estimado de ficheros en el primer año.
• Número estimado de ficheros de crecimiento anual.
• Tamaño medio estimado de documento.
• Número de documentos en la importación inicial.
• ¿Estos documentos se suben por usuarios o de forma automática?
• Tipos de documento más comunes (Microsoft Office, LibreOffice, PDF, etc.).

Las preguntas más detalladas siguientes son una guía para describir el problema de gestión documental a resolver y pueden ser útiles para estimar los requisitos de hardware:

• ¿Tiene una importación inicial de documentos?
  • Si es así, ¿cuántos?
  • Si es así, ¿cuál es el tamaño de los datos en GB?
• ¿Cuántos records se crean en un día?
• ¿Cuántos documentos se generan en una semana?
• ¿Cuántos documentos se generan en un mes?
• ¿Cuántos documentos se generan en un año?
• ¿Cuál es el tamaño esperado del repositorio en GB para el primer año (sin incluir la importación inicial)?
• ¿Cuál es el tamaño típico de documento en su repositorio?
• ¿Cuántos usuarios concurrentes se esperan?
• ¿Cuántos de los usuarios simultáneos son lectores y cuántos son escritores?
• ¿Tiene subidas masivas periódicas diarias, semanales o de algún otro tipo?
  • Si es así, ¿cuántos documentos se suben?
  • ¿Puede hacerse la subida masiva fuera del horario laboral?
• ¿Tendrá alguna integración con aplicaciones de terceros?
  • Si es así, describa el uso en términos de:
    • ¿Se usará para leer datos?
    • ¿Se usará para escribir datos?
    • ¿Cuántas consultas se esperan por minuto y por hora?
• ¿Qué tipo de documentos gestiona, como documentos estándar de Office, PDF, o documentos menos comunes como vídeo y ficheros TIFF grandes?
  • Descríbalos, especialmente aquellos que sepa que no son comunes en la mayoría de las empresas.