Operacion cartelia

1 Instalación

Instalacion de cartelia

2 Diagnósticos

2.1 Comandos de diagnóstico

# Estado general de la VM desde el host de virtualización
virsh dominfo cartelia-<nombre-del-entorno>
virsh domifaddr cartelia-<nombre-del-entorno>

# Dentro de la VM — estado de servicios
systemctl status apache2 mariadb
systemctl status xibo-xmr.service
journalctl -u apache2 -n 100 --no-pager
journalctl -u xibo-xmr.service -n 100 --no-pager

# Conexión a la base de datos del CMS
mysql -u <usuario-cms> -p -e "SELECT COUNT(*) FROM display;" <bbdd-cms>

# Firewall: reglas activas y contadores por regla
/etc/init.d/firewall status

# Conectividad de los puertos de producto
ss -tlnp | grep -E ':(80|443|9505)\b'

# Prueba del API de players (XMDS): debe responder el WSDL
curl -s "http://localhost/xmds.php?wsdl" | head -5

# Comprobar identidad correcta del clon (no debe coincidir con la plantilla)
cat /etc/machine-id
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

2.2 Ficheros de log

Fichero / origen	Contenido	Rotación
Portal Administración > Avanzado > Log	Log de aplicación del CMS (registro de players, errores XMDS)	Gestionada por la tarea de mantenimiento del CMS
/var/log/apache2/cartelia_access.log, /var/log/apache2/cartelia_error.log (y cartelia_ssl_*.log con el vhost HTTPS activo)	Accesos y errores del servidor web (portal y API XMDS de players)	logrotate estándar de apache2
journalctl -u xibo-xmr.service	Log del servicio XMR	journald
journalctl -u ssh, /var/log/fail2ban.log	Seguridad de acceso al SO	Estándar journald / logrotate

2.3 Errores comunes y soluciones

Síntoma / mensaje	Causa probable	Solución
El portal no carga tras el clonado	La red de la VM no se personalizó o la interfaz cambió de nombre	Revisar ip a, /etc/network/interfaces.d/, y el bridge asignado en libvirt
Los players no consiguen registrarse	CMS Address o CMS Secret Key incorrectos, o 80/443 filtrados	Verificar sección 4.2 y vars.sh del firewall (4.4); probar curl al XMDS desde la red de players
Los players se registran pero no reciben órdenes push	Dirección pública de XMR errónea, proxy /xmr no operativo o xibo-xmr caído	Verificar ws(s)://<FQDN>/xmr en el portal, systemctl status xibo-xmr.service y el módulo proxy_wstunnel de Apache; reiniciar XMR
Aviso de certificado en el navegador	Certificado de la plantilla aún instalado	Sustituir por el certificado del FQDN del entorno
Dos clones aparecen como la misma máquina en DHCP/monitorización	machine-id no regenerado	Ejecutar rm -f /etc/machine-id && systemd-machine-id-setup y reiniciar
El CMS no conecta con la base de datos tras cambiar contraseñas	Contraseña cambiada en settings.php pero no en MariaDB (o viceversa)	Sincronizar ambas (ver sección 4.1)
Sin acceso SSH tras personalizar el firewall	RED_GESTION o IP_LOC erróneas en vars.sh con política final drop	Entrar por virsh console, corregir vars.sh y re-ejecutar /etc/firewall/firewall.sh
La hora de las programaciones no coincide	Zona horaria o NTP sin configurar	timedatectl set-timezone Europe/Madrid y verificar timedatectl status

2.4 Procedimientos básicos

2.4.1 Modificar textos idioma

Herramientas necesarias:

• poedit (https://poedit.com/); nos permitirá:
  • Descompilar fichero ".mo" (el que entiende cartelia) existente a ".po" para modificar textos de idioma
    • Se hace con la herramienta C:\Program Files\Poedit\GettextTools\bin\msgunfmt.exe
    • Ejemplo invocación: msgunfmt.exe "C:\cartelia\locale\es.mo" -o "C:\cartelia\locale\es.po" (las carpetas cambiarán en cada caso)
• Ver las traducciones para un fichero ".po"
• Modificar y "compilar" a fichero ".mo"

La herramienta poedit es de uso sencillo y no requiere de instrucciones específicas para personal técnico de mdtel

Instrucciones para cambiar mensajes

ejemplo para idioma español

entre paréntesis perfil que puede realizar la tarea con seguridad

1. .- (SAT) Obtener el fichero ".mo" original de /var/www/html/cartelia/locale/es.mo; este es un fichero "compilado"
2. .- (PU) Descompilar el fichero con la herramienta msgunfmt
3. .- (PU) Modificar mensajes con "poedit" y compilar
4. .- (SAT) Subir el fichero modificado a /var/www/html/cartelia/locale/es.mo