Tools & Utilities

Diagnostic Web Server (DWS)

40min
the diagnostic web server (dws) allows you to view important info like player uptime, serial numbers, 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 or over a local network when the dws is accessed over the internet, it is referred to as the remote dws (rdws) when the dws is accessed over a local network or via a serial connection, it is referred to as the local dws (ldws) the rdws and ldws offer near identical functionalities, but some differences exist as highlighted below to access the rdws, see access the remote dws docid\ xue20rjxhft lq0rdmjbw to access the ldws, see access the local dws docid\ iafcherljfjdjtwttkpk5 this page describes the dws as of brightsignos 8 refer to the pdf below for documentation on the dws prior to brightsignos 8 https //archbee doc uploads s3 amazonaws com/tyaqenq txckpox4eakhe ktxdcd9jaqyznnvlybkvz 20250417 182959 pdf 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 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) 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, telnet, or ssh connection 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 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 new recovery url, which is used by the player to retrieve setup information if there is an autorun related failure dws access enable/disable dws access on the local network reprovision player a player must be explicitly reprovisioned in order for a newly applied setup to take effect (more details provision docid\ cyl9kpm02co5rgcb9wqqv ) 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 to … upload files to the player’s storage device 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 of … 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 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 presentation tab > state properties > options if you want to disable the javascript console, you can do that by unselecting the checkbox the console should only be enabled for presentations that are not in production, since it can cause memory and security issues 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 takes you to the format storage page, which allows you to format storage devices attached to the player storage select a storage device from the drop down menu ( sd , ssd , or usb ) you can only format storage devices that are currently unformatted; storage that already contains content files or autorun scripts cannot be reformatted file system select a storage devices docid\ mgdefc6yvkibeiuxh9j1o to use when formatting the storage device telnet / ssh enables telnet and ssh on the player this lets you access the brightsign application console when serial port (the default i/o for the application console) is inaccessible for security reasons, we do not recommend enabling either telnet or ssh in a production environment this is only available in brightsignos 9 0 110 or 8 5 46 and above enable telnet enter the telnet port number (23 is the default) enable ssh (optional) enter the ssh port number (22 is the default) ssh password (optional) enter the ssh password snapshots this tab allows you to view remote screenshots of the visual output of the player click the new snapshot 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 snapshot 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 the video resolution currently being output on each hdmi connection (indicated as hdmi 1, hdmi 2, etc ) if the player is set to a 4k video mode, this field will also indicate whether the10 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 latest release 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 if the bsfw version does not match your player, you will get an error 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 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 property lock allows you to decide if your presentation settings should be overwritten or not 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