Configure Broadsign Control Edge Server
This page guides you through the configuration of Broadsign Control Edge Server settings:
- Step 1: Add the Edge Server Hostname
- Step 2: Assign to the Broadsign Control Player Container
- Step 3: Configure the "Edge Server Unavailable" Response
- Step 4: Adjust Configurable Parameters
For details about accessing edge server properties, see Edit Properties.
The edge server’s name should be the IP address associated to the edge server system, or a valid hostname that resolves to that IP address. This can be done by editing the edge server, and then inserting the IP in the Name field of the General tab. For details about accessing edge server properties, see Edit Properties.
Note: If the name provided during the registration process did not meet these criteria, you should modify the edge server.
To specify which players will obtain their content from the edge server instead of Broadsign Server, you must associate the edge server to a player container using Broadsign Control Administrator.
All players that should retrieve their content from the edge server should be placed within a player container in Broadsign Control Administrator. Association of the edge server to the player is done by editing the player container, navigating to the Edge Servers tab and adding the newly activated edge server. All players that are located within the selected player container will download content from the edge server.
It is possible to add more than one edge server. In that case, a player that is configured with two or more edge servers will try to download the needed content from one of the edge servers on the list at random that is up and responding to requests. If the player cannot reach the edge server or cannot download the content right now, it will try with the second edge server on the list, and so on. If the content is not available across all edge servers, the player will keep trying the edge servers on the list.
The default behavior for a player when its edge server is unavailable is to then try to download content directly from the main server cluster. If this is undesirable, you must disable the Fallback to Primary option in the player’s configuration profile.
For more details, see Edge Servers (Resource).
Broadsign Control Edge Server has a multitude of configurable settings most of which have been assigned proper defaults. In some cases it can be helpful to tweak these defaults. The following section provides a reference for all edge server configuration options:
|filename||The name of the file the log should be stored in. Ex: bses.log|
|current_log_dir||The relative or absolute path to where the log file should be stored. Ex: share/bses|
|rotation_period||The frequency (msec) with which to copy the log file to the rotation_dir and start a new log file.|
|rotation_dir||The in which to store older logs. Ex share/bses/logs.|
|scan_timeout||The frequency with which to perform the Disk Monitors operation, in msec. By default, 15sec.|
|document_roots||A semi-colon delimited list of directories to be managed by the Disk Monitor.|
|cache_sizes||A semi-colon delimited list of maximum sizes, one for each of the document roots. The size is measured in bytes.|
|auto_managed||Instruct the Disk Monitor to preserve 15% free space on the hard drives upon which the document roots are located. If this option is enabled, cache_sizes is ignored. A value of "0" disables the option, any other integer value enables it.|
|restart_on_crash||Control whether the application should be restarted when a crash is detected. A value of "0" disables the option, any other integer value enables it.|
|restart_as_service||Control whether the application should be restarted as a service when a crash is detected. This requires restart_on_crash be enabled. A value of "0" disables the option, any other integer value enables it.|
|poll_frequency||The frequency (in msec) at which the edge server requests updates from Broadsign Server. By default, 40 minutes. Minimum value, 20 minutes.|
|respect_network_controls||Controls whether the edge server should respect network controls when determining when to poll. A value of "0" disables the option, any other integer value enables it.|
|ip_mask||A netmask controlling which inbound connections will be allowed to send instructions. By default, 255.255.255.255; connections on the local network.|
|port||The port on which services listens for instructions. By default, 2322.|
|document_root||An absolute or relative path to the folder that will contain the edge server's downloaded content and upgrades. ex: "share/bsp/documents". Usually specified as a global parameter.|
|download_check_timeout||The frequency at which the edge server checks to see if new content can be downloaded, in msec. Default, 15 seconds.|
|respect_network_controls||Controls whether the edge server should respect network controls when downloading content. A value of "0" disables the option, any other integer value enables it.|
|db||An absolute or relative path to the file the edge server should use as its database. By default, "share/bsp/bsp.db". Usually specified as a global parameter.|
|host_name||A semi-colon delimited list of IP addresses or host names that the edge server can use as servers to retrieve updates from. The default is to use Broadsign Server Cluster.|
|port||The port to use for DSCP communications with Broadsign Server. By default, 10799.|
|rotation_level||Controls how many days of logs should be stored inside the edge server's database. By default, 14 days.|
|throttle||Controls whether the edge server should obey a maximum bandwidth limit on content transfers. By default, disabled. A value of "0" disables the option, any other integer value enables it.|
|throttle_rate||The maximum speed at which the edge server can download content if throttling is enabled. Measured in Kb/sec.|
|io_workers||The number of threads the edge server will use for processing network traffic. By default, 8.|
|default_initial_concurrency_strategy||The concurrency strategy used by the edge server. By default, "thread_pool". The only valid value is "thread_pool".|
|reactor_demult_strategy||The strategy the edge server uses to handle inbound network connections. There is no default value. On Windows the only valid value is "reactor_demultiplexer_select". On Linux the valid values are: "reactor_demultiplexer_select" and "reactor_demultiplexer_epoll".|
|db_pickup_upload_url||Controls the remote locate the edge server should send its database to when requested.|
|fix_clock_skew||Controls whether the edge server should use Broadsign Server to make internal corrections to its time. Default enabled. A value of "0" disables the option, any other integer value enables it.|
|document_root||An absolute or relative path to the directory the edge server should use to store its content. Usually specified as a global parameter.|
|enabled||Used to control whether or not an edge server should communicate through a proxy. A value of "0" disables the option, any other integer value enables it. Default when not specified is “0”.|
|hostname||The hostname or IP address of the proxy server.|
|username||The username to use when connecting to the proxy. Optional.|
|password||The password of the user connecting to the proxy server. Optional.|
|port||The port the proxy server is listening on.|
|type||The type of the proxy server. Must be either “http” or “socks5”.|