Aprovisionamiento y recuperación
20 min
descripción general los reproductores brightsign en redes grandes y distribuidas deben cumplir ciertos requisitos de aprovisionamiento y recuperación los socios que deseen configurar sus propios sistemas de aprovisionamiento y recuperación, en lugar de usar bsn cloud, deben asegurarse de que esos sistemas cumplan los siguientes requisitos cada reproductor debe poder aprovisionarse a sí mismo y, una vez aprovisionado, comunicarse periódicamente con el servidor para buscar actualizaciones si está configurado para hacerlo el reproductor y el servidor también deben poder iniciar un proceso de recuperación si el reproductor entra en un estado de error que no puede corregirse reiniciándolo (por ejemplo, corrupción del sistema de archivos causada por pérdida de energía o falla del dispositivo de almacenamiento) para cumplir estos requisitos, deben desarrollarse dos sistemas separados pero complementarios un conjunto de archivos autorun brs que puedan reproducir contenido, facilitar la recuperación ante fallas o aprovisionar el reproductor para un entorno de reproducción html/javascript un servidor manejador de solicitudes para procesar solicitudes http de recuperación/aprovisionamiento enviadas por el reproductor el request handler entrega un archivo autorun u otra respuesta http según la información del reproductor contenida dentro del encabezado de la solicitud la base de datos del request handler también puede contener indicadores condicionales para cada reproductor, que permiten enviar nuevos scripts autorun a reproductores específicos en campo si no se especifica un request handler específico del socio en el registro, bsn cloud proporciona un request handler predeterminado aprovisionamiento del reproductor el aprovisionamiento del reproductor brightsign integra el reproductor en su entorno, principalmente cambiando la configuración del registro para reflejar ese entorno y, normalmente, descargando una aplicación o paquete de configuración al reproductor los siguientes ajustes se configuran dentro del registro durante el aprovisionamiento de brightauthor\ connected o bsn cloud cuenta, nombre de usuario, contraseña y grupo de bsn cloud url de recuperación/aprovisionamiento, url de notificación de errores, url de informe de fallos zona horaria entradas del registro del reproductor las siguientes entradas del registro del reproductor están asociadas con el proceso de aprovisionamiento y recuperación estas claves pueden modificarse accediendo a la sección “networking” del registro usando el objeto brightscript roregistry docid\ kf6wam7iqxizx7adu18g clave de registro descripción ub el prefijo url que se aplica a las url de los valores de clave ru, eu y cu este prefijo no se aplica a un valor de clave que contenga dos puntos ru la url de aprovisionamiento/recuperación utilizada por el reproductor para descargar un script autorun eu la url a la que se envían las notificaciones de error cu la url a la que se envían los informes de fallos p la contraseña del controlador de recuperación ( ru ) especificado arriba las siguientes claves del registro son específicas de bsn cloud, pero los socios pueden modificarlas para afectar el registro de bsn cloud no debe almacenar su propia información en estas secciones porque puede afectar las operaciones de bsn cloud clave de registro descripción a el nombre de la cuenta de bsn cloud a la que pertenece el reproductor u el nombre del usuario de bsn cloud en la cuenta a la que pertenece el reproductor g el grupo de bsn cloud dentro de la cuenta a la que pertenece el reproductor las claves de registro de cuenta, nombre de usuario y grupo se utilizan para el aprovisionamiento/recuperación con bsn cloud un controlador de solicitudes puede usar estas claves, pero no son necesarias procesos de inicio del reproductor estos procesos ocurren cuando un reproductor brightsign se inicia el reproductor se conecta a una red y obtiene una dirección ip el reproductor verifica el dispositivo de almacenamiento para detectar un autorun si se encuentra un autorun, el reproductor ejecutará el autorun y, si no se encuentra ninguno, continuará con los pasos siguientes consulte almacenamiento del reproductor docid\ o4yzospnpfagbglduleee para obtener más información sobre dispositivos de almacenamiento y prioridad de dispositivos (si tiene varios dispositivos de almacenamiento) si existe una dirección ipv4, el reproductor intentará aprovisionarse a través de la red el reproductor verificará si hay una url de recuperación (ru) si se encuentra una url de recuperación dhcp option 43 (ru), esta anulará cualquier valor de registro para ru hasta el final de la concesión dhcp esta url puede configurarse mediante dhcp option 43 consulte opción 43 docid\ esxvrueew zwye1mcgec0 \<font color="#ef1b0600"> \</font> para configurar un servidor dhcp para comunicar esta url a un reproductor brightsign si no se encuentra dhcp option 43 ru, se utilizará el ru configurado en el registro si no hay un valor de registro para ru, este paso se omitirá si la url de recuperación está vacía, el reproductor intentará lo siguiente aprovisionamiento de host bien conocido también conocido como mapeo de nombre personalizado en el servidor dns de su red si una dirección ip está asignada a brightsign b deploy , el reproductor intentará usar la ip asociada para aprovisionarse automáticamente aprovisionamiento en la nube de b deploy consulte b deploy/apis de aprovisionamiento docid 1is4 wl6mcli4d1t5lyda dns de multidifusión (mdns) el reproductor verificará automáticamente la ubicación estándar de mdns ( http //brightsign b deploy local/) y, si hay un servidor en su red con esa dirección, el reproductor se aprovisionará automáticamente sin embargo, no puede haber otros métodos de aprovisionamiento activos si desea aprovisionar con mdns consulte el apéndice al final de esta página para obtener más información sobre esta opción el reproductor reintentará el proceso de aprovisionamiento cada 30 segundos hasta que haya una respuesta satisfactoria o una interrupción parámetros de solicitud de url estos parámetros se utilizan para la comunicación entre un reproductor y el controlador de solicitudes parámetros de solicitud del reproductor los siguientes parámetros se incluyen en el encabezado de las solicitudes http get que un reproductor envía a la url de aprovisionamiento/recuperación parámetro valor de ejemplo descripción devicemodel xt1144 la designación del modelo del reproductor brightsign devicefamily malibú la designación de la familia del reproductor brightsign id del dispositivo d5e86p001287 el número de serie único del reproductor versión del firmware del dispositivo 8 2 42 la versión del sistema operativo (firmware) instalada actualmente en el reproductor tiempo de actividad del dispositivo 240 la cantidad de tiempo (en segundos) desde que se inició el reproductor modo de recuperación anular el modo de la solicitud url actual override la solicitud http get inicial de un reproductor con un script autorun válido periodic solicitudes http get posteriores de un reproductor con un script autorun válido last resort la solicitud http get de un reproductor sin un script autorun válido crashdump sí una marca que indica que el arranque actual fue iniciado por un reinicio forzado debido a un fallo (este encabezado solo está presente si es verdadero) estado del almacenamiento usb1=none;sd=autorun; sd2=storage;ssd=none; el estado actual de autorun y del sistema de archivos de cada dispositivo de almacenamiento claves opcionales de bsn cloud parámetro valor de ejemplo descripción cuenta bsaccount el valor de registro a descrito anteriormente usuario bsuser el valor de registro u descrito anteriormente grupo bsgroup el valor de registro g descrito anteriormente contraseña bspassword el valor de registro p descrito anteriormente parámetros de estado de almacenamiento el valor de estado del almacenamiento contiene una lista de pares clave valor que indican el estado de cada dispositivo de almacenamiento se devuelven las siguientes claves de dispositivos de almacenamiento clave de brightscript clave de estado de almacenamiento usb1 usb1 sd sd sd2 sd2 ssd ssd estos valores de estado pueden devolverse para cada dispositivo de almacenamiento valor de estado del almacenamiento descripción ninguno no se detectó el dispositivo de almacenamiento almacenamiento el dispositivo de almacenamiento está presente, pero no se detectó un script de autorun autorun el dispositivo de almacenamiento está presente y contiene un archivo autorun brs o autorun zip autorun load error el dispositivo de almacenamiento está presente y contiene un archivo autorun brs o autorun zip que no se pudo cargar autorun runtime error el dispositivo de almacenamiento está presente y contiene un archivo autorun brs o autorun zip que encontró un error de ejecución error el dispositivo de almacenamiento está presente, pero falló una comprobación del sistema de archivos este valor también implica que los intentos de reparar el sistema de archivos también fallaron parámetros de respuesta del servidor el encabezado de una respuesta del controlador de solicitudes puede contener un único parámetro este parámetro puede acompañar una respuesta http 204 o 200 (incluso si el cuerpo de la respuesta está vacío) parámetro valor de ejemplo descripción retry after 7200 la cantidad de tiempo (en segundos) que el reproductor debe esperar para realizar una solicitud periódica a la url de aprovisionamiento/recuperación si no se proporciona este parámetro, el intervalo de solicitud predeterminado será de dos horas recuperación del reproductor si no se encuentra un autorun válido, se activa una recuperación en una recuperación, el reproductor descarga contenido desde la url de recuperación (almacenada en el registro) e intenta ejecutarlo no se deben confundir el proceso de recuperación y la url de recuperación aunque el proceso de recuperación utiliza la url de recuperación, algunos escenarios de implementación también utilizan la url de recuperación y esta también es la url de aprovisionamiento en el registro anular recuperación una vez que se haya completado el proceso de arranque, el reproductor escanea cada dispositivo de almacenamiento para determinar si uno o más dispositivos contienen un archivo autorun si al menos un dispositivo contiene un archivo autorun, el reproductor retrasará la ejecución del autorun mientras un proceso en segundo plano envía una solicitud http get (que contiene parámetros que describen el reproductor en el encabezado) a la url de aprovisionamiento/recuperación si el controlador de solicitudes responde utilizando un código http 200 con un cuerpo no vacío, el reproductor utilizará el cuerpo de la respuesta como el nuevo script autorun si el controlador de solicitudes responde con un código http 204, o un código http 200 que contiene un cuerpo de mensaje vacío, el reproductor ejecutará el script autorun preexistente con normalidad la respuesta también puede incluir un encabezado "retry after" que indica (en segundos) con qué frecuencia el reproductor debe comunicarse con el controlador de solicitudes si este parámetro no se especifica, el intervalo de comprobación predeterminado será de dos horas si no se recibe ninguna respuesta dentro de 20 segundos, se ejecutará el autorun preexistente el reproductor enviará otra solicitud al controlador de solicitudes después de cinco minutos y luego después de 10 minutos luego realizará una solicitud una vez cada dos horas si varios dispositivos de almacenamiento contienen un archivo autorun, el reproductor seleccionará el primer autorun en el siguiente orden usb, sd, sd2, ssd si tarda demasiado en comprobar la integridad de un dispositivo de almacenamiento, ese dispositivo podría omitirse en el orden de selección de autorun, por lo que no debe crear un sistema que dependa de este orden si ninguno de los dispositivos contiene un autorun, el reproductor entrará en el modo de recuperación de último recurso recuperación periódica el reproductor enviará periódicamente una solicitud http get a la url de aprovisionamiento y recuperación para determinar si el dispositivo debe actualizarse si no se recibe ninguna respuesta, el autorun preexistente continuará sin interrupción si el controlador de solicitudes responde con un código http 204, o un código http 200 que contiene un cuerpo de mensaje vacío, el autorun preexistente continuará sin interrupción la respuesta también puede incluir un encabezado "retry after" que indique (en segundos) con qué frecuencia el reproductor debe comunicarse con el controlador de solicitudes si este parámetro no se especifica, el intervalo de comprobación se establecerá de forma predeterminada en dos horas si el controlador de solicitudes responde usando un código http 200 con un cuerpo no vacío, el reproductor utilizará el cuerpo de la respuesta como el nuevo script autorun diagram1a png recuperación de último recurso si ninguno de los dispositivos de almacenamiento conectados contiene un archivo autorun, o si el autorun designado encuentra un autorun load error o autorun runtime error , entonces comenzará la recuperación de último recurso el reproductor envía una solicitud http get a la url de aprovisionamiento/recuperación el encabezado de esta solicitud contiene información sobre el reproductor, así como el estado de los dispositivos de almacenamiento y los archivos autorun en el reproductor esto permite que el controlador de solicitudes determine el curso de acción correcto en función de los atributos y el estado actual del reproductor si el controlador de solicitudes responde usando un código http 200 con un cuerpo no vacío, el reproductor utilizará el cuerpo de la respuesta como el nuevo script autorun el script autorun debe reiniciar el reproductor una vez que realice las tareas de recuperación necesarias (el reproductor no se reiniciará automáticamente) si el controlador de solicitudes responde con un código http 204, o un código http 200 que contiene un cuerpo de mensaje vacío, el reproductor se reiniciará inmediatamente si el controlador de solicitudes no responde, el reproductor continuará enviando solicitudes durante 30 minutos antes de reiniciarse alternativamente, se producirá un reinicio después de solo 5 minutos si el script autorun ha encontrado un autorun runtime error este proceso se repetirá indefinidamente hasta que se reciba un script autorun del controlador de solicitudes diagram3 png apéndice mdns multicast dns es un protocolo dns único desarrollado para redes pequeñas estos diagramas muestran las diferencias entre una configuración dns normal y una configuración mdns tenga en cuenta que multicast dns no está habilitado de forma predeterminada en todas las redes screenshot 2024 03 22 at 1 17 38 pm png configurar un servidor de recuperación / aprovisionamiento el siguiente diagrama de flujo de trabajo describe una implementación simple de controlador de solicitudes este flujo de trabajo asume la implementación de una base de datos que puede asociar indicadores de recuperación forzada con un dispositivo individual o un grupo de dispositivos un script de aprovisionamiento un script de recuperación que primero reformatea el dispositivo de almacenamiento un script de recuperación que no reformatea el dispositivo de almacenamiento este flujo de trabajo no implementa las siguientes funciones diferentes scripts de aprovisionamiento según el deviceid o group (u otros parámetros http get) múltiples scripts autorun de aprovisionamiento o recuperación para diferentes almacenamientos screenshot 2024 03 22 at 10 46 21 am png siguiente archivos autorun > docid\ pnyzbynbn0la0ngpgmihl