Installation on BrightSign using BSN Cloud

This article shows you how to install the Wallboard application on your BrightSign device using BSN cloud.

Table of Contents

• Introduction
• Creating a BSN.cloud Account & Network
• Create a Setup file
• Add Device to Provisioning List & Apply Setup File
• Initiating the Provisioning Process
• Pre-Registering Your BrightSign in Wallboard
• Other scenarios
  • 1. Device is already connected to BSN.cloud and needs to be reprovisioned
  • 2. Reprovisioning doesn't begin automatically
  • 3. Application is pointing to the wrong URL
• Watch YouTube tutorial video

Introduction

BSN.cloud is a cloud-based device management interface by BrightSign. It enables users to remotely manage and troubleshoot their BrightSign devices without the need of an on-site technician. If you need to install applications at scale on hundreds of devices at once, there is no quicker alternative than BSN.cloud.

Creating a BSN.cloud Account & Network

1. Navigate to BSN.cloud and click register at the bottom, then fill out your details.
2. Confirm your registration in the email you receive.
3. After logging in to BSN.cloud it will ask you to create your first network.

Create a Setup file

Setup files are configuration templates that you can apply on the listed devices in your provisioning list.

4. Go to Admin > Setup to create a Setup file where you can pre-define all the settings that will be applied to your devices.

5. Fill out your Setup Name.
6. Select Wallboard as Partner App (You have to click View All to find it).
   If you use a partner server(not _editor.wallboard.us), choose App URL instead and paste in the https://YOURSERVERURL/api/storage/update/jscore/brightsign/autorun.zip url where you have to replace the YOURSERVERURL part with the server URL you want to register the device on.
7. Set up network configuration. (If you want to use wifi, select Include network configuration then click Network Options and go to the Wireless tab where you can provide your network SSID and password. Optionally you can give your device a Static IP Address by disabling DHCP and filling out the details.)
8. Enable Local Diagnostic Web Server and Local Web Server.
9. Enable bsn.Control or bsn.Content.
10. Click Add Setup to Library

Add Device to Provisioning List & Apply Setup File

A Provisioning List is a list of devices that you would like to add to your network and assign setup files to.

11. Go to Admin > Provision to add your devices to the Provisioning List.

12. Click Add Player.
13. Enter the Serial Number and Name of your device. You can find the serial number on the back of the device written on a label.
14. Click Add Player.

Initiating the Provisioning Process

Once you have listed all the devices in the Provisioning List it's time to assign the setup we previously created to these devices.
Assigning a Setup to a Provisioned device makes the device use the settings defined in your Setup File when it enters a Provisioning Cycle.

BrightSign players trigger a Provisioning Cycle after booting up the device ONLY if the SD card in the device is fully wiped with no data on it.

15. Select all the devices you want to assign the setup to using the checkboxes.
16. Click Apply Setup.
17. In the popup select the Setup File you created.
18. Click Apply Setup.

Pre-Registering Your BrightSign in Wallboard

Now with everything set up you can pre-register your devices in the editor so you don't have to wait for each device to generate an activation code. This is useful because you can prepare everything in advance before the device even comes online like the assigned content, rotation, working hours etc.. Easiest method is to create a Device Profile in the editor and during pre-registering select this device profile.

19. Click Add device.
20. (Optional) Select Device Profile.
21. Enter the device's Serial Number.
22. Enter the device's Name.
23. Choose license.
24. Enable Pre-register toggle.
25. Click Save.

All that's left to do is to boot up your BrightSign device with a blank SD card and wait for it to provision. After provisioning your device will automatically appear in the editor where you pre-registered it!

Other scenarios

1. Device is already connected to BSN.cloud and needs to be reprovisioned

If your device is already connected to BSN.cloud and you've applied a new setup to it, you need to reprovision it in order for changes to take place.
To do that follow these steps:

1. Log in to BSN.cloud and find your device under the Network tab.
2. Click the gear icon that can be found on the left side of the Player ID column for each device. This will take you to the Embedded Web Server of that specific device.
3. Go to the Control tab and click Reprovision at the bottom.
4. The device will reboot with the setup you've newly applied in BSN.cloud.

2. Reprovisioning doesn't begin automatically

If you're having trouble connecting your device to BSN.cloud, you can connect to it via IP address from the same local network and format your SD card to ensure the provisioning cycle begins when you boot up your device the next time.
To connect to your BrightSign device do the following:

1. Find the IP address of your device. You can do this by using a network scanner tool.
2. Enter the IP address into your browser's address bar.
3. You will be asked to provide a username and password. The username will be admin and the password is the serial number of your device.
4. Once you've logged in, go to the Diagnostics tab and click Disable Autorun. This will ensure the currently running application is stopped (The device will reboot).
5. Next, click Format Storage to clear the contents of the SD card.
6. Give your device another reboot (Control tab > Reboot). The provisioning should begin if you've configured it correctly through BSN.cloud.

3. Application is pointing to the wrong URL

If the Wallboard application on your BrightSign device points to the wrong server URL, you have to run a script that will clear the registry file from your device that tells it which server the application should connect to.

1. Download the autorun script by clicking here.
2. Find you device's IP address by using a network scanner tool.
3. Enter the IP address into your browser's address bar.
4. You will be asked to provide a username and password. The username will be admin and the password is the serial number of your device.
5. Go to the Diagnostics tab and click Format Storage.
6. Go to the SD tab, click Browse and upload the file you downloaded in step 1.
7. Go to the Control tab and click Reboot.
8. Your device will now reboot and provision again. At the end of the process your device should point to the right URL.

Alternatively you can do it manually with an SD card reader connected to your PC:

1. Pull the SD card from the BrightSign device and insert it into your SD card reader.
2. Delete everything from the SD card then copy the autorun.brs file onto it. You can download it by clicking here.
3. Insert the SD card back into the player while it's powered off.
4. Power on the device.
5. The device will do a reboot and provisioning cycle. At the end of the process your device should point to the right URL.

Watch YouTube tutorial video

Tip!

If you have further questions please do not hesitate to contact us at support@wallboard.info.