webOS Installation Guide

Prerequisites.

Xibo for webOS is easy to install and configure and can be up and running in just a few minutes.

Before you begin the installation process, you should first make sure you have fulfilled the minimum requirements below:

Requirements:

• Xibo CMS version 1.8.3 or later.
• Your monitor must be listed as a supported model. Please check compatibility here.
• Xibo for webOS requires a software licence for each webOS Display you intend to run which is linked to a “Licence Pool email address."

You should also check that you are using the recommended Firmware Version for your Series and Model, please refer to our webOS Firmware Matrix and Firmware Guide.

Since version R205, you can pre-prepare the credentials for your CMS using a USB stick. If you would like to set this up, please see the Automating CMS credentials guide before proceeding with the following steps. This will ensure that once you have completed the installation and restarted your monitor, the CMS URL, Key and License Pool address will be automatically entered for you.

Prepare your monitor.

Now that the prerequisites are taken care of, you can proceed with the monitor setup.

Time and Date Settings.

It is essential that the correct date, time and time zone are set on your monitor prior to player installation.

Use the Settings button (cogwheel icon) on the remote control to access the General Menu:

Now click on Time & Date:

Use the drop down to select the correct Time and Date or alternatively ‘Set Automatically’

Next, click on Time Zone:

Use the drop down to select the Continent, Country/Territory and City.

Install the Xibo for webOS IPK.

Now we are ready to proceed with the player installation!

Locate the Server/SI Server settings page on your monitor.

To install Xibo for webOS, you will need to access the Server or SI Server Settings, depending on the webOS version running on your monitor.

Please follow the relevant instructions for the webOS version you are using.

Example screenshots have been provided so you can confirm when you have found the correct page.

Access Server Settings on webOS 3.0:

• On your remote control, press and hold the Settings button until a toast message appears in the upper right corner to notify that your input has been received.
• Enter 8080, and press the OK button to open the Settings Menu.

Access SI Server Settings on webOS 3.2 and later:

• On your remote control, press the Settings button.
• Choose the EZ Setting option.
• Select the SI Server Setting option, then choose SI Server Setting again on the next page.

From here, there are two methods for installing the player:

1. Using Remote URL

2. Using a USB flash drive

1. Remote URL installation.

To remotely install the latest version of Xibo for webOS, set the fields on the Settings menu to the values provided below.

If you would prefer to auto-fill the settings, please follow the **Option 2: Auto-fill the Settings with USB-flash drive instructions.

Option 1: Manually enter the settings:

• Application Launch Mode - Local
• Fully Qualified Domain Name - On
  Enter the URL to your app package - https://xibo.org.uk/api/downloads/4/latest
• Application Type - IPK
• Local Application Upgrade - REMOTE
  Selecting this option will initiate the download of Xibo for webOS Player to your monitor. This should be the last field you complete.

Option 2: Auto-fill the Settings with USB-flash drive:

If you would rather configure these settings in a text file instead, then you can do so and install those on the monitor via USB flash drive with the following JSON file content:

{ 
   "serverIp":"0.0.0.0",  
   "serverPort":80,  
   "secureConnection":false,  
   "appLaunchMode":"local", 
   "fqdnMode":true, 
   "fqdnAddr":"https://xibo.org.uk/api/downloads/4/latest", 
   "appType":"ipk" 
} 

• Save the file as scap_installation.json.
• Copy the JSON file into the root directory of a USB flash drive.
• Insert the USB flash drive into the USB port of your monitor.
• Turn on your monitor. The Server Settings defined in the scap_installation.json file will have been loaded onto the monitor automatically.

When the installation is complete, please restart your monitor.

2. USB Installation.

If you have a specific version of Xibo for webOS that you wish to install, or you do not have access to the internet to use the remote URL installation method, you can install the player locally via USB.

• Download the ipk file for the player version you want to use. You can find the latest version of the player here or you can go to the Download Centre, set the player version menu to Xibo for webOS and choose the version you want.
• Rename the downloaded ipk, for example, Xibo_for_webOS_v2_R204.ipk to com.lg.app.signage.ipk and save it in the path specified below on your USB flash drive. If this path does not exist on your USB flash drive, please create it:

[USB_root]/application/com.lg.app.signage.ipk

• Insert the USB flash drive into the USB port on your monitor.

• Now access the Server Settings menu, as described earlier in this guide.

• On the Settings menu, set the fields with the values provided below.

  Application Launch Mode - Local
  Application Type - IPK
  Local Application Upgrade - USB

Setting Local Application Upgrade to USB will start the copying of the Xibo for webOS Player to your monitor. This should be the last field you complete.

When the installation is complete, please restart your monitor to complete the installation.

Connect to your CMS.

After installing the player and restarting your monitor, the Connect to CMS screen will appear. This is where you need to enter:

CMS URL: This is the fully qualified address of your CMS installation. For example https://cms.example.org or http://example.org/cms

CMS Key: The secret CMS Key that will authenticate this Display with the CMS.

This key can be viewed from the CMS under the Administration menu by clicking on Settings and the Configuration tab.

This information can be entered manually, or by using one of our alternative methods, which are listed below:

Automating CMS credentials entry using a USB stick.

If you are using R205 or newer, you can auto populate those credentials by preparing a JSON file.

If you have followed the steps in this guide, you should find that these fields are already filled in.

Use Authentication code to connect to your CMS.

If you are using a version 2 player which is R205 or later, another option will be available on the Connect to CMS page, named Use Code.This option is compatible with all CMS instances running version 2.0 or later:

• Press the Use Code button to reveal a 6 digit key.
• Make a note of this code and log into your CMS.
• Go to the Displays menu in your CMS and click the Add Display (Code) button.
• Enter the code you received from your player and click save.
• After a short wait, you should find that an entry for your player will be created in your CMS.

Once you have successfully entered the credentials for your CMS using one of the above methods, you should see the message: Display is registered and awaiting authorisation from an administrator in the CMS.

Activate your Licence.

If you have provided a Licence Pool email address as a Display Setting Profile, or as an entry on the Connect to CMS page, your player will attempt to contact your license pool and acquire a license.

If you have not provided a Licence Pool, a trial period will begin.

Your player will require a license before the end of its trial period, or it will no longer receive scheduled events and media.

Display Setting Profiles.

Default Profiles have been provided for you. You only need to create a Display Setting Profile if you want to override these defaults, or if you want to provide your Licence Pool email address to all of your devices centrally.

For more information on available settings, please see webOS Display Profile Settings and the Display Settings sections of the Manual.

Display Authorisation.

Before the Player can receive Scheduled Events and display your Layouts you will need to Authorise the Display to connect to the CMS.

Log into your CMS and click on Displays from the main menu to see your newly registered Player in the list.

Click the row-menu for this Player and select Authorise from the list.

Click Yes to confirm the authorisation of the Display.

CMS version 1.8.7 and earlier, click Edit and select Authorise from the form on the first tab, Save.