Todas las guías
  1. Inicio
  2. Guías técnicas
  3. Integración

IntegraciónNivel avanzado

Administración y análisis de logs de TIBCO EMS 10.4 con almacenamiento FTL en quórum

7 min de lectura

Todas las guías

Administración y análisis de logs de TIBCO EMS 10.4 con almacenamiento FTL en quórum

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 tibemsadmin para 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

PiezaQué hace
Tres servidores FTLForman 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 FTLCada servidor EMS (tibemsd) corre como servicio dentro de su servidor FTL, que lo arranca y lo reinicia si se cae.
Par tolerante a fallosDos 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.
DatosCada mensaje persistente se replica al menos en la mayoría de los servidores antes de confirmarse.
ConfiguraciónVive 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, con exepath (ruta de tibemsd), -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 directorio data.
  • ftlserver.properties: logfile, max.log.size y max.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 state y show connections en 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 /metrics a Prometheus y Grafana, con alertas sobre colas acumuladas y servidores no listos.
  • Configurar un sitio de recuperación ante desastres (setup_dr_site y activate_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 tibemsjson2ftl desde un pipeline.

Compartir

Más guías sobre

Ver todas las guías

Otras guías técnicas

Ver todas las guías

IntegraciónIntermedio

Comandos básicos de administración de TIBCO ActiveSpaces 5.2

Los comandos del día a día en TIBCO ActiveSpaces 5.2: servicio de realm sobre servidores FTL, tibdg, definición del grid, tablas, arranque de procesos, estado, escalado con copysets, checkpoints y logs.

Leer la guía 8 min de lectura

APIsIntermedio

Estructura básica de una API en IBM API Connect 10

Cómo se estructura una API en IBM API Connect 10: contrato OpenAPI con x-ibm-configuration, Client ID y Client Secret, producto con planes y límites, y validación y publicación con el CLI apic.

Leer la guía 7 min de lectura

DevOpsBásico

Estructura básica de un CI/CD con GitHub Actions

Un pipeline completo con GitHub Actions: pruebas en cada push y pull request, imagen Docker en GitHub Container Registry y despliegue a un entorno protegido, con un workflow listo para copiar.

Leer la guía 6 min de lectura

DesarrolloBásico

Buenas prácticas de desarrollo en Java con Spring Boot

Las prácticas que más se notan en un servicio Spring Boot: estructura, inyección por constructor, DTOs, validación, errores, configuración, transacciones, logs, comentarios, pruebas y calidad automatizada.

Leer la guía 8 min de lectura

Contacto

Construye hoy tu próxima ventaja competitiva

Hablemos sobre cómo podemos ayudarte. Te respondemos con una propuesta técnica clara, sin compromiso.

Solicita información

Los campos marcados con son obligatorios.