On-premise licensing


#1

You can purchase on-premise licencing from the Android Licencing page in our Customer Portal as described in this post.

You bought an on-premise(offline) license and still have trouble activating it?

Please follow the steps explained below.

First step

You need to download and install the Xibo for Android application on your devices.
And set the appropriate licence pool email address in the client settings.

Note: that if the client can connect to the Spring Signage licence servers it will do and licence directly from us, so you need to ensure your Android clients don’t have any access to the internet. but It’s important that the wifi adapter in your device is enabled.
To do this, you can simply forget any defined wireless networks in the Android wifi device manager.

Download and Install off-line licence pack on the CMS.

Navigate to My Products -> Android licencing, locate the licence pool with on-premise module enabled, which can be recognized by the following icon under number of licences in your licence pool.

Click on the card with this licence pool to reveal more options:

First step is to download the module by clicking on the ‘Download On-Premise Module’ button and install it on your server as per instructions below.

Version 1.7 and earlier CMS instances

Extract just the .htaccess, android_licence.php and android_config.php files from your downloaded module zip file in to your Xibo installation directory on the CMS (to the directory where xmds.php file is).

You need to ensure your web server can create a file called request.txt in the server installation directory. We provide a .htaccess file to prevent that file being accessed from the web server. If you aren’t using Apache then you may need to make alternative provision for that.

Once the offline licence files are in place, you need to edit the android_config.php file and set the correct licence pool address for your server. Again that would be the email address you nominated earlier. The other options should all be correct already for you.

Finally run a manual licence check from the client. It won’t licence the client initially but a file - request.txt should be created on the CMS.

In summary:

  • extract the files from the archive and put them in your CMS installation folder
  • ensure that the web server can write into that folder
  • edit android_config.php and set your licence pool email address
  • run a licence check and see the request.txt file generated in the CMS installation folder

1.8 series CMS and later with Docker

Extract just the XiboForAndroidOnPremise.php file from your downloaded module zip file in to your shared/cms/custom folder.

Edit shared/cms/custom/settings-custom.php file, and add the following lines to the end of the file, before the closing ?> tag, so that it looks like this:

$androidOnPremise = new \Xibo\Custom\XiboForAndroidOnPremise();
$androidOnPremise->setConfig('licences@example.org');
$middleware = [$androidOnPremise];
?>

Be sure to replace licences@example.org with your correct licence pool email address.

If you already have other middleware enabled, please see the comments at the top of the XiboForAndroidOnPremise.php file which explains how to handle that.

Finally run a manual licence check from the client. It won’t licence the client initially but a file - request.txt should be created on in the shared/cms/library/android folder.

1.8 series CMS and later, custom install

Extract just the XiboForAndroidOnPremise.php file from your downloaded module zip file in to your /custom folder.

Edit /web/settings.php file, and add the following lines to the end of the file, before the closing ?> tag, so that it looks like this:

$androidOnPremise = new \Xibo\Custom\XiboForAndroidOnPremise();
$androidOnPremise->setConfig('licences@example.org');
$middleware = [$androidOnPremise];
?>

Be sure to replace licences@example.org with your correct licence pool email address.

If you already have other middleware enabled, please see the comments at the top of the XiboForAndroidOnPremise.php file which explains how to handle that.

Finally run a manual licence check from the client. It won’t licence the client initially but a file - request.txt should be created on in the /library/android folder.

Upload and Download licence files

Once you have all the clients you want to licence in the request.txt file, you upload that file into the customer portal on your android licence pool page.

After that’s done you will need to download android.txt file, by clicking the ‘Download On-Premise Licence’ button

Last step

When you have your android.txt file you’ll need to copy it to your CMS.

For 1.7 and earlier CMS versions, please place the android.txt file in the Xibo installation directory on the CMS (to the directory where xmds.php file is).

For 1.8 and later CMS versions, please place the android.txt file in the CMS library directory, in the android folder. By default on a Docker install, that would be shared/cms/library/android, and for a custom install, /library/android.

Shortcut method

If you’re setting up a number of Xibo for Android Players somewhere where online licencing is possible, then you can use the following short cut to speed up the process.

Licence your device online as normal to get it registered with Customer Portal, then
Click on your licence pool with on premise enabled -> click ‘View’ button -> click ‘On-premise licensing’ button -> select ‘Licence Download’ this will download android.txt file for you.

Then at your destination site (where there’s no internet access), copy your downloaded android.txt file.

When you have your android.txt file you’ll need to copy it to your CMS.

For 1.7 and earlier CMS versions, please place the android.txt file in the Xibo installation directory on the CMS (to the directory where xmds.php file is).

For 1.8 and later CMS versions, please place the android.txt file in the CMS library directory, in the android folder. By default on a Docker install, that would be shared/cms/library/android, and for a custom install, /library/android.


Activate License on Secure Lan
On-Premise licensing in Docker
Local Network ve Xibo
Introduction / Table of Contents
Disappearing Elements Every Rotation