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

Guía de Bitflow Solutions. Versión web: https://bitflow-solutions.com/guias-tecnicas/administracion-logs-tibco-ems-10-4-ftl-quorum/

## ¿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

### Arquitectura

- 3 servidores FTL (exactamente) con un EMS dentro de cada uno
- Par tolerante a fallos (el clúster elige el activo; -preferred_active)
- Un servidor -standby_only que nunca es activo
- Replicación a la mayoría; configuración en JSON dentro del clúster FTL (sin -config)
- Clientes: solo las URL del par

### YAML del clúster

`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.

### Configuración en el clúster

```bash
# 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
```

stores.conf:

```text
[$sys.failsafe]
  type=ftl
  mode=sync

[$sys.nonfailsafe]
  type=ftl
  mode=async
```

### Arrancar los servidores FTL

```bash
# 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
```

### Conectar con tibemsadmin

```bash
# 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
```

### Estado del servidor (tibemsadmin)

```text
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
```

### Colas, topics y consumidores (tibemsadmin)

```text
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
```

### Cambios en destinos (tibemsadmin)

```text
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
```

### Trazas (console_trace) (tibemsadmin)

```text
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
```

### Analizar los logs

```bash
# 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
```

### Salud y métricas

```bash
# 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
```

### Parar de forma segura

```bash
# 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.

Fuente: TIBCO Enterprise Message Service 10.4.0 User's Guide (docs.tibco.com).
