Provision

Owned by BrightSign TechDocs
Last updated: Jan 02, 2024
5 min read

Overview

This screen allows you to apply setups to players in your BSN.cloud network. When powering up a new or factory reset player that has previously been added to the provisioning library, the player will automatically retrieve and apply the 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 Provisioning Library prior to powering up a new or factory resetting an existing player.

If the player is not already in the 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

  1. You must be logged in to a BSN.cloud account.

  2. Note the player serial number, which can be found on the bottom of the player or on the side of the packaging box.

  3. Connect the players to an active network connection and to a display screen through HDMI®.

  4. The players must have a blank, properly formatted storage device.

  5. You must have a Setup (see this page for instructions):

    1. Note the Setup name.

    2. Make sure that the setup file is in the library (choose Add Setup File to Library).

  6. 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 is able to connect to BSN.cloud.

Provisioning Individual Players

Add Player

  1. Select Provision from the Admin tab.

  2. Select Add Player to add a player to the Player Provisioning library. You will be prompted to enter the following information:

    1. Serial Number: The serial number of the player.

    2. Player Name and Player Description: An optional name and description for the player. If these are not specified, they will default to the values in the Setup you apply to the player.

Apply Setup

From the Provision screen:

  1. Select the checkbox next to the player(s) you want to provision.

  2. Select Apply Setup:

    1. If the player(s) have not been provisioned or set up already, they will download the Setup from the BSN.cloud servers when they boot up.

    2. If the players have had a Setup previously applied, 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 App URL option lets you assign an application, accessible via a URL, to selected players in the list. At setup, the players will download the application package from the specified App URL and set up the player for that application.

You can also Delete Player(s) from the Player 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 Player 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)

  1. Select Provision from the Admin page.

  2. Select the download icon to download the Provisioning Template as a CSV file. Enter the:

    1. Serial Number (required)

    2. Player Name

    3. Setup name (required)

    4. App URL

    5. Description

  3. Save the CSV file.

  4. 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.

  5. Review the player list for bulk provisioning and select Submit. The players will automatically download and apply the new Setups from the cloud.

Note that the CSV template includes a column for Setup File as well as App URL. If a player is desired to be provisioned for App URL, it can be done with a Setup where the Setup includes the App URL information. Alternatively, the App URL can be directly entered in the CSV file, negating the need for a Setup.

If a Setup File that includes an App URL is specified and an App URL is entered in the CSV column, the App 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, go to the Network tab. Here, you should see your player listed.

Delete Provisioning Record

To delete the provisioning record for the player, click the delete icon. This will delete the provisioning record from BSN.cloud. However, for the player to reflect these changes, it must be updated as described below.

Reprovision Player

If you have applied a new Setup to the player and wish to reprovision the player with the new Setup, click the settings icon.

Update Player

From there, navigate to the Control tab and select Reprovision Player.

 

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.