Guía de Instalación On-Premise de mindzieStudio

Descripción General

La plataforma de minería de procesos y automatización impulsada por IA de mindzieStudio ofrece una comprensión exhaustiva y profunda de los flujos de trabajo dentro de su organización, proporcionando una visibilidad sin precedentes de los procesos, identificando cuellos de botella, ineficiencias y áreas para optimización. Al aprovechar las herramientas de minería de procesos, los usuarios pueden obtener información en tiempo real, lo que les permite agilizar operaciones, mejorar el cumplimiento y aumentar la eficiencia general. mindzieStudio capacita a las organizaciones para tomar decisiones basadas en datos, optimizar procesos para máxima productividad, reducir costos operativos, acelerar la ejecución de procesos y asegurar un flujo de trabajo fluido y estandarizado en toda la empresa.

Beneficios Clave

• Mejorar Tiempos de Proceso - Optimizar flujos de trabajo para una ejecución más rápida
• Reducir Desperdicios - Identificar y eliminar ineficiencias
• Monitorear y Asegurar el Cumplimiento - Mantener estándares regulatorios

---

Tipo de Instalación

Esta guía cubre instalaciones tanto en línea como fuera de línea. Elija según su entorno:

Tipo de Instalación	Cuándo Usar
En línea	El servidor tiene conectividad a internet
Fuera de línea	El servidor no tiene acceso a internet (aislado)

Para instalaciones fuera de línea, todos los archivos necesarios deben descargarse en una máquina con acceso a internet y transferirse al servidor objetivo.

---

Lista de Verificación Pre-Instalación

Complete todos los puntos a continuación ANTES de su instalación programada. Imprima esta página y marque cada elemento.

Certificado SSL

• Certificado SSL obtenido del departamento de IT/Seguridad
• Archivo(s) del certificado listos para importar en IIS
• El certificado coincide con el nombre de dominio planeado

Configuración DNS

• Entrada DNS creada (por ejemplo, mindzie.[suempresa].com)
• Registro DNS apunta a la dirección IP de la VM
• Propagación DNS verificada (puede resolverse el nombre de host)

SQL Server (Elija Una)

Opción A: Usar SQL Server existente

• Instancia de SQL Server identificada y accesible desde la VM
• Administrador de base de datos disponible que puede:
  • Crear una base de datos nueva llamada "mindzie"
  • Crear un login apropiado con permisos db_owner (ver Modo de Autenticación abajo)
  • Proporcionar credenciales de conexión
• Modo de autenticación determinado (ver siguiente sección)

Opción B: Instalar SQL Server Express en la VM

• Instalador de SQL Server Express disponible (descargar si está en línea, o transferir si fuera de línea)
• Persona de IT disponible para instalar SQL Server Express
• Entendido: SQL Express es gratuito pero carece de características empresariales (respaldo, espejado)
• Ver guía Instalar SQL Server Express

Modo de Autenticación de SQL Server

Elija uno de los siguientes modos de autenticación:

Modo	Requisitos	Ideal Para
Modo Mixto (SQL Server + Windows Auth)	Login SQL con nombre de usuario/contraseña	Recomendado. Configuración más simple: el Servicio de Windows y el grupo de aplicaciones de IIS pueden permanecer con la cuenta Local System por defecto
Sólo Autenticación de Windows	Una cuenta de servicio Windows con permisos SQL, utilizada tanto por el Servicio de Windows como por el grupo de aplicaciones de IIS	Entornos cuya política de seguridad no permite logins SQL

Para Modo Mixto:

• SQL Server tiene habilitada la autenticación en modo mixto
• Se crearán credenciales de login SQL (usuario/contraseña)

Para Sólo Autenticación de Windows:

• Cuenta de servicio Windows identificada o será creada
• Cuenta de servicio tendrá acceso db_owner a la base de datos mindzie
• Permiso para configurar tanto el servicio de Windows como el grupo de aplicaciones de IIS para que corran bajo esta cuenta
• A la cuenta de servicio se le concederá acceso de lectura/escritura a los directorios del sitio web de IIS, del servicio y de almacenamiento (ver Paso 4)

Máquina Virtual

• Windows Server 2019 o superior provisionado
• Cumple con especificaciones mínimas: 4+ núcleos, 8GB+ RAM, 100GB+ almacenamiento (ver Requisitos Técnicos)
• Administrador con acceso completo disponible para:
  • Instalar software
  • Configurar IIS
  • Gestionar servicios de Windows
• Conectividad a internet disponible (solo para instalación en línea)

Ítems Adicionales

• Clave de licencia mindzieStudio recibida de mindzie
• Ventana de tiempo de inactividad programada comunicada a los usuarios (si aplica)

---

Pasos de Instalación

Paso 1: Configuración de SQL Server

Requisitos:

1. Permiso para crear bases de datos en su servidor SQL
2. SQL Server Management Studio (recomendado)

Proceso de Configuración:

1. Abra SQL Server Management Studio
2. Cree la base de datos mindzie con la intercalación correcta

Luego elija según su modo de autenticación:

Si usa Modo Mixto (Autenticación SQL Server)

3. Asegúrese de que SQL Server tenga habilitada la autenticación en modo mixto
4. Cree un login SQL llamado "mindzie"
5. Conceda al login "mindzie" permisos db_owner sobre la base de datos "mindzie"

Si usa Sólo Autenticación de Windows

3. Identifique o cree una cuenta de servicio Windows (ej. DOMINIO\mindzieService)
4. En SQL Server, cree un login para esta cuenta de Windows
5. Conceda a este login permisos db_owner sobre la base de datos "mindzie"
6. Nota: En el Paso 4 configurará tanto el Servicio de Windows de mindzieStudio como el grupo de aplicaciones de IIS para que corran bajo esta cuenta

Paso 2: Internet Information Services (IIS)

Configuración:

1. Asegúrese que el servidor tiene IIS habilitado antes de instalar .NET
2. Si ya instaló .NET, por favor repare la instalación de .NET
3. Agregue "Protocolo WebSocket" bajo Servidor Web -> Desarrollo de Aplicaciones

Nota: Asegúrese que IIS esté configurado correctamente antes de proceder al siguiente paso.

Paso 2a: Eliminar WebDAV

WebDAV debe ser eliminado del servidor. Esta característica intercepta solicitudes HTTP (PUT, DELETE, MOVE) antes de que lleguen a mindzieStudio, causando fallos en la API.

Abra PowerShell como Administrador y ejecute:

Remove-WindowsFeature Web-DAV-Publishing

Puede ser necesario reiniciar el servidor. Ver Deshabilitar WebDAV para más detalles.

Paso 3: Instalación del Runtime de .NET

Paso 4: Instalar mindzieStudio

Configuración de Licencia (Todas las Instalaciones)

1. Después de la instalación, ejecute la aplicación EnterpriseConfiguration
2. Pegue su licencia en el cuadro de texto y haga clic en "Activar Nueva Licencia"

Configuración de Base de Datos

1. Haga clic en el botón "Configuración de Base de Datos"
2. Haga clic en "Cambiar SQL Server"
3. Configure según su modo de autenticación:

Si usa Modo Mixto (Autenticación SQL Server):

• Asegúrese de ingresar el nombre correcto del servidor SQL
• Configure la autenticación en "Autenticación SQL Server"
• Ingrese el nombre de usuario y contraseña SQL
• Haga clic en "Actualizar Base de Datos"

Si usa Sólo Autenticación de Windows:

• Asegúrese de ingresar el nombre correcto del servidor SQL
• Configure la autenticación en "Autenticación de Windows"
• Haga clic en "Actualizar Base de Datos"
• Luego cambie ambas cuentas de servicio, como se describe a continuación

Para cambiar ambas cuentas:

1. En la herramienta Enterprise Configuration, ubique la sección Service / IIS Status y haga clic en Settings...
2. El cuadro de diálogo contiene dos secciones independientes, cada una con su propio botón Change Account...: una titulada Windows Service: mindzieStudioService y otra IIS Application Pool: mindzieStudioAppPool. Ambas deben configurarse con la misma cuenta de servicio Windows.
3. En cada sección, haga clic en Change Account..., elija Custom Account (recommended for Windows Auth), ingrese el nombre de la cuenta y la contraseña, y haga clic en OK.
4. Confirme que el campo Account de ambas secciones muestra ahora su cuenta de servicio. Si alguna todavía indica LocalSystem, NT AUTHORITY\SYSTEM o ApplicationPoolIdentity, no ha sido cambiada.

También puede establecer la cuenta del Servicio de Windows desde Servicios de Windows (services.msc) -> clic derecho en mindzieStudioService -> Propiedades -> pestaña Iniciar sesión. En services.msc no existe un equivalente para el grupo de aplicaciones: cámbielo en la herramienta de configuración, o en el Administrador de IIS -> Grupos de aplicaciones -> mindzieStudioAppPool -> Configuración avanzada -> Identidad.

Permisos que necesita la cuenta de servicio:

Requisito	Dónde se concede
Login SQL con db_owner sobre la base de datos mindzie	SQL Server (Paso 1)
Acceso de lectura/escritura al directorio del sitio web de IIS	Permisos de carpeta de Windows
Acceso de lectura/escritura al directorio del servicio	Permisos de carpeta de Windows
Acceso de lectura/escritura al directorio de almacenamiento	Permisos de carpeta de Windows

Utilice una cuenta con una contraseña estable, o establezca un procedimiento para actualizar las credenciales del Servicio de Windows y del grupo de aplicaciones cada vez que cambie la contraseña: el sitio deja de funcionar en cuanto la contraseña almacenada queda desactualizada.

Verifique la Configuración de Base de Datos

Confirme que la instalación realmente funciona antes de entregar el servidor:

1. El Servicio de Windows alcanza el estado "Running". En el diálogo de configuración, o en services.msc, el estado de mindzieStudioService debe indicar Running. Un estado detenido en StartPending, o que vuelve a Stopped poco después de iniciarse, significa que la cuenta no puede abrir la base de datos.
2. El grupo de aplicaciones está iniciado (Started) y su campo Account muestra su cuenta de servicio.
3. El sitio carga. Navegue a la URL de mindzieStudio e inicie sesión. Un fallo de base de datos al arrancar produce una página de error en lugar de la pantalla de inicio de sesión.

Paso 4a: Instalar Python (Opcional)

Si planea usar enriquecimientos de Python o acciones de Script en Python, instale Python ahora.

Consulte Instalar Python para instrucciones detalladas.

Paso 5: Configurar SSL en IIS

Configuración SSL:

1. Configure el certificado SSL en Internet Information Services (IIS)
2. Añada el enlace https usando el certificado SSL del paso 1
3. Esto no debe ser localhost para instalaciones de producción

DNS recomendado:

• mindziestudio.[nombreempresa].com

Notas importantes:

• La configuración SSL es obligatoria en entornos de producción
• Asegúrese de una adecuada gestión del certificado para seguridad

---

Actualizaciones

---

Configuración Adicional

Actualizaciones

Al actualizar su servidor Enterprise, tenga en cuenta que tendrá que volver a agregar su certificado al sitio web en IIS.

Actualizaciones de Licencia

Si actualizó su licencia, deberá realizar los siguientes pasos para que tenga efecto:

1. Ejecute la herramienta de Configuración Enterprise y haga clic en actualizar licencia
2. Reinicie el sitio mindzie en IIS

Integración LLM AI

Para utilizar un LLM on-premise con el copiloto de IA de mindzie y otras funciones, por favor contacte a support@mindzie.com para detalles.

---

Resolución de Problemas

"Cannot open database mindzie requested by the login. Login failed for user 'NT AUTHORITY\SYSTEM'"

Síntoma: La instalación se completó y la licencia es válida, pero el sitio falla al arrancar con un error similar a:

SqlException 4060: Cannot open database "mindzie" requested by the login.
Login failed for user 'NT AUTHORITY\SYSTEM'.

Causa: Eligió Autenticación de Windows, pero el Servicio de Windows de mindzieStudio y/o el grupo de aplicaciones de IIS siguen ejecutándose como Local System. NT AUTHORITY\SYSTEM es la cuenta Local System, y no tiene ningún login en su SQL Server. La base de datos en sí está correcta: la aplicación simplemente no tiene ninguna identidad autorizada para abrirla. Esto ocurre con mayor frecuencia cuando sólo se cambió la cuenta del Servicio de Windows y el grupo de aplicaciones mindzieStudioAppPool se dejó con su valor por defecto.

Solución:

1. Abra la herramienta Enterprise Configuration -> Service / IIS Status -> Settings...
2. Revise la cuenta (Account) mostrada en ambas secciones. Cualquier valor LocalSystem, NT AUTHORITY\SYSTEM o ApplicationPoolIdentity es el problema.
3. Use Change Account... en cada sección para establecer su cuenta de servicio Windows. Deben cambiarse ambas: ver Paso 4, Configuración de Base de Datos.
4. Confirme que la cuenta tiene un login SQL con db_owner sobre la base de datos mindzie (Paso 1).
5. Conceda a la cuenta acceso de lectura/escritura a los directorios del sitio web de IIS, del servicio y de almacenamiento: la herramienta de configuración muestra estas rutas pero no establece los permisos.
6. Reinicie el Servicio de Windows y recicle el grupo de aplicaciones, luego recargue el sitio.

Si el error menciona su cuenta de servicio (por ejemplo Login failed for user 'DOMINIO\mindzieService'), el cambio de identidad funcionó, pero esa cuenta no tiene permisos db_owner sobre la base de datos mindzie. Corríjalo en SQL Server como se describe en el Paso 1.

El Servicio No Inicia Tras la Configuración

Si mindzieStudioService permanece en StartPending o se detiene inmediatamente, casi siempre se debe a que la cuenta de servicio no puede alcanzar la base de datos. Siga los pasos anteriores, y recuerde que un Check exitoso en el diálogo de base de datos sólo valida la conexión al servidor SQL: no el acceso a la base de datos mindzie, ni desde la cuenta de servicio.

---

Soporte

¿Necesita ayuda con su instalación? Contáctenos:

Correo: support@mindzie.com

Nuestro equipo de soporte está disponible para ayudar con cualquier pregunta de instalación o configuración.

---

Para especificaciones técnicas y requisitos, vea la página de Requisitos Técnicos.