Comandos de administración y análisis de logs para TIBCO EMS 10.4 con almacenamiento FTL en quórum: tres servidores FTL, un par tolerante a fallos y un servidor en espera. Cambia bastante respecto al EMS clásico (no se arranca con -config y los logs van al servidor FTL), así que aquí tienes lo que cambia y los comandos del día a día, comprobados en la guía de usuario oficial de la versión 10.4. Todo está también en el README.md de la izquierda.
¿Qué vas a aprender?
- Cómo funciona EMS 10.4 con almacenamiento FTL: tres servidores, un par tolerante a fallos y un servidor en espera.
- Cargar la configuración en el clúster FTL y arrancar los servidores.
- Los comandos de
tibemsadminpara revisar el servidor, las colas, los consumidores y los stores. - Dónde están los logs con almacenamiento FTL, cómo ajustar las trazas y cómo analizarlos.
- Comprobar la salud con los endpoints de monitorización y parar el clúster de forma segura.
Requisitos previos
- TIBCO EMS 10.4 y TIBCO FTL 7.0.1 o superior, en Linux (el almacenamiento FTL solo está disponible en Linux).
- Tres máquinas para los tres servidores FTL, con conectividad entre ellas.
- Un usuario administrador de EMS y acceso por terminal (bash) a las tres máquinas.
- Conocer lo básico de EMS: colas, topics, suscripciones duraderas y tolerancia a fallos.
Paso a paso
1. Entiende la arquitectura en quórum
| Pieza | Qué hace |
|---|---|
| Tres servidores FTL | Forman el clúster que replica los datos. Con almacenamiento FTL y tolerancia a fallos hacen falta exactamente tres; con uno solo, el EMS no es tolerante a fallos. |
| Un EMS dentro de cada FTL | Cada servidor EMS (tibemsd) corre como servicio dentro de su servidor FTL, que lo arranca y lo reinicia si se cae. |
| Par tolerante a fallos | Dos de los tres EMS forman el par: el clúster decide cuál está activo. Con -preferred_active indicas cuál prefieres que lo esté. |
Servidor en espera (-standby_only) | El tercero nunca pasa a activo: aporta la réplica de los datos para que haya mayoría. |
| Datos | Cada mensaje persistente se replica al menos en la mayoría de los servidores antes de confirmarse. |
| Configuración | Vive en el clúster FTL, en formato JSON. No se arranca el EMS con -config. |
Los clientes se conectan solo a las URL de los dos servidores del par, nunca a la del servidor en espera.
2. Revisa el YAML del clúster FTL
Los tres servidores FTL comparten un archivo YAML que describe el clúster y los servicios de cada uno. Sus claves principales:
servers: un bloque por servidor FTL (ftl1, ftl2, ftl3), cada uno con sus servicios.tibemsd: el EMS de ese servidor, conexepath(ruta detibemsd),-listens(URL de escucha),-license,-config_wait,-store(directorio de datos) y-monitor_listen(salud y métricas). Uno de los tres lleva además-standby_only.realm: el servicio de realm, con su directoriodata.ftlserver.properties:logfile,max.log.sizeymax.logs, es decir, dónde va el log (también el de EMS) y cómo rota.
El ejemplo completo está en el capítulo Fault Tolerance with FTL Stores de la guía de usuario de EMS 10.4.
3. Carga la configuración de EMS en el clúster
La configuración de EMS (colas, topics, usuarios, stores…) se guarda en el clúster FTL en JSON. Si vienes de una instalación con archivos .conf, conviértelos y súbelos:
# Convertir la configuración clásica (.conf) a JSON
tibemsconf2json -conf tibemsd.conf -json tibemsd.json
# Subirla al clúster FTL (la herramienta necesita las librerías de FTL)
export LD_LIBRARY_PATH=$FTL_HOME/lib
tibemsjson2ftl -url http://ftl1:8080 -json tibemsd.json
# Descargar la configuración actual del clúster (para revisarla o versionarla)
tibemsjson2ftl -url http://ftl1:8080 -json tibemsd-actual.json -download
En stores.conf, los stores son de tipo ftl, con modo sync o async (por defecto, async):
[$sys.failsafe]
type=ftl
mode=sync
[$sys.nonfailsafe]
type=ftl
mode=async
Con almacenamiento FTL se ignoran todos los parámetros ft_* de tibemsd.conf salvo ft_reconnect_timeout, y también listen: la escucha se define en el YAML.
4. Arranca los servidores FTL
Cada servidor FTL arranca su EMS; no se lanza tibemsd a mano:
# En cada una de las tres máquinas, su servidor FTL con el YAML del clúster
tibftlserver -n ftl1 -c /opt/ems/ftl-ems.yaml
tibftlserver -n ftl2 -c /opt/ems/ftl-ems.yaml
tibftlserver -n ftl3 -c /opt/ems/ftl-ems.yaml
5. Conéctate con tibemsadmin
Usa un archivo de contraseña (-pwdfile) en lugar de escribirla en la línea de comandos, para que no quede en el historial:
# Conexión al par tolerante a fallos (las dos URL del par, no la del standby_only)
tibemsadmin -server "tcp://ems1:7222,tcp://ems2:7222" -user admin -pwdfile /opt/ems/.admin.pwd
# En modo script, para automatizar comprobaciones
tibemsadmin -server "tcp://ems1:7222,tcp://ems2:7222" -user admin -pwdfile /opt/ems/.admin.pwd -script comprobaciones.txt
Si hay un cambio de servidor activo, tibemsadmin se desconecta y hay que volver a conectarse.
6. Revisa el estado del servidor
show server # versión, estado, conexiones, memoria y almacenamiento (alias: info)
show state # estado del servidor: activo o en espera
show config # configuración en uso
show stores # stores y su uso
show store $sys.failsafe
time on # añade la hora a cada salida
En un servidor que no está activo solo funcionan algunos comandos: show state, show connections, show server, show config, rotatelog y shutdown.
7. Revisa colas, topics y consumidores
Lo primero ante una incidencia de mensajería: ¿hay mensajes acumulándose?, ¿tienen consumidores?, ¿quién está conectado?
show queues # todas las colas: mensajes pendientes, receptores…
show queues pedidos.* static # por patrón, solo las estáticas
show queue pedidos.entrada # detalle de una cola
show topics
show connections full # clientes conectados, host y usuario
show consumers queue=pedidos.entrada full
show durables # suscripciones duraderas
8. Haz cambios en los destinos
Con autocommit on cada cambio se aplica al momento; si no, hay que confirmarlos con commit. Ojo con purge: borra los mensajes y no se puede deshacer.
autocommit on
create queue pedidos.reintentos maxbytes=100MB
purge queue pedidos.pruebas # vacía la cola (irreversible)
delete queue pedidos.antigua
set server console_trace=DEFAULT,+CONNECT_ERROR,+AUTH
commit # si autocommit está desactivado
9. Ajusta las trazas
Con almacenamiento FTL, los parámetros de log clásicos de EMS (logfile, log_trace, logfile_max_size, logfile_max_count) y el comando rotatelog no se usan. La salida de EMS va al log del servidor FTL que lo aloja, y lo que aparece en él se controla con console_trace:
show config # ver las trazas actuales
set server console_trace=DEFAULT # sustituye el conjunto
set server console_trace=DEFAULT,+CONNECT,+ADMIN # añade categorías
set server console_trace=DEFAULT,-ADMIN # quita una categoría
Algunas categorías útiles: CONNECT y CONNECT_ERROR (conexiones de clientes), AUTH y ACL (autenticación y permisos), ADMIN (operaciones de administración), DEST (destinos), FLOW y LIMITS (control de flujo y límites), FTL, SSL y WARNING. Activa las de detalle solo mientras investigas: generan mucho volumen.
10. Analiza los logs
La ruta y la rotación del log las fija ftlserver.properties en el YAML (logfile, max.log.size, max.logs). Un método de trabajo:
# El log de EMS es el del servidor FTL que lo aloja (ruta de "logfile" en ftlserver.properties)
tail -f /var/log/ems/ftl1.log
# Primer barrido: errores y avisos de las últimas horas
grep -i -E "error|warn|fail" /var/log/ems/ftl1.log | tail -n 100
# Comparar el mismo intervalo en los tres servidores (activo, par y standby)
for s in ftl1 ftl2 ftl3; do echo "== $s"; grep -i -E "error|warn" /var/log/ems/$s.log | tail -n 20; done
- Sitúa la hora de la incidencia y revisa el mismo intervalo en los tres servidores: el problema puede estar en el activo, en su pareja o en la réplica.
- Cruza lo que ves con
show stateyshow connectionsen ese momento. - Si el log no da suficiente detalle, añade la categoría de traza relacionada (paso 9), reproduce el problema y vuelve a quitarla.
11. Comprueba la salud y las métricas
Con -monitor_listen, cada EMS expone endpoints de salud (útiles para el balanceador o Kubernetes) y métricas para Prometheus, que en 10.4 incluyen el estado de la recuperación ante desastres y del disco:
# Endpoints del puerto indicado en -monitor_listen de cada servidor EMS
curl -s http://ems1:7220/isLive
curl -s http://ems1:7220/isReady
curl -s http://ems1:7220/metrics/server
curl -s http://ems1:7220/metrics/queues
12. Para y reinicia de forma segura
Matar el proceso tibemsd no sirve: el servidor FTL lo vuelve a arrancar. Para parar, usa shutdown desde tibemsadmin (para el EMS y su servidor FTL) o tibftladmin:
# Un servidor FTL (y el EMS que aloja)
tibftladmin --ftlserver http://ftl1:8080 --shutdown
# El clúster completo
tibftladmin --ftlserver http://ftl1:8080 --shutdown_cluster
Errores habituales
El EMS no arranca con -config o -ft_active
Con almacenamiento FTL no se admiten -config, -secondary, -ft_active ni -ft_activation: la configuración está en el clúster FTL y el clúster decide el servidor activo.
Los cambios de tolerancia a fallos en tibemsd.conf no hacen nada
Se ignoran todos los ft_* salvo ft_reconnect_timeout, y también listen. Lo que antes iba ahí ahora va en el YAML del clúster.
El log de EMS no aparece donde dice logfile
Con almacenamiento FTL, logfile, log_trace y rotatelog no se usan: mira el log del servidor FTL y ajusta las trazas con console_trace.
Los clientes no se reconectan tras un cambio de servidor activo
La lista de servidores del cliente debe incluir las dos URL del par tolerante a fallos (y nunca la del servidor -standby_only, que no atiende clientes).
tibemsadmin solo acepta algunos comandos
Estás conectado a un servidor que no es el activo. Comprueba con show state y conéctate a la lista del par para llegar al activo.
El proceso tibemsd vuelve a aparecer después de matarlo
Es lo esperado: lo reinicia su servidor FTL. Para pararlo, usa shutdown o tibftladmin (paso 12).
tibemsjson2ftl falla al arrancar
Necesita las librerías de FTL: exporta LD_LIBRARY_PATH=$FTL_HOME/lib antes de ejecutarla.
No se puede configurar el almacenamiento FTL en Windows
El almacenamiento FTL solo funciona en Linux. Para Windows, el EMS tiene que usar almacenamiento en archivos.
Siguientes pasos
- Llevar las métricas de
/metricsa Prometheus y Grafana, con alertas sobre colas acumuladas y servidores no listos. - Configurar un sitio de recuperación ante desastres (
setup_dr_siteyactivate_dr_site). - Proteger las conexiones con TLS y OAuth 2.0, ambos soportados en EMS 10.4.
- Versionar la configuración JSON del clúster y aplicarla con
tibemsjson2ftldesde un pipeline.