Sistema
Instalación y despliegue
Tres ejecutables sin dependencias, para Linux y Windows, y un mismo comando de servicio en ambos sistemas.
Esta parte no está en la Referencia del Designer: sale de la documentación de operación y release del repositorio.
Binarios
| Ejecutable | Qué es |
|---|---|
stx | El motor, un proyecto por instancia. |
stx-designer | Consola web, una por servidor. |
stx-trace | Archivo histórico, uno por entorno. |
Cada release produce las tres versiones Linux y las tres de Windows más el kit de instalación; stx --version imprime la versión. Rutas sugeridas: /opt/stx/ en Linux y C:\stx\ en Windows.
Primer arranque
stx --check --config <carpeta> valida el proyecto sin levantarlo (preflight); stx --config <carpeta> lo corre en primer plano para probar. Un proyecto abre hasta tres puertos: el TCP del canal, el puerto web y el puerto de administración.
Servicio del sistema
El mismo comando en ambos sistemas: stx service install --name <proyecto> --config <carpeta>, y luego start, status, stop o uninstall. En Linux crea una unidad systemd que se reinicia sola; en Windows registra el servicio en el SCM con acciones de recuperación. Varios proyectos en un servidor son varios servicios con nombres y puertos distintos. En Windows con autenticación integrada se recomienda una cuenta administrada (gMSA) o una cuenta de dominio fijada en el servicio; la contraseña nunca va en la configuración.
Designer y Trace
stx-designer --set-superadmin-password fija el administrador; stx-designer service install con puerto, workspace, raíz de proyectos y certificado lo deja como servicio en https://<servidor>:8080. Cada proyecto se conecta a su motor con la URL y el token de administración. STX-Trace se instala con stx-trace service install apuntando al workspace y a la carpeta de archivo, o desde el panel del Designer.
Instalador Windows
El kit trae los tres ejecutables, un proyecto demo y un instalador de un comando en PowerShell (además de un setup.exe gráfico) que deja el administrador, la configuración, el servicio del Designer y, si se pide, el primer motor, y abre la consola en el navegador.
Actualización
Detener el servicio, respaldar el binario, copiar el nuevo, correr stx --check y arrancar; de a un proyecto. En Windows, actualizar-windows.ps1 hace todo el ciclo sobre la flota: descubre los servicios, respalda, reemplaza, aplica el perfil estándar, instala Trace si falta, verifica salud y vuelve atrás solo si algo falla.
Verificar salud
GET /admin/health con el token devuelve versión, tiempo encendido, canales con puertos y pools; una llamada real por TCP, SOAP o REST; una transacción que toque la base; y confirmar que se escriben el log y la bitácora del día. El Health también dice la URL real del WSDL y del OpenAPI.