Instalar DocuWare in situ 7.13

Para instalar DocuWare como sistema local, necesita el paquete de software de DocuWare en forma de archivo ZIP y su archivo de licencia, que ha recibido por correo electrónico de DocuWare.

Durante la instalación, tiene que seleccionar al menos uno de los cuatro roles para la máquina servidor en la que lo está instalando. El rol determina las tareas que la máquina servidor debe realizar en el sistema DocuWare.

• Rol de frontend: ofrece servicios para clientes y usuarios, incluye Web Client, Platform Services y Configuración de DocuWare.

• Rol de backend: ofrece servicios para el procesamiento en segundo plano, p. ej., flujos de trabajo, procesos y captura de correo electrónico.

• Rol de texto completo: ofrece servicios para el procesamiento de texto completo.

• Rol de servicio de mensajería: ofrece servicios para la comunicación de servidores y aplicaciones.

También debe seleccionar un modo de configuración:

• Nueva instalación: para instalar un sistema de DocuWare completamente nuevo con una base de datos nueva.

• Extensión: para instalar máquinas de servidor adicionales para un sistema de DocuWare existente con una base de datos existente. Por ejemplo:
  - para extender el sistema existente a otra máquina.
  - para restaurar el sistema después de un fallo de la máquina (si hay una base de datos)
  - para actualizar DocuWare mientras se mueve a un servidor nuevo

• Actualización: para actualizar o reinstalar los componentes de DocuWare en la máquina del servidor actual y añadir uno de los roles anteriores a una máquina servidor existente

• Desinstalar: para desinstalar todos los servicios y aplicaciones de DocuWare de la máquina servidor actual

La instalación comprende varios pasos. Cada paso puede repetirse si falla. La configuración está registrada al detalle. Los archivos de registro correspondientes se pueden encontrar en el directorio <%AllUsersProfile%\DocuWare\SetupLogs>.

Servicios de DocuWare ejecutados en usuarios de Windows. Para poder especificar los usuarios de Windows como parte de la configuración de DocuWare, primero debe crearlos.

La información sobre las opciones de configuración individuales se puede obtener directamente desde el diálogo a través de los iconos de información.

Información sobre la versión 7.13 de DocuWare

Encuentre una lista completa de todas las nuevas funciones de la versión 7.13 de DocuWare en el Knowledge Center de DocuWare en la sección Novedades de la versión 7.13 de DocuWare.

Antes de actualizar a la versión 7.13, compruebe hasta qué punto los cambios con la versión 7.13 de DocuWare son relevantes para su sistema.

Para la actualización a la versión 7.13 de DocuWare, necesita tener al menos la versión 7.8.

Si no la tiene, siga esta ruta de actualización:
Versiones 6.6-6.11 > Actualizar a 6.2 > Actualizar a 7.1 > Actualizar a 7.4 > Actualizar a 7.9 > Actualizar a 7.13

Compruebe también los requisitos del sistema.

Para implementar la actualización, póngase en contacto con su socio autorizado de DocuWare. Esto se recomienda especialmente si no actualiza directamente desde la versión anterior.

Compruebe su configuración de DocuWare Platform

La mayoría de configuraciones de DocuWare Platform se mueven desde el archivo Web.config a DocuWare.Platform.Web.dll.config

• Para obtener más información, consulte también las  Notas de la versión técnica  de la versión anterior 7.11 .

• Para obtener más información sobre los archivos de configuración, consulte la ayuda de configuración para la versión 7.11 de DocuWare.

Usuario de Windows para el servidor de DocuWare

Los servidores de DocuWare deben ser capaces de iniciar sesión en el sistema Windows. Para ello, se requiere un usuario de Windows con derechos de administrador locales. Durante la instalación, debe especificar un usuario de Windows correspondiente; elija uno existente o cree uno nuevo. Recomendamos el uso de un usuario de Windows especial exclusivamente para los servicios de DocuWare.

Puertos usados

DocuWare utiliza los siguientes puertos por defecto:

• Authentication Server: 9000

• Servidor de texto completo: 9012

• Servicio de transformación: 5050

• Servicio de mensajería del servidor: 6379

Si no hay otros programas en las máquinas de servidor utilizadas que se comunican a través de los puertos preseleccionados, no hace falta ningún cambio.

Servicio de mensajería de DocuWare

En DocuWare 7.13, la mensajería de servidor a servidor se cambia a un enfoque basado en el protocolo de Redis (RESP). Esto se llama servicio de mensajería de DocuWare. Reemplace la comunicación basada en MSMQ utilizada hasta ahora, ya que esta tecnología ya no es compatible con Microsoft.

El cambio es doble:

1. Los componentes de DocuWare que participan en el servicio de mensajería de DocuWare son los clientes de protocolo RESP. Necesitan una cadena de conexión para acceder al servicio de mensajería basado en RESP. Se le pedirá esta cadena de conexión durante la instalación.

2. La comunicación está respaldada por un servicio que proporciona la implementación del protocolo RESP en el lado del servidor. Para esto, tiene dos opciones:

   1. Instalar el rol de mensajería del servidor de DocuWare en una máquina. El componente de mensajería instalado por este rol se basa en la implementación de Microsoft del protocolo Redis llamado Garnet. La implementación solo admite una única instancia del servicio.
      Si quiere superar esta limitación, por ejemplo, si quiere proporcionar una configuración a prueba de fallos, opte por la siguiente opción.

   2. Proporcione su propio clúster de Redis o use uno existente. Prepare la cadena de conexión a ese sistema para proporcionarla cuando se le pregunte por la configuración de DocuWare.

      • La cadena de conexión debe tener este formato: «{host}:{port},password={your password},ssl={true|false},sslProtocols={protocol}».

      • Puede añadir más pares {key}={value} separados por comas.

      • La contraseña, SSL y el protocolo SSL son opcionales, pero es recomendable usarlos.

      • Una cadena de conexión de ejemplo puede verse así: «localhost:6379,password=xxxx,ssl=True,sslProtocols=Tls12».

Instalar la mensajería del servidor de DocuWare

Durante la configuración, el nuevo rol mensajería del servidor puede seleccionarse durante la instalación, actualización, extensión y modificación o reinstalación.

Durante una actualización, debe seleccionar explícitamente el rol servicio de mensajería del servidor para su instalación. El instalador solo actualiza los roles que ya existen. No añadirá nuevos roles al sistema a no ser que los seleccione manualmente.

Cuando instale el rol en una máquina, el servidor se configura primero con su puerto TCP. El puerto por defecto es 6379.

La segunda parte de la configuración consiste en establecer la contraseña y generar la cadena de conexión correspondiente. Todas las máquinas que alojan roles del servidor de DocuWare necesitan esta cadena de conexión; puede copiarla desde la segunda página de configuración:

Pausar la configuración para la instalación del servicio de mensajería del servidor

Si el servicio de mensajería del servidor no está instalado localmente, el asistente de actualización le pedirá que introduzca la cadena de conexión.

Cuando el asistente de actualización llega a la página «Cadena de conexión», puede dejar el asistente abierto (efectivamente, «pausándolo») e iniciar la configuración de DocuWare en otra máquina (o en la misma máquina en el modo Modificar/Extender) para instalar el rol de mensajería del servidor. Después de instalar el servicio de mensajería, copie la cadena de conexión generada en el primer asistente y continúe con la instalación.  

Importante: La configuración no continuará hasta que suministre una cadena de conexión válida, ya que debe verificar una conexión en vivo a la instancia de mensajería del servidor.

Este flujo de trabajo es el mismo tanto para actualizaciones como para instalaciones nuevas. Durante una nueva instalación, el primer rol que instala normalmente es servicios de frontend. Tan pronto como la cadena de conexión esté disponible, ejecute la configuración de DocuWare en una máquina adicional, amplíela con el rol de mensajería del servidor, e introduzca la cadena de conexión en el asistente original.

Lugar en el que se almacena la cadena: la cadena de conexión está escrita en texto plano en %AllUsersProfile%\DocuWare\ServerConfig\dwmachine.config

Nota: Como la cadena contiene un signo igual (=), actualmente no se puede escribir en dwmachine.config con DocuWare.Setup.Server.Cmd.exe. Esta limitación puede eliminarse en una versión futura.

La contraseña utilizada en la cadena de conexión de mensajería del servidor debe contener solo caracteres ASCII.

Simulación de actualización

La configuración de DocuWare ofrece una simulación de actualización para la base de datos del sistema (DWSYSTEM):

Se comprueba si la base de datos de su sistema de DocuWare existente puede actualizarse. El sistema de producción de DocuWare no se cambiará.

Recomendamos ejecutar la simulación para evitar problemas durante la configuración y el tiempo de inactividad del sistema. Si la simulación tiene éxito, puede continuar con la actualización del sistema. Si se producen errores, debe cancelar la configuración y ponerse en contacto con su socio de ventas de DocuWare o con el soporte de DocuWare.

Notas:

• Interrupción de Oracle como base de datos compatible: con DocuWare 7.10, ya no es compatible Oracle como base de datos. Si la configuración del servidor de DocuWare detecta un servidor de base de datos de Oracle, la actualización se aborta con un mensaje de error. DocuWare ofrecerá una migración de un Oracle a una base de datos de Microsoft SQL Server.

• Las bases de datos MySQL anteriores a la versión 8.0 ya no serán compatibles. La configuración de DocuWare 7.13 se detendrá si detecta una base de datos MySQL anterior a la versión 8.0 y no continuará hasta que se actualice la base de datos.

• Si está utilizando un servidor de base de datos MySQL y ejecuta la actualización remota, ninguna de las opciones de simulación de actualización están disponibles.

• No se admiten comodines en la configuración IIS: Internet Information Server 10 (IIS 10) permite el uso de comodines en el enlace de nombre de host de la configuración del sitio web. Estos comodines no son compatibles con DocuWare. Para garantizar que no se usen comodines, la configuración del servidor de DocuWare evita que el usuario seleccione los sitios web configurados con comodines durante cualquier instalación y muestra un mensaje de error.

• A partir de la versión 7.8 de DocuWare, los sistemas Dell EMC Centera y Dell EMC ECS ya no son compatibles como medios de almacenamiento. Si se encuentra una ubicación de almacenamiento durante una actualización, la configuración se aborta y se muestra el mensaje de error correspondiente. Una simulación puede ejecutarse a pesar del mensaje de error.

Programa de mejora de la experiencia del cliente

Usando el Programa de mejora de la experiencia del cliente (CEIP), DocuWare quiere obtener más información sobre el uso del software de DocuWare para mejorar aún más la facilidad de uso y la experiencia del cliente, de la cual también se puede beneficiar.

Al configurar/actualizar, se instala el componente «Mejora de la experiencia del cliente». Esto crea una tabla de base de datos adicional llamada DWAnalytics en la base de datos utilizada para el sistema de DocuWare en el que se almacena la información estadística. También puede ver la información en la tabla de base de datos usando las herramientas normales de base de datos.
Incluso aunque no participe en CEIP, se instala el componente «mejora de la experiencia del cliente», la base de datos creada y la información correspondiente escrita. Sin embargo, los datos no se transfieren a DocuWare.

Más información sobre el CEIP, por ejemplo, ¿qué datos se transfieren?