Instancia de prueba en el mismo host¶
Importante
Versión beta 2.1. Lo que se describe aquí solo existe en la versión beta 2.1: se instala desde el repositorio beta y solo con una licencia; la versión estable 2.0.2 y la versión de demostración no lo incluyen. La versión beta se suministra sin garantías y el soporte se presta en la medida de lo posible (Programa de pruebas beta).
Desde la versión 2.1.2.612, en el host donde funciona el servicio de producción pss se puede iniciar una segunda instancia del streamer, de prueba; por ejemplo, para comprobar una nueva compilación con las mismas fuentes sin detener el nodo de producción. La instancia de prueba trabaja con su propio directorio de configuración y se distingue de la de producción por tres opciones de línea de comandos. Estas opciones no se guardan en el archivo de configuración, por lo que los ajustes copiados del nodo de producción no las incluirán. Sin estas opciones, el streamer arranca como antes.
Opciones de arranque¶
--instance-tag=<etiqueta>Etiqueta de la instancia: de 1 a 16 caracteres, letras latinas minúsculas, cifras y guion. Separa los canales de intercambio con los transcodificadores: sin ella, dos instancias con los mismos números de flujos y salidas interfieren en los transcodificadores de la otra.
--bind-address=<dirección IPv4>La interfaz web, el servidor OTT (HTTP, HTTPS, HTTP/3) y el servidor EPG escuchan solo en esta dirección. Las entradas y salidas de los flujos funcionan con las direcciones de sus propios ajustes. Esta opción no afecta al servidor RTMP (paso 3 más abajo).
--isolatedLa instancia no se comunica con el exterior: quedan desactivados Meshwork y los enlaces con los vecinos, la reserva, los destinatarios externos de alertas (Telegram, correo, webhook, ejecución de un programa) y la comprobación del webhook, la obtención de certificados ACME, las alertas de emergencia CAP (Alertas CAP automáticas), LDAP, PMS y DVB; las operaciones con la licencia (actualización, desvinculación, traslado) responden con un rechazo. También están desactivados los servidores externos de facturación (autorización de los espectadores mediante la facturación). Los ajustes no cambian: todo esto se desactiva solo mientras funciona la instancia. Los flujos propios de la instancia funcionan tal como están configurados.
Con la opción --bind-address o --isolated, un puerto de la interfaz web, del servidor OTT o del servidor EPG que ya está ocupado por otro proceso no lo comparte la instancia, sino que recibe un rechazo: en el registro aparece el error Address already in use, al iniciar y en cada aplicación de los ajustes. Sin esas opciones (solo --instance-tag), ese puerto se comparte con el nodo de producción, y parte de las conexiones va a la instancia de prueba.
Un valor incorrecto de una opción detiene el arranque con un mensaje de error.
Cómo iniciarla¶
Cree el directorio de configuración de la instancia de prueba, por ejemplo
/opt/pss-test/config, y copie en él elpss.propertiesdel nodo de producción.En esta copia de
pss.propertiesindique rutas propias: como mínimo el directorio del registrolog-dir, y además cada ruta de datos que esté definida en él. De lo contrario, ambas instancias escriben en el mismo registro y en la misma base de estadísticas.Fije en los ajustes de la instancia de prueba sus propios puertos: los de la interfaz web (Servidor web y cuentas), del servidor OTT, incluidos HTTPS y HTTP/3 (Servidor HTTP de streaming), y del servidor EPG (Servidor EPG). El puerto que ya escucha el nodo de producción no le corresponderá a la instancia de prueba si esta se inicia con la opción
--bind-addresso--isolated. Si en los ajustes está activado el servidor RTMP (Servidor RTMP), fije para él otros puertos o desactívelo (puerto RTMP 0, RTMPS desactivado): las opciones--bind-addressy--isolatedno actúan sobre él.Inicie la instancia con el directorio de configuración y las opciones:
$ sudo /usr/local/bin/pss -c /opt/pss-test/config --instance-tag=test --bind-address=192.0.2.10 --isolated -C
La opción
-Cmuestra el registro en la consola. Para un funcionamiento permanente, escriba un archivo de servicio systemd aparte: una copia depss.servicecon su propia líneaExecStart; el paquete no instala un segundo archivo de servicio.
Si la instancia funciona con estas opciones se ve en /data/server: los campos instance-tag, isolated="1" y bind-address solo aparecen en una instancia iniciada con la opción correspondiente (Gestión mediante la API HTTP).
Advertencia
--isolated no detiene los flujos. Las salidas de la instancia de prueba (UDP y multicast, publicaciones SRT y RTMP, entre otras) salen a la red de verdad. No repita en ellas los grupos, puertos y direcciones de publicación del nodo de producción. Las entradas leen aquello a lo que apuntan: se puede recibir el mismo multicast que el nodo de producción.
Licencia¶
La instancia de prueba usa la misma clave de protección que el nodo de producción. Cada instancia comprueba los límites de la licencia según sus propios flujos, sin sumarlos con los de la otra. Una clave de red con límite de conexiones simultáneas puede rechazar la segunda instancia; una clave local en este host normalmente no la rechaza. Con --isolated, la instancia de prueba no modifica la licencia del host: desde ella no se puede actualizar ni trasladar.