Instalacion cartelia 10 - Historial de revisiones

Alfredo.rodriguez: /* Configuración desde el portal de administración de Cartelia */

2026-07-13T10:26:50Z

Configuración desde el portal de administración de Cartelia

Alfredo.rodriguez: /* Configuración desde el portal de administración de Cartelia */

2026-07-13T10:25:10Z

Configuración desde el portal de administración de Cartelia

Alfredo.rodriguez: /* Ficheros de configuración del producto */

2026-07-13T10:19:14Z

Ficheros de configuración del producto

Alfredo.rodriguez: /* Ficheros de configuración del producto */

2026-07-13T10:18:59Z

Ficheros de configuración del producto

Alfredo.rodriguez: /* Firewall (/etc/firewall/) */

2026-07-13T10:05:49Z

Firewall (/etc/firewall/)

Alfredo.rodriguez: /* Firewall (/etc/firewall/) */

2026-07-13T10:05:28Z

Firewall (/etc/firewall/)

Alfredo.rodriguez: /* Diagnósticos */

2026-07-13T10:04:25Z

Diagnósticos

Alfredo.rodriguez en 09:36 13 jul 2026

2026-07-13T09:36:18Z

Alfredo.rodriguez: /* Comandos de diagnóstico */

2026-07-13T09:35:42Z

Comandos de diagnóstico

Alfredo.rodriguez: /* Firewall (/etc/firewall/) */

2026-07-13T09:35:24Z

Firewall (/etc/firewall/)

@@ Línea 151: / Línea 151: @@
 * <code>''Administración > Configuración > Red''</code>: establecer la dirección del CMS (<code>CMS Address</code>) con el FQDN definitivo. Los players usan este valor para conectarse.
-* ''Administración > Configuración'', pestaña '''Configuración''', campo '''"Clave secreta de CMS"''': es la clave que debe introducirse en cada player para autenticarlo contra el CMS. En un clon es idéntica a la de la máquina base (y, por tanto, conocida por cualquier otro despliegue), así que debe sustituirse por una clave nueva y única en cada cliente.
+* <code>''Administración > Configuración''</code>, pestaña <code>'''Configuración'''</code>, campo <code>'''"Clave secreta de CMS"'''</code>: es la clave que debe introducirse en cada player para autenticarlo contra el CMS. En un clon es idéntica a la de la máquina base (y, por tanto, conocida por cualquier otro despliegue), así que debe sustituirse por una clave nueva y única en cada cliente.
-* ''Administración > Configuración'', pestaña '''Configuración''', campo '''"Ubicación de la biblioteca"''': verificar que mantiene el valor <code>/var/lib/cartelia/library/</code>; no cambiarlo, ya que debe coincidir con la directiva <code>XSendFilePath</code> de los vhosts de Apache.
+* <code>''Administración > Configuración''</code>, pestaña <code>'''Configuración'''</code>, campo <code>'''"Ubicación de la biblioteca"'''</code>: verificar que mantiene el valor <code>/var/lib/cartelia/library/</code>; no cambiarlo, ya que debe coincidir con la directiva <code>XSendFilePath</code> de los vhosts de Apache.
-* ''Administración > Configuración'', pestaña '''Red''' (sección XMR): establecer la dirección pública de XMR como <code>ws://<FQDN-del-CMS>/xmr</code> (o <code>wss://<FQDN-del-CMS>/xmr</code> si está activo el vhost HTTPS). Los players se conectan por WebSocket a través del proxy de Apache; el puerto 9505 permanece abierto en el firewall únicamente como vía alternativa de publicación directa.
+* <code>''Administración > Configuración''</code>, pestaña <code>'''Red'''</code> (sección XMR): establecer la dirección pública de XMR como <code>ws://<FQDN-del-CMS>/xmr</code> (o <code>wss://<FQDN-del-CMS>/xmr</code> si está activo el vhost HTTPS). Los players se conectan por WebSocket a través del proxy de Apache; el puerto 9505 permanece abierto en el firewall únicamente como vía alternativa de publicación directa.
 Los cambios de claves y direcciones obligan a volver a autorizar los displays que estuvieran dados de alta en la máquina base (en un despliegue nuevo no debería haber ninguno; si los hubiera, eliminarlos).

@@ Línea 150: / Línea 150: @@
 Acceder con el usuario '''<code>admin</code>''' y la contraseña estándar de la máquina base (conocida por el SAT; no se documenta aquí) y cambiar dicha contraseña de inmediato, ya que es común a todos los clones. A continuación:
-* ''Administración > Configuración > Red'': establecer la dirección del CMS (<code>CMS Address</code>) con el FQDN definitivo. Los players usan este valor para conectarse.
+* <code>''Administración > Configuración > Red''</code>: establecer la dirección del CMS (<code>CMS Address</code>) con el FQDN definitivo. Los players usan este valor para conectarse.
 * ''Administración > Configuración'', pestaña '''Configuración''', campo '''"Clave secreta de CMS"''': es la clave que debe introducirse en cada player para autenticarlo contra el CMS. En un clon es idéntica a la de la máquina base (y, por tanto, conocida por cualquier otro despliegue), así que debe sustituirse por una clave nueva y única en cada cliente.
 * ''Administración > Configuración'', pestaña '''Configuración''', campo '''"Ubicación de la biblioteca"''': verificar que mantiene el valor <code>/var/lib/cartelia/library/</code>; no cambiarlo, ya que debe coincidir con la directiva <code>XSendFilePath</code> de los vhosts de Apache.

← Revisión anterior		Revisión del 10:19 13 jul 2026
Línea 134:		Línea 134:

	'''XMR''' (<code>xibo-xmr.service</code>, unidad en <code>/etc/systemd/system/xibo-xmr.service</code>): ejecuta <code>/var/www/html/cartelia/vendor/bin/xmr.phar</code> con PHP como usuario <code>www-data</code>, con reinicio automático (<code>Restart=always</code>).		'''XMR''' (<code>xibo-xmr.service</code>, unidad en <code>/etc/systemd/system/xibo-xmr.service</code>): ejecuta <code>/var/www/html/cartelia/vendor/bin/xmr.phar</code> con PHP como usuario <code>www-data</code>, con reinicio automático (<code>Restart=always</code>).
		+	<br>
	Sockets por defecto: WebSocket para players en <code>127.0.0.1:8080</code>, expuesto a través del proxy <code>/xmr</code> del vhost de Apache, y publicación interna del CMS en <code>tcp://127.0.0.1:50001</code>.		Sockets por defecto: WebSocket para players en <code>127.0.0.1:8080</code>, expuesto a través del proxy <code>/xmr</code> del vhost de Apache, y publicación interna del CMS en <code>tcp://127.0.0.1:50001</code>.

@@ Línea 133: / Línea 133: @@
 |}
-'''XMR''' (<code>xibo-xmr.service</code>, unidad en <code>/etc/systemd/system/xibo-xmr.service</code>): ejecuta <code>/var/www/html/cartelia/vendor/bin/xmr.phar</code> con PHP como usuario <code>www-data</code>, con reinicio automático (<code>Restart=always</code>). Sockets por defecto: WebSocket para players en <code>127.0.0.1:8080</code>, expuesto a través del proxy <code>/xmr</code> del vhost de Apache, y publicación interna del CMS en <code>tcp://127.0.0.1:50001</code>.
+'''XMR''' (<code>xibo-xmr.service</code>, unidad en <code>/etc/systemd/system/xibo-xmr.service</code>): ejecuta <code>/var/www/html/cartelia/vendor/bin/xmr.phar</code> con PHP como usuario <code>www-data</code>, con reinicio automático (<code>Restart=always</code>).
 Tras cualquier cambio: <code>systemctl restart xibo-xmr.service</code>.

@@ Línea 213: / Línea 213: @@
 <div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
 	'''⚠️ ATENCION !!'''
-	'''Riesgo operativo''': editar <code>IP_LOC</code> o <code>RED_GESTION</code> con valores erróneos y ejecutar el script '''puede dejar la máquina inaccesible por SSH''' (la política final es <code>drop</code>). Realizar siempre el cambio con una consola de <code>virsh console</code> abierta como vía de recuperación.
+	'''Riesgo operativo''': editar <code>IP_LOC</code> o <code>RED_GESTION</code> con valores erróneos y ejecutar el script '''puede dejar la máquina inaccesible por SSH''' (la política final es <code>drop</code>).<br> Realizar siempre el cambio con una consola de <code>virsh console</code> abierta como vía de recuperación.
 </div>

← Revisión anterior		Revisión del 10:05 13 jul 2026
Línea 211:		Línea 211:
	</pre>		</pre>

−	~~{{Aviso\|~~'''Riesgo operativo''': editar <code>IP_LOC</code> o <code>RED_GESTION</code> con valores erróneos y ejecutar el script '''puede dejar la máquina inaccesible por SSH''' (la política final es <code>drop</code>). Realizar siempre el cambio con una consola de <code>virsh console</code> abierta como vía de recuperación.}}	+	<div style="background-color: #fef6e7; border: 1px solid #fbd68a; padding: 1em; border-radius: 4px;width: fit-content; margin-left: 0px">
		+	'''⚠️ ATENCION !!'''
		+	'''Riesgo operativo''': editar <code>IP_LOC</code> o <code>RED_GESTION</code> con valores erróneos y ejecutar el script '''puede dejar la máquina inaccesible por SSH''' (la política final es <code>drop</code>). Realizar siempre el cambio con una consola de <code>virsh console</code> abierta como vía de recuperación.
		+	</div>

← Revisión anterior		Revisión del 10:04 13 jul 2026
Línea 212:		Línea 212:

	{{Aviso\|'''Riesgo operativo''': editar <code>IP_LOC</code> o <code>RED_GESTION</code> con valores erróneos y ejecutar el script '''puede dejar la máquina inaccesible por SSH''' (la política final es <code>drop</code>). Realizar siempre el cambio con una consola de <code>virsh console</code> abierta como vía de recuperación.}}		{{Aviso\|'''Riesgo operativo''': editar <code>IP_LOC</code> o <code>RED_GESTION</code> con valores erróneos y ejecutar el script '''puede dejar la máquina inaccesible por SSH''' (la política final es <code>drop</code>). Realizar siempre el cambio con una consola de <code>virsh console</code> abierta como vía de recuperación.}}
−
−	~~= Diagnósticos =~~
−
−	~~== Comandos de diagnóstico ==~~
−
−	<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
−	~~# 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~~
−	~~</pre>~~
−
−	~~== Ficheros de log ==~~
−
−	~~{\| class="wikitable"~~
−	~~! 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~~
−	\|-
−	\| <code>/var/log/apache2/cartelia_access.log</code>, <code>/var/log/apache2/cartelia_error.log</code> (y <code>cartelia_ssl_*.log</code> con el vhost HTTPS activo) \|\| Accesos y errores del servidor web (portal y API XMDS de players) \|\| logrotate estándar de apache2
−	\|-
−	~~\| <code>journalctl -u xibo-xmr.service</code> \|\| Log del servicio XMR \|\| journald~~
−	\|-
−	~~\| <code>journalctl -u ssh</code>, <code>/var/log/fail2ban.log</code> \|\| Seguridad de acceso al SO \|\| Estándar journald / logrotate~~
−	\|}
−
−	~~== Errores comunes y soluciones ==~~
−
−	~~{\| class="wikitable"~~
−	~~! 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 <code>ip a</code>, <code>/etc/network/interfaces.d/</code>, y el bridge asignado en libvirt
−	\|-
−	\| Los players no consiguen registrarse \|\| <code>CMS Address</code> o <code>CMS Secret Key</code> incorrectos, o 80/443 filtrados \|\| Verificar sección 4.2 y <code>vars.sh</code> del firewall (4.4); probar <code>curl</code> 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 <code>/xmr</code> no operativo o <code>xibo-xmr</code> caído \|\| Verificar <code>ws(s)://<FQDN>/xmr</code> en el portal, <code>systemctl status xibo-xmr.service</code> y el módulo <code>proxy_wstunnel</code> 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 \|\| <code>machine-id</code> no regenerado \|\| Ejecutar <code>rm -f /etc/machine-id && systemd-machine-id-setup</code> y reiniciar~~
−	\|-
−	~~\| El CMS no conecta con la base de datos tras cambiar contraseñas \|\| Contraseña cambiada en <code>settings.php</code> pero no en MariaDB (o viceversa) \|\| Sincronizar ambas (ver sección 4.1)~~
−	\|-
−	\| Sin acceso SSH tras personalizar el firewall \|\| <code>RED_GESTION</code> o <code>IP_LOC</code> erróneas en <code>vars.sh</code> con política final <code>drop</code> \|\| Entrar por <code>virsh console</code>, corregir <code>vars.sh</code> y re-ejecutar <code>/etc/firewall/firewall.sh</code>
−	\|-
−	~~\| La hora de las programaciones no coincide \|\| Zona horaria o NTP sin configurar \|\| <code>timedatectl set-timezone Europe/Madrid</code> y verificar <code>timedatectl status</code>~~
−	\|}

← Revisión anterior		Revisión del 09:36 13 jul 2026
Línea 1:		Línea 1:
	[[:Media:cartelia-despliegue-vm-documentacion-tecnica.pdf\|Instalación de Cartelia 1.0]]		[[:Media:cartelia-despliegue-vm-documentacion-tecnica.pdf\|Instalación de Cartelia 1.0]]
		+	<br>
	---		---

@@ Línea 216: / Línea 216: @@
 == Comandos de diagnóstico ==
-<syntaxhighlight lang="bash">
+<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
 # Estado general de la VM desde el host de virtualización
 virsh dominfo cartelia-<nombre-del-entorno>
@@ Línea 242: / Línea 242: @@
 cat /etc/machine-id
 ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
-</syntaxhighlight>
+</pre>
 == Ficheros de log ==

@@ Línea 198: / Línea 198: @@
 Aplicación y verificación de cambios:
-<syntaxhighlight lang="bash">
+<pre style="background-color: #f6f8fa; border: 1px solid #d1d5da; padding: 1em; border-radius: 4px; width: fit-content; margin-left: 0px; font-family: 'Ubuntu Mono', 'Consolas', monospace; white-space: pre-wrap;">
 # Aplicar (corta y recrea todas las reglas; las conexiones establecidas se mantienen)
 /etc/init.d/firewall start
@@ Línea 208: / Línea 208: @@
 ssh <usuario>@<IP-del-servidor>          # el 22 debe seguir accesible
 curl -Is http://<IP-del-servidor>/ | head -1
-</syntaxhighlight>
+</pre>
 {{Aviso|'''Riesgo operativo''': editar <code>IP_LOC</code> o <code>RED_GESTION</code> con valores erróneos y ejecutar el script '''puede dejar la máquina inaccesible por SSH''' (la política final es <code>drop</code>). Realizar siempre el cambio con una consola de <code>virsh console</code> abierta como vía de recuperación.}}