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 completa 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, permitiéndoles optimizar operaciones, mejorar el cumplimiento y aumentar la eficiencia general. mindzieStudio empodera 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 garantizar un flujo de trabajo estandarizado y fluido 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 tanto instalaciones 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 requeridos deben descargarse en una máquina con acceso a internet y transferirse al servidor destino.

---

Lista de Verificación Pre-Instalación

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

Certificado SSL

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

Configuración DNS

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

SQL Server (Elija Uno)

Opción A: Usar SQL Server Existente

• Instancia de SQL Server identificada y accesible desde la VM
• Administrador de base de datos disponible que pueda:
  • Crear una nueva base de datos llamada "mindzie"
  • Crear un login adecuado con permisos db_owner (ver Modo de Autenticación abajo)
  • Proveer credenciales de conexión
• Modo de autenticación determinado (ver próxima 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 está fuera de línea)
• Persona de TI 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	Recomendado para
Modo Mixto (Autenticación SQL Server + Windows)	Login SQL con usuario/contraseña	Recomendado. Configuración más simple - el Servicio Windows y el grupo de aplicaciones IIS pueden mantenerse en la cuenta Local System predeterminada
Solo Autenticación Windows	Cuenta de servicio Windows con permisos SQL, usada por ambos: Servicio Windows y grupo de aplicaciones IIS	Entornos cuya política de seguridad no permite logins SQL

Para Modo Mixto:

• SQL Server tiene habilitada la autenticación en Modo Mixto
• Credenciales de login SQL serán creadas (usuario/contraseña)

Para Solo Autenticación Windows:

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

Máquina Virtual

• Windows Server 2019 o superior aprovisionado
• 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)

Elementos Adicionales

• Llave de licencia mindzieStudio recibida de mindzie
• Ventana de tiempo para mantenimiento 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. Otorgue al login "mindzie" permisos db_owner en la base de datos "mindzie"

Si usa Solo Autenticación Windows

3. Identifique o cree una cuenta de servicio Windows (por ejemplo, DOMINIO\mindzieService)
4. En SQL Server, cree un login para esta cuenta Windows
5. Otorgue al login Windows permisos db_owner en la base de datos "mindzie"
6. Nota: En el Paso 4 configurará tanto el Servicio Windows mindzieStudio como el grupo de aplicaciones IIS para que se ejecuten bajo esta cuenta

Paso 2: Internet Information Services (IIS)

Configuración:

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

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

Paso 2a: Eliminar WebDAV

WebDAV debe eliminarse del servidor. Esta característica intercepta solicitudes HTTP (PUT, DELETE, MOVE) antes de que lleguen a mindzieStudio, causando fallas en las API.

Abra PowerShell como Administrador y ejecute:

Remove-WindowsFeature Web-DAV-Publishing

Puede ser necesario reiniciar el servidor. Vea Deshabilitar WebDAV para detalles completos.

Paso 3: Instalación del Runtime .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 la caja de texto y haga clic en "Activate New License"

Configuración de Base de Datos

1. Haga clic en el botón "Database Settings"
2. Haga clic en "Change 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
• Establezca Autenticación en "SQL Server Authentication"
• Ingrese usuario y contraseña SQL
• Haga clic en "Update Database"

Si usa Solo Autenticación Windows:

• Asegúrese de ingresar el nombre correcto del servidor SQL
• Establezca Autenticación en "Windows Authentication"
• Haga clic en "Update Database"
• Luego cambie ambas cuentas de servicio como se describe abajo

Para cambiar ambas cuentas:

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

También puede configurar la cuenta del Servicio Windows desde Servicios de Windows (services.msc) → clic derecho sobre mindzieStudioService → Propiedades → pestaña Iniciar sesión. No existe equivalente en services.msc para el grupo de aplicaciones; debe cambiarlo en la herramienta de Configuración, o en Administrador de IIS → Grupos de Aplicación → 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 IIS	Permisos de carpeta en Windows
Acceso de lectura/escritura al directorio del servicio	Permisos de carpeta en Windows
Acceso de lectura/escritura al directorio de almacenamiento	Permisos de carpeta en Windows

Use una cuenta con contraseña estable, o establezca un procedimiento para actualizar las credenciales del Servicio Windows y el grupo de aplicaciones cada vez que se cambie la contraseña — el sitio deja de funcionar cuando la contraseña guardada queda obsoleta.

Verificar la Configuración de la Base de Datos

Confirme que la instalación funciona correctamente ANTES de entregar el servidor:

1. El Servicio Windows está "Running". En el diálogo Settings o en services.msc, el estado de mindzieStudioService debe ser Running. Un estado atascado en StartPending, o que vuelve a Stopped después de iniciar, significa que la cuenta no puede abrir la base de datos.
2. El grupo de aplicaciones está Iniciado y la Cuenta muestra su cuenta de servicio.
3. El sitio carga. Navegue a la URL de mindzieStudio e inicie sesión. Un fallo en la base de datos al iniciar causa una página de error en lugar de la pantalla de inicio de sesión.

Paso 4a: Instalar Python (Opcional)

Si planea usar enriquecimientos en Python o acciones con scripts 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. Agregue el enlace https usando el certificado SSL del paso 1
3. Esto no debe ser localhost para instalaciones en producción

DNS recomendado:

• mindziestudio.[nombreempresa].com

Notas Importantes:

• La configuración SSL es requerida para ambientes de producción
• Asegure una gestión apropiada del certificado para seguridad

---

Actualizaciones

---

Configuraciones Adicionales

Actualizaciones

Al actualizar su servidor Enterprise, recuerde que deberá volver a agregar su certificado al sitio en IIS.

Actualización de Licencias

Si ha actualizado su licencia, debe seguir estos pasos para que tenga efecto:

1. Ejecute la herramienta Enterprise Configuration y haga clic en actualizar licencia
2. Reinicie el sitio mindzie en IIS

Integración de IA LLM

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

---

Solución de Problemas

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

Síntoma: La instalación finalizó y la licencia es válida, pero el sitio falla al iniciar 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 Windows, pero el Servicio Windows mindzieStudio y/o el grupo de aplicaciones IIS siguen ejecutándose como Local System. NT AUTHORITY\SYSTEM es la cuenta Local System y no tiene login en su SQL Server. La base de datos está correcta — la aplicación simplemente no tiene identidad con permisos para abrirla. Esto ocurre usualmente cuando solo se cambia la cuenta del servicio Windows y el grupo de aplicaciones mindzieStudioAppPool queda con su configuración predeterminada.

Solución:

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

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

El Servicio No Inicia Después de la Configuración

Si mindzieStudioService queda en StartPending o se detiene inmediatamente, la cuenta de servicio casi siempre no puede acceder a la base de datos. Siga los pasos anteriores y recuerde que un Check exitoso en el diálogo de base de datos solo valida la conexión al servidor SQL — no el acceso a la base de datos mindzie y no desde la cuenta del servicio.

---

Soporte

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

Correo: support@mindzie.com

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

---

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