1 Confidentiality notice

This document is confidential and may not be reproduced, distributed or used for any purpose other than by the recipient for the assessment, evaluation and use of Edgeware products, unless written permission is given in advance by Edgeware AB.

2 About this document

This document covers an overview of the SW Repackager license model support. No prior knowledge about the system is assumed. Intended audiences include system administrators who install the system, operators who use it, and anyone who is interested in learning more about the product.

3 How to use this document

This document aims to be used as a foundation to build an understanding around the product. The document is to be used a guideline when working with the product. This document does not define any specific information on feature development in specific releases, please refer to “Release Notes”. Neither does this document define any applications relying on the specific product, please refer to “Application Notes”.

4 References

[1] License generation in Xops and ScientaMedia for SW Licenses

5 Basic license support

5.1 General information

The SW Repackager supports a basic form of license validation. It communicates with an external 3rd party service which keeps track of the number of concurrent active instances of a SW Repackager service and the assigned license validity.

First the license must be registered by Edgeware TV and published. It is accessible via License & SW portal. The SW Repackager only uses obtained license reference and has no knowledge of the license details. For more information about license generation please refer to [1].

5.2 Customizations

The SW Repackager is shipped with one license support variant, which sends requests to backend for verifying the license. To switch between Convoy CMS and Scienta Media backend, please refer to the parameter validation_type in Service configuration.

5.3 Service configuration

To properly configure the SW Repackager service the following configuration must be placed in the /etc/ew-repackager/license.json

{
    "license_ref": "1209-company_name-esb3002-repackager_vod-fhrODMD671HDWWd",
    "service_name": "the_name",
    "status_query_interval" : "2m",
    "loglevel": "DEBUG",
    "validation_type": "offline"
}

where:

• license_ref is the license reference obtained from the license portal
• service_name is the service name which identifies service instance, it's just an informative value
• status_query_interval the is interval to query license server
• loglevel is the logging level (any of DEBUG, TRACE, INFO, WARN, ERROR) used to filter the license specific logs
• validation_type is the optional field containing validation method. There are two possible values for this parameter: online is for sending license validation requests to Scienta Media server and offline is for sending validation requests to Convoy CMS. This parameter only works with locked version, otherwise, it is ignored. When it is not defined, the offline is used.

After applying the new configuration, ew-repackager-license and services must be restarted

[root@esb3002 ~]#  systemctl restart ew-repackager-license

5.3.1 Variant specific configuration

For the validation method offline, the convoy-1 name to IP mapping must be added to /etc/hosts, manually.

5.4 License statuses

The table below briefly sums up the possible license statuses returned by the license server. Currently only an expired license will cause the SW Repackager to stop processing requests.

5.5 Troubleshooting

For more information please try the following:

• The ew-repackager-license service log which can be viewed with journalctl.

[root@esb3002 ~]#  journalctl -fu ew-repackager-license

• Additional details can be found in the repackaging.log.

[root@esb3002 ~]#  tail -f /var/log/edgeware/ew-repackager/repackaging.log