Opción 43
13 min
un reproductor brightsign puede descargar su script autorun y otros recursos de presentación desde un valor url almacenado en su registro esta función puede utilizarse para aprovisionar un reproductor en campo también permite que un reproductor se recupere automáticamente de errores de tiempo de ejecución o de carga asociados con el script autorun el valor url en el registro puede sobrescribirse mediante dhcp option 43, lo que significa que, con una infraestructura de red configurada correctamente, los reproductores pueden configurarse por sí mismos y comenzar a reproducir contenido sin configuración manual en el sitio esta página describe cómo configurar un sistema de aprovisionamiento que utiliza dhcp option 43 el dispositivo b deploy appliance también puede utilizar dhcp option 43 la solución descrita en esta página utiliza un servidor de aprovisionamiento de terceros (es decir, uno que usted mismo configura) en lugar del b deploy appliance descripción general recuperación / bootstraping cuando un reproductor brightsign arranca (y a intervalos periódicos mientras está en ejecución), dirigirá una solicitud http get a la url de aprovisionamiento/recuperación almacenada en el registro del reproductor, que está vacía de forma predeterminada de fábrica el encabezado de la solicitud http get incluye los siguientes parámetros parámetro valor de ejemplo descripción cuenta bsaccount el valor de registro a usuario bsuser el valor de registro u grupo bsgroup el valor de registro g contraseña bspassword el valor de registro p devicemodel xd1230 la designación del modelo del reproductor brightsign devicefamily guepardo la designación de la familia del reproductor brightsign deviceid x2f2cu0000065 el número de serie del reproductor versión de firmware del dispositivo 4 7 146 la versión del firmware actualmente instalado en el reproductor deviceuptime 240 la cantidad de tiempo (en segundos) desde que el reproductor se inició modo de recuperación anular el modo de la solicitud url actual anular la solicitud http get inicial de un reproductor con un script autorun válido periódico solicitudes http get posteriores de un reproductor con un script autorun válido último recurso 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 de almacenamiento usb1=none;sd=autorun; sd2=storage;ssd=none; el estado actual de autorun y del sistema de archivos de cada dispositivo de almacenamiento si la solicitud http get se realiza correctamente, el reproductor intentará utilizar cualquier contenido descargado como un script de ejecución automática tenga en cuenta que el reproductor no realiza ninguna comprobación para determinar si el contenido es realmente un archivo autorun brs antes de intentar ejecutarlo descripción general de la configuración de aprovisionamiento la siguiente infraestructura es necesaria para aprovisionar reproductores mediante dhcp option 43 servidor dhcp ubicado en la red local y configurado para la comunicación de option 43 url del script de aprovisionamiento una url que devuelve el script de aprovisionamiento brs url del paquete de aprovisionamiento una url que devuelve el paquete de aprovisionamiento zip url de actualización de firmware (opcional) una url que devuelve un archivo de actualización de firmware si es necesario configuración del servidor dhcp formatos de cadena de solicitud/respuesta cuando un reproductor brightsign solicita información de un servidor dhcp, la consulta incluirá una cadena option 60 que contiene la identidad del proveedor del reproductor \[bs oem id] + “ “ + \[bs oem model] (por ejemplo, “brightsign xd1230”) el servidor dhcp puede utilizar esta cadena para hacer coincidir la respuesta option 43 correcta para el proveedor y el número de modelo del dispositivo como alternativa, la respuesta correcta puede determinarse utilizando otra información disponible para un servidor dhcp, incluido el id del suscriptor cuando se utiliza asignación de ip basada en puerto la respuesta debe ser una cadena option 43 compuesta por datos codificados tlv (type length value), y la url de aprovisionamiento/recuperación debe definirse utilizando tag 85 (0x55 o ascii “u”) la etiqueta y la longitud tienen 1 byte cada una la longitud también debe codificarse utilizando hexadecimal o ascii aunque el valor de respuesta formateado puede establecerse fácilmente en un servidor linux, la configuración de servidores microsoft requiere pasos adicionales https //blogs technet microsoft com/troubleshooting walk through/2013/11/01/what comes with option 43 and configuring in dhcp/ configuración del reproductor cuando el reproductor recibe la respuesta option 43, sobrescribirá la url predeterminada en el registro con el valor de la cadena de respuesta el valor proporcionado por el servidor dhcp no se guarda en el almacenamiento persistente; la sobrescritura del registro permanece activa únicamente mientras el arrendamiento dhcp siga activo si es necesario, el script de recuperación/aprovisionamiento puede cambiar permanentemente el valor del registro utilizando funciones brightscript el reproductor puede almacenar una url diferente para cada interfaz de red cuando se reciben múltiples respuestas dhcp desde diferentes interfaces de red, el reproductor elegirá recuperarse o iniciar mediante bootstrap utilizando el primer valor de url no vacío en el siguiente orden de interfaces ethernet wifi 3g verificar la configuración de option 43 para verificar que el reproductor responde correctamente al servidor dhcp, acceda al shell de brightsign mediante el puerto serie (consulte la página consola de depuración de brightscript docid\ czmluexqbknt0kespzo1o para obtener más detalles) en el prompt de brightsign, escriba "ifconfig" si la acción de option 43 se ha realizado correctamente, se devolverá la nueva url de aprovisionamiento/recuperación; si la acción no se realizó correctamente, se devolverá la url predeterminada de brightsign network para verificar que el reproductor realmente envía solicitudes de aprovisionamiento/recuperación a la url, puede revisar los registros del servidor web que entrega el script de recuperación también puede usar tcpdump o wireshark en la red local para ver la solicitud http get del reproductor ejemplo de codificador el siguiente script simple de página web puede utilizarse para convertir una url al formato hexadecimal adecuado para usarlo con cadenas option 43 brightsign option 43 recovery url encoding brightsign option 43 recovery url encoding enter the required recovery url below configuración del servidor de aprovisionamiento script de aprovisionamiento una vez que el reproductor recibe la respuesta option 43, realizará una solicitud http get a la url contenida en la respuesta el servidor de aprovisionamiento debe examinar el encabezado storagestatus de la solicitud si "autorun" está presente en la cadena, debe devolver el código 204; de lo contrario, debe devolver el código 200 con el script de aprovisionamiento brs en el cuerpo de la respuesta el script de aprovisionamiento debe, a su vez, sobrescribir la url de recuperación en el registro y descargar el paquete de aprovisionamiento desde una url separada de forma predeterminada, los servidores iis no permiten archivos brs porque no son un tipo mime registrado si está utilizando un servidor iis para distribuir el script de aprovisionamiento brs , asegúrese de registrar brs como un tipo mime "text/plain" el provisingscript brs https //github com/brightsign/general tools/blob/main/brightscript/option43 provision script/provisioningscript brs de brightsign en github proporciona una plantilla para descargar un paquete de presentación y/o un archivo de firmware para usar este script, deberá reemplazar los siguientes valores en el script con valores específicos de su aplicación \##filename1## el nombre del archivo después de descargarse al almacenamiento local (por ejemplo, "autorun zip") ##filetype1## el tipo de archivo, que puede ser "presentation" o "firmware" ##url1## la url de descarga del archivo ##addbsheaders1## un indicador que especifica si se deben agregar encabezados a la solicitud http, incluidos valores del dispositivo como el número de serie y la versión del firmware este valor puede ser true o false ##optionalheaders## un conjunto de uno o más encabezados opcionales para agregar a la solicitud http estos encabezados solo se agregan si ##addbsheaders1## se reemplaza por verdadero el siguiente ejemplo muestra cómo dar formato a un encabezado opcional en el script "xfer addheader(\\"authorization\\", \\"bearer " + authtoken + "\\")" hay un segundo conjunto de valores en el script ( ##filename2## , ##filetype2## , etc ) si desea descargar tanto un paquete de presentación como un archivo de firmware, reemplácelos con los valores apropiados si desea que el script descargue solo un único archivo, establezca los valores de cadena como invalid y el valor boolean como false el script también contiene un campo ##recoveryurl## , que es la nueva url de recuperación que se escribirá en el registro del reproductor es probable que este valor sea el mismo que la url especificada en la respuesta de option 43, que de otro modo volverá al valor predeterminado cuando expire el arrendamiento dhcp paquete de aprovisionamiento el script de aprovisionamiento debe llamar a url adicionales para descargar el paquete de presentación y/o los archivos de actualización de firmware el paquete de presentación debe ser un archivo zip que contenga los archivos necesarios si el aprovisionamiento se realiza con el script incluido provisioningscript brs , el reproductor desempaquetará automáticamente un archivo descargado zip sin requerir ningún script adicional ni convenciones de nombres si está utilizando su propio script de aprovisionamiento (o como precaución adicional), asigne al paquete de presentación el nombre autorun zip e incluya el script autozip brs , que también se incluye con este documento