Tools & Utilities
Diagnostic Web Server (DWS)
40 min
the diagnostic web server (dws) allows you to view important info like player uptime, serial number, logs, and screenshots of what the player is displaying view and modify various player settings use diagnostic tools to troubleshoot players the dws can be accessed either over the internet (via either the free bsn control docid 6fdtqjwewi 2rn4hpudwa service or the paid bsn content docid 7sqjdlzkp5fqzdp4hnsxv service) or over the local network when the dws is accessed over the internet, it is referred to as the remote dws or rdws when the dws is accessed over a local network or via a serial connection, it is referred to as the local dws or ldws the remote dws and local dws offer near identical functionalities, but some differences exist as described below the local diagnostic web server (local dws or ldws) is disabled by default as of brightsignos 9 0 218 (on the 9 0 branch) and brightsignos 9 1 75 (on the 9 1 branch) in brightsignos versions prior to these, the local dws was enabled by default to enable the local dws, see access the local dws docid\ iafcherljfjdjtwttkpk5 to access the remote dws, see access the remote dws docid\ xue20rjxhft lq0rdmjbw this page describes the dws as of brightsignos 8 refer to the pdf below for documentation on the dws prior to brightsignos 8 dws tabs the dws is organized by a horizontal row of tabs, each one with a different set of functions info this tab provides general information about the player and its current status time (local dws only) the current time as it is configured on the player on the local dws, you can select the time icon (clock icon) to configure the time on the player automatically click use client to set the time of the player using the current time of the browser/application manually enter a time and date to set on the player these values will go into effect the moment you click the set time button if you would like to interpret the date/time using the time zone of the player, check the apply timezone box otherwise, the date/time will be applied as a utc value the player's time zone cannot be edited from the dws to change the time zone, you will need to apply a new setup docid\ xnnxywmv09iegziit7rwa to the player name the user supplied name of the player description an optional user supplied description for the player model the model number of the player unique id the serial number of the player \<ethernet/wifi> ip the ip address of the player \<ethernet/wifi> mac the media access control (mac) address of the player \<ethernet/wifi> ipv6 the ipv6 address of the player boot version the current version of the primary boot loader brightsignos version the current os version installed on the player video mode the current video output resolution you can change the video resolution in the video tab uptime the amount of time the player has been powered on and working correctly power source displays the power source (e g , ac or poe) poe the status of the poe interface (applicable to poe capable models only) extensions the info tab will include this field if the player has one or more extensions installed log this tab provides a log of system processes and events on the player the output is similar to the information generated through a serial connection note, however, that if an ssh connection is used, this tab will only show application level logs and not the logs from the entire os boot cycle refresh retrieve new log information from the player download log download the current log download crash dump retrieve information about the most recent crash on the player (if one has occurred); this is useful data for brightsign support when troubleshooting control this tab allows general control of the system processes of the player set password (local dws only) set a new password for dws authentication on the local network the password must be at least 8 characters long and include at least one uppercase letter, one lowercase letter, one number, and one special character reboot player reboot the player over the network (the local network in the case of the ldws and the internet in the case of the rdws) reboot with crash report reboot the player and save a crash report file to the "brightsign dumps" folder brightsign support may request the crash report when helping you troubleshoot the player factory reset perform a factory reset a player docid\ yncf7p2pyzo2qedf1jyim of the player this resets the player to its factory defaults, erasing all persistent registry settings for networking, security, and other applications in some cases, a player should be reprovisioned instead of a factory reset see provision docid\ cyl9kpm02co5rgcb9wqqv recovery url set a recovery url which is used by the player to perform content recovery in the event of an autorun related failure reset ssh host keys reset the ssh host key and reboot the player reset default dws certificates (remote dws only) reset the default dws certificates and reboot the player reprovision player (remote dws only) as covered in the start here docid\ d1tz0hy4bh9ngcvuoe3of section, setting up a player for use involves applying a setup docid\ xnnxywmv09iegziit7rwa to the player, and applying a setup to a player using bsn cloud is known as provisioning applying a new setup to a player which already has a setup requires a process known as reprovisioning it is important to understand that from brightauthor\ connected's provision docid\ cyl9kpm02co5rgcb9wqqv screen, a new setup can be applied to a player this process associates the player with the new setup importantly, however, the new setup will not actually take effect on the player until the player is explicitly reprovisioned (more details provision docid\ cyl9kpm02co5rgcb9wqqv ) which is the function of this section of the dws the reprovision player function performs the following clears the player's storage device (e g , microsd card) deletes the player's registry settings note that the player's network settings are unaffected updates the player's setup if the setup includes new network settings, then those network settings will be incorporated reboots the player in addition to brightauthor\ connected, a new setup can also be applied using the post and put api operations as with applying a setup to a player using brightauthor\ connected, the player must be reprovisioned for the setup to actually take effect sd / msata / usb this page provides information related to the storage device attached to the player the title of the tab will reflect the interface that the storage device is using to connect to the player for example, the sd tab will be displayed if a microsd card is attached to the player storage information select view to get more information about player storage upload files upload files to the player’s storage device (e g , microsd card) files are uploaded to the currently selected directory to upload files, click the browse button to select one or more files, then click upload files file uploads are limited to 10mb on the remote dws listing provides a listing of all files on the storage device depending on the type of file, there will be several options open folder click a folder (indicated by the folder icon) to view its contents download click the download icon to download a file to your computer file downloads are limited to 10mb on the remote dws file options click the gears icon to view more options associated with the file about \<filename> provides the file size and last modified date rename provides various options for renaming the file you can specify a custom name or choose from among a list of common filenames use caution if renaming a file to "autorun brs" the system does not check the integrity of the new autorun file analyze media file performs media analysis of a video or audio file delete click the trashcan icon to delete the file from the storage device diagnostics this tab provides various network and system tools that are helpful for diagnosing problems and getting information about a player network configuration view extensive info about network interface settings network diagnostics run network diagnostics to check all ethernet, wifi, modem, and internet connections this process may take some time to complete, especially when certain tests fail dns lookup test the specified dns address to check whether name resolution is working ping ping a device with the specified ip address or dns name trace route perform a standard traceroute diagnostic on the specified ip/dns address check the resolve ip addresses box to resolve the specified dns name chromium debugging this feature lets you enable the javascript console if you have also selected enable javascript console in brightauthor\ connected ( presentation tab > state properties > options ) to disable the javascript console, uncheck the checkbox the console should only be enabled for presentations that are not in production, since it can cause memory and security issues note that the javascript console is available for all applications running on the player and not just brightauthor\ connected presentations it can be enabled through apis via rohtmlwidget docid\ xljq5 yhdma2ssmpzimtk or htmlwidget docid\ pmpuh3a0vr8ohjopsjwo7 network neighborhood display information on the current network neighborhood network packet capture allows the capture and collection of live network packet data from the network interfaces connected to the player disable autorun force the player to reboot and disable the autorun script when the player restarts this allows the player to display the os version and ip address on screen (if the player is connected to a local network) if the player has a serial port, you will be able to access the brightsign shell over a null modem serial cable storage formatting this t akes you to the format storage page, which allows you to format storage devices attached to the player storage devices that are currently unformatted can be directly formatted from here if the storage device contains an autorun file, however, the autorun must first be disabled using the disable autorun function described above storage select a storage device from the drop down menu ( sd , ssd , or usb ) file system select a storage devices docid\ mgdefc6yvkibeiuxh9j1o to use when formatting the storage device ssh telnet access to players is no longer available in the local dws or remote dws as of brightauthor\ connected 1 67 0, brightsignos 9 0 218 (on the 9 0 branch), and brightsignos 9 1 70 (on the 9 1 branch) telnet can still be enabled via brightscript or javascript for more details on telnet, see telnet & ssh docid\ l0l gyihavtdbci9ffcqh enables ssh on the player which lets you access the brightsign application console when the serial port (the default i/o for the application console) is inaccessible for security reasons, enabling ssh in a production environment is not recommended ssh access is available in most os versions and can be enabled by using a custom script or by writing the registry key registry write networking ssh 22 enabling ssh via the dws, however, is only available in brightsignos 9 0 110 or 8 5 46 and above enable ssh enter the ssh port number (22 is the default) ssh password enter the ssh password the password must be at least 8 characters long and include at least one uppercase letter, one lowercase letter, one number, and one special character screenshots (snapshots) this tab allows you to view screenshots of what the player is displaying click the new screenshot button to take a screenshot once the screenshot has been taken, you can click the thumbnail to view a full size image of the screenshot as of brightsignos 8 5 31, screenshots are captured at resolution with a maximum size of hd select return the screenshot at its original resolution (do not downscale to hd) to get the screenshot at a higher resolution video this tab provides several diagnostic tools related to the player's video settings hdmi status whether each player hdmi® connection (indicated as hdmi 1, hdmi 2, etc ) is “active” or “inactive” current video mode this is the video resolution currently being output on the hdmi connection if the player has multiple hdmi connection, each hdmi connection will be numbered ( e g , hdmi 1, hdmi 2, etc ) if the player is set to a 4k video mode, this field will also indicate whether the 10 bit colorspace and/or hdr (high dynamic range) is currently being output power save disables hdmi output, the syncs for vga output, and/or the dac output for component video for each hdmi connection (indicated as hdmi 1, hdmi 2, etc ) the absence of a signal will cause some monitors to go into standby mode edid information displays the edid data returned from one or more monitors attached to the player’s hdmi ports (indicated as hdmi 1, hdmi 2, etc ) this info can be copied and pasted into a text editor change video mode changes the display mode / resolution of the player on all video outputs (hdmi®, vga, and component) the device will reboot and disable the current autorun script (similar to the disable autorun button in the diagnostics tab) otherwise, the autorun script will reset the video mode of the player by default advanced this tab includes the options below brightsignos update select one of the update options (described below), and then select update to download that version to your player, which will then reboot production os is the latest public brightsignos release for your player beta os is the latest brightsignos beta version for your player minimum os is the lowest brightsignos version that can run on your player custom url allows you to provide a url to a specific os version that you wish to load this can be hosted by you or brightsign, depending on circumstances for example https //brightsignnetwork com/download/anon/firmware/cobra 9 0 110 update bsfw https //brightsignnetwork com/download/fturhan/firmware/cobra 9 0 110 update bsfw if the player family of the os does not match the player family of your player, you will get an error storage location enter the storage location and select view to temporarily access the player storage location note that you will get an error if you enter a device that is already listed brightsignos logs select the level of detail you prefer in the brightsignos logs and then select set to apply that setting the highest logging level will be included when lower logging levels are selected (for example, if you select info , error and warn loggings will be included as well) these are the logging levels error critical errors or failures in the application warn warnings about potential issues that are not critical but may require attention info informational messages about the application's normal operations this is the default logging level trace detailed tracing information, typically used for debugging property lock allows you to decide if your presentation settings should be overwritten or not for more info on property lock, see presentation settings registry this tab allows you to view and edit the registry select view registry dump to view the player registry you can copy the output to the clipboard or download it to a text file to submit registry commands, add registry entries, or delete registry entries, enter that information in the empty field under command and then select submit you must reboot the player to see changes to the registry