Option 43

a brightsign player can download its autorun script and other presentation assets from a url value stored in its registry this feature can be used to provision a player in the field it also allows a player to automatically recover from run time or load errors associated with the autorun script the url value in the registry can be overridden using dhcp option 43, meaning that, with properly configured network infrastructure, players can set themselves up and begin playing content without manual on site configuration this page outlines how to set up a provisioning system that uses dhcp option 43 the b deploy appliance may also use dhcp option 43 the solution outlined on this page makes use of a third party provisioning server (i e one you set up yourself) rather than the b deploy appliance overview recovery / bootstraping when a brightsign player boots (and at periodic intervals while running), it will direct an http get request at the provisioning/recovery url stored in the player registry, which is blank as a factory default the header of the http get request includes the following parameters parameter example value description account bsaccount the a registry value user bsuser the u registry value group bsgroup the g registry value password bspassword the p registry value devicemodel xd1230 the model designation of the brightsign player devicefamily cheetah the family designation of the brightsign player deviceid x2f2cu0000065 the serial number of the player devicefwversion 4 7 146 the version of firmware currently installed on the player deviceuptime 240 the amount of time (in seconds) since the player booted up recoverymode override the mode of the current url request \ override the initial http get request of a player with a valid autorun script \ periodic subsequent http get requests of a player with a valid autorun script \ last resort the http get request of a player without a valid autorun script crashdump yes a flag indicating that the current boot was initiated by a forced reboot due to a crash (this header is only present if true) storagestatus usb1=none;sd=autorun; sd2=storage;ssd=none; the current autorun and file system status of each storage device if the http get request is successful, the player will attempt to utilize whatever content was downloaded as an autorun script note that the player does not make any checks to determine if the content is actually a brs autorun file before attempting to run it provisioning setup overview the following infrastructure is required to provision players using dhcp option 43 dhcp server located on the local network and configured for option 43 communication provisioning script url a url that returns the brs provisioning script provisioning package url a url that returns the zip provisioning package firmware update url (optional) a url that returns a firmware update file if needed dhcp server configuration request / response string formats when a brightsign player requests information from a dhcp server, the query will include an option 60 string containing the vendor identity of the player \[bs oem id] + “ “ + \[bs oem model] (e g “brightsign xd1230”) the dhcp server can use this string to match the correct option 43 response for the vendor and model number of the device alternatively, the correct response can be determined using other information available to a dhcp server, including subscriber id where port based ip allocation is used the response should be an option 43 string consisting of tlv (type length value) encoded data, and the provisioning/recovery url should be defined using tag 85 (0x55 or ascii “u”) the tag and length are 1 byte each the length should also be encoded using hex or ascii while the formatted response value can be straightforwardly set on a linux server, configuring microsoft servers requires additional steps https //blogs technet microsoft com/troubleshooting walk through/2013/11/01/what comes with option 43 and configuring in dhcp/ player configuration when the player receives the option 43 response, it will override the default url in the registry with the value in the response string the value supplied by the dhcp server is not saved in persistent storage; the registry override remains in effect only as long as the dhcp lease remains active if necessary, the recovery/provisioning script can permanently change the registry value using brightscript functions the player can store a different url for each network interface when multiple dhcp responses are received from different network interfaces, the player will choose to recover or bootstrap using the first non empty url value in the following interface order ethernet wifi 3g verify option 43 configuration to verify that the player is responding correctly to the dhcp server, access the brightsign shell via the serial port (see the brightscript debug console docid\ ywksi6x 2hez1bwztfhmp page for more details) at the brightsign prompt, type "ifconfig" if the option 43 action has been successful, the new provisioning/recovery url will be returned; if the action was unsuccessful, the default brightsign network url will be returned to verify that the player actually sends provision/recovery requests to the url, you can look at the logs from the web server delivering the recovery script you can also use tcpdump or wireshark on the local network to view the http get request from the player encoder example the following simple webpage script can be used to convert a url into the proper hexadecimal format for use with option 43 strings brightsign option 43 recovery url encoding brightsign option 43 recovery url encoding enter the required recovery url below provisioning server configuration provisioning script once the player receives the option 43 response, it will make an http get request to the url contained in the response the provisioning server should examine the storagestatus header in the request if "autorun" is present in the string, it should return code 204; otherwise, it should return code 200 with the brs provisioning script in the response body the provisioning script should, in turn, overwrite the recovery url in the registry and download the provisioning package from a separate url by default, iis servers do not allow brs files because they are not a registered mime type if you're using an iis server to distribute the brs provisioning script, make sure to register brs as a "text/plain" mime type the brightsign provisingscript brs in github provides a template to download a presentation package and/or firmware file to use this script, you will need to replace the following values in the script with values that are specific to your application \##filename1## the name of the file after it is downloaded to local storage (e g "autorun zip") ##filetype1## the file type, which can be either "presentation" or "firmware" ##url1## the download url for the file ##addbsheaders1## a flag indicating whether to add headers to the http request, including device values such as the serial number and firmware version this value can be true or false ##optionalheaders## a set of one or more optional headers to add to the http request these headers are only added if ##addbsheaders1## is replaced with true the following example shows how to format an optional header in the script "xfer addheader(\\"authorization\\", \\"bearer " + authtoken + "\\")" there are a second set of values in the script ( ##filename2## , ##filetype2## , etc ) if you want to download both a presentation package and firmware file, replace these with appropriate values if you want the script to download a single file only, set the string values to invalid and the boolean value to false the script also contains a ##recoveryurl## field, which is the new recovery url that will be written to the player registry this value is likely the same as the url specified in the option 43 response, which will otherwise revert to default when the dhcp lease expires provisioning package the provisioning script should call additional urls to download the presentation package and/or firmware update files the presentation package should be a zip file containing necessary files if provisioning is carried out with the included provisioningscript brs script, the player will automatically unpack a downloaded zip file without requiring any additional script or naming conventions if you're using your own provisioning script (or as an extra precaution), name the presentation package autorun zip and include the autozip brs script, which is also included with this document