Cargando…

Instalación

Documenos ®

Documenos® es compatible con las arquitecturas x86 y ARM.

El procesador de su servidor puede estar basado en x86 o en ARM. Documenos® es compatible con ambos. Puede descargar los archivos de instalación adecuados para cada arquitectura de servidor desde esta página: Descargar

Hay dos formas de instalación: con Docker, todos los componentes se ponen en marcha con un solo comando, y es el método recomendado. La instalación en Windows IIS es preferible si desea ejecutar la aplicación en su infraestructura de servidores Windows existente.

ARM / x86

Instalación con Docker

Un único paquete instala conjuntamente la aplicación, la base de datos PostgreSQL, el servicio de firma digital, el motor de búsqueda Elasticsearch y el servicio de traducción LibreTranslate.

  1. Prepare los requisitos previos. Su servidor debe tener instalados Docker Engine (20.10+) y el complemento Docker Compose (2.0+). Deben poder asignarse al menos 8 GB RAM al contenedor de la aplicación, y el servidor necesita acceso a Internet para descargar las imágenes de contenedor. Funciona en Linux, Windows y macOS.
  2. Descargue el paquete. Descargue el paquete Docker Compose (ZIP) desde la página Descargar. El paquete consta de docker-compose.yml, con las definiciones de los servicios; .env, con los valores de configuración; y readme.md, con las notas de instalación. Copie la carpeta tal cual en su servidor.
  3. Defina las contraseñas. Abra el archivo .env y, antes de iniciar los contenedores, sustituya obligatoriamente estos dos valores por valores propios, seguros y únicos: DB_PASSWORD (contraseña del usuario de la base de datos PostgreSQL) y DEFAULT_PWD (contraseña inicial asignada a los usuarios nuevos; los usuarios deben cambiarla tras su primer inicio de sesión). No utilice nunca contraseñas de ejemplo o predeterminadas en producción.
  4. Revise la configuración de red y de puertos. Compruebe los valores *_BIND_IP y *_PORT. De forma predeterminada, los servicios de base de datos, firma, búsqueda y traducción solo escuchan en 127.0.0.1 y no son accesibles desde el exterior; el único puerto expuesto es el de la aplicación (APP_PORT, por defecto 8080). Si la aplicación está detrás de un balanceador de carga o un proxy inverso, indique el valor CLIENT_IP_HEADER (por ejemplo, X-Forwarded-For).
  5. Inicie los servicios. En la carpeta que contiene el archivo docker-compose.yml, ejecute el siguiente comando: docker compose up -d
  6. Espere a que finalice el primer arranque. En el primer arranque, el servicio de traducción descarga los modelos de idioma especificados en TRANSLATE_LOAD_ONLY; con una conexión normal tarda entre 5 y 10 minutos y solo ocurre una vez. Puede seguir el progreso con los comandos docker compose ps y docker compose logs -f documenos_translate. Durante la descarga el servicio aparece como starting y, cuando está listo, como healthy. Si su conexión es lenta, aumente el valor de TRANSLATE_START_PERIOD.
  7. Abra la aplicación. Abra http://direccion-de-su-servidor:8080 (o el valor de APP_PORT que haya definido) en su navegador, siga las instrucciones del primer inicio para crear la cuenta de administrador y registre su licencia.

Actualización: Descargue el paquete más reciente, traslade sus valores de configuración actuales al nuevo archivo .env y ejecute docker compose pull seguido de docker compose up -d. Sus datos se guardan en volúmenes de Docker con nombre y no se ven afectados por las actualizaciones ni los reinicios.

Instalación en Windows IIS

Documenos® es una aplicación ASP.NET Core; se ejecuta en IIS a través del módulo ASP.NET Core.

  1. Prepare los requisitos previos. Habilite el rol IIS en Windows Server e instale el ASP.NET Core Hosting Bundle. El Hosting Bundle debe instalarse después de IIS; de lo contrario, el módulo ASP.NET Core no se registra en IIS. Tras la instalación, reinicie IIS con el comando iisreset.
  2. Prepare el servidor de base de datos. Instale PostgreSQL (v15 o posterior) o proporcione acceso a un servidor PostgreSQL existente. Documenos® utiliza bases de datos independientes para el núcleo (DOCUMENOS_CORE), los informes (DOCUMENOS_REPORT) y el reconocimiento facial (DOCUMENOS_FACE).
  3. Prepare los servicios auxiliares. Se necesitan Elasticsearch para la búsqueda de texto completo, el servicio de firma digital para la firma electrónica y LibreTranslate para la traducción automática en su propio servidor. Ejecute estos servicios en un servidor independiente con las definiciones del paquete Docker y anote las direcciones en las que la aplicación puede acceder a ellos.
  4. Descargue el paquete ZIP. Descargue el paquete introduciendo su clave de descarga en la sección Archivo ZIP para Windows IIS de la página Descargar.
  5. Extraiga los archivos en el servidor. Extraiga el contenido del ZIP en la carpeta reservada para el sitio web, por ejemplo C:\inetpub\documenos.
  6. Configure los ajustes de conexión. En el archivo appsettings.json de la carpeta de la aplicación, introduzca sus datos de conexión de PostgreSQL (CnStrServer, CnStr, CnStrBI, CnStrFA) en la sección ConnectionStrings. Defina también en el mismo archivo las direcciones de los servicios de firma y traducción (SignatureServiceUrl, TranslateServiceUrl). La conexión con el servidor de búsqueda Elasticsearch se configura desde el panel de administración tras la instalación.
  7. Cree un grupo de aplicaciones. En el Administrador de IIS, agregue un nuevo grupo de aplicaciones (Application Pool) y establezca la versión de .NET CLR en Sin código administrado (No Managed Code).
  8. Agregue el sitio web. En el Administrador de IIS, cree un nuevo sitio mediante Sitios → Agregar sitio web; seleccione como ruta de acceso física la carpeta donde extrajo los archivos y como grupo de aplicaciones el que acaba de crear. Defina los enlaces (puerto, nombre de host) y, en producción, asigne un certificado SSL para HTTPS.
  9. Conceda los permisos de carpeta. Conceda a la identidad IIS AppPool\<nombre del grupo> permisos de lectura y escritura sobre la carpeta de la aplicación. La aplicación escribe los registros, los archivos temporales y las claves de protección de datos con esta identidad.
  10. Inicie y abra el sitio. Inicie el sitio y abra en su navegador la dirección que haya definido. El esquema de la base de datos se aplica automáticamente al iniciarse la aplicación. Siga las instrucciones del primer inicio para crear la cuenta de administrador y registre su licencia.

Actualización: Los pasos para actualizar la versión en una instalación IIS se describen en la página Mantenimiento y actualizaciones. Para obtener información sobre el registro de licencias y el modo de prueba, consulte la página Licencias.