Overview
Device Provisioning allows you to provision players in your BSN.cloud network. When powering up a new or factory reset player that has previously been added to the Device Provisioning library, the player will automatically retrieve and apply the Device Setup associated with it.
If you intend to apply a custom Setup to a player (instead of the BrightSign Default Setup), it is generally recommended to add the player to the Device Provisioning Library prior to powering up a new or factory resetting an existing player.
If the player is not already in the Device Provisioning Library, the BrightSign Default Setup will automatically be applied to the player upon its bootup. Reprovisioning the player would then be required to apply a different Setup.
Prerequisites
You must be logged in to a BSN.cloud account.
Note the player serial number, which can be found on the bottom of the player or on the side of the packaging box.
Connect the players to an active network connection and to a display screen through HDMI.
The players must have a blank, properly formatted storage device.
You must have a Device Setup (see this page for instructions):
Note the Package Name.
Make sure that the setup file is in the library (choose Add Setup File to Library).
Do not power up the players yet. If the player is powered up prior to assigning it a Setup, it will configure itself using the BrightSign “Default Setup” if it can connect to BSN.cloud.
Provisioning Individual Players
Add Device
Select Device Provisioning from the Admin tab.
Select Add Device to add a player to the Device Provisioning library. You will be prompted to enter the following information:
Serial Number: The serial number of the player.
Device Name and Device Description: An optional name and description for the player. If these are not specified, they will default to the values in the Device Setup you apply to the player.
Apply Setup
From the Device Provisioning screen:
Select the checkbox next to the player(s) you want to provision.
Select Apply Setup:
If the player(s) have not been provisioned or set up already, they will download the Device Setup from the BSN.cloud servers when they boot up.
If the players have been setup previously, the new setup will be applied to the player only when it is explicitly reprovisioned.
It is important to note that Apply Setup strictly establishes what should be applied to the player when the player needs to be reprovisioned. If a previously provisioned player reboots or even if it is factory reset, it will not adopt the new Setup until the player has been explicitly reprovisioned. Reprovisioning is covered below.
The Apply Application option lets you assign a BrightSign partner application to selected players in the list. At setup, the players will download the application package from the specified Application URL and set up the player for the partner application.
You can also Delete Device(s) from the Provisioning library. Deleted players will automatically apply the BrightSign “Default Setup” when they first boot up.
Players that have already been provisioned but are then subsequently deleted from the Provisioning library will continue to run the Setup that had previously been applied. If that player is then factory reset, it will search for a provisioning record upon bootup and if it doesn’t find one, the current Default Setup will be applied to it.
Provisioning Multiple Players (Bulk Provisioning)
Select Device Provisioning from the Admin page.
Select Download Template to download the CSV template file. Enter the:
Serial Number (required)
Device Name
Setup File or Setup Package name (required)
Application URL
Description
Save the CSV file.
Select Upload Provisioning File to upload the saved CSV file. Once the file has been uploaded, players listed in the file will be automatically provisioned per the file.
Review the device list for bulk provisioning and select Submit (see Image 3). The players will automatically download and apply the new setup files from the cloud.
Note that the CSV template includes a column for Setup File as well as Application URL. If a player is desired to be provisioned for Application URL, it can be done with a Setup File where the Setup includes the Application URL information. Alternatively, the Application URL can be directly entered in the CSV file, negating the need for a Setup File.
If a Setup File that includes an Application URL is specified and an Application URL is entered in the CSV column, the Application URL in the Setup File will take precedence.
Default Provisioning
If a setup file is not explicitly applied to a player, the player will be provisioned with the “Default Setup” upon bootup. As mentioned, the “Default Setup” can be the BrightSign “Default Setup” or a custom defined setup which has been named “Default Setup” (case and spelling must match exactly).
Reprovisioning
To reprovision the player with a new Setup, go to the Network tab and click the settings icon.
From there, navigate to the Control tab and select Reprovision Device.
There may be a message asking to confirm that there is indeed a Setup that has been applied to the player. If a Setup has not been first applied to the player, the player will connect to BSN.cloud and download the default Setup.
Additional Info
See this video for more information about provisioning players and creating player groups to display different setups in different groups.