Configure Broadsign Control Edge Server

This page guides you through the configuration of Broadsign Control Edge Server settings:

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:

bses.filesink

Parameter Name Description
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 directory in which to store older logs. Ex: share/bses/logs.

bsp.monitor_disk

Parameter Name Description
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.

bsp.monitor_crash_report

Parameter Name Description
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.

bsp.provide_poll

Parameter Name Description
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.

bsp.monitor_services

Parameter Name Description
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.

bsp.provider_content_info_mgr

Parameter Name Description
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.

bsp.provider_content_mgr

Parameter Name Description
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.

bsp.messenger_core

Parameter Name Description
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.

bsp.connector_adaptor_factory

Parameter Name Description
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.

bsp.db_log_sink

Parameter Name Description
rotation_level Controls how many days of logs should be stored inside the edge server's database. By default, 14 days.

bsp.ctp2_io_strategy

Parameter Name Description
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.

bss.serverd

Parameter Name Description
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".

bses.concrete_location

Parameter Name Description
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.

bses.provider_file_locator

Parameter Name Description
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.

bses.provider_proxy

Parameter Name Description
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”.