viju

Installing the Viju VoD Service Integration Package

Warning

Upgrade the TVIP TMS platform to the latest available version before installing the integration package

Run the following commands to install the package:

sudo apt update
sudo apt install manager-tvip-tms-vod-viju
ACCESS_TOKEN_SECRET=$(cat /opt/tvip-tms/manager/manager-tvip-auth/application-prod.yml | grep -oP 'access-token-secret:\s*(.*)' | sed "s/'//g" |awk '{print$2}')
REFRESH_TOKEN_SECRET=$(cat /opt/tvip-tms/manager/manager-tvip-auth/application-prod.yml | grep -oP 'refresh-token-secret:\s*(.*)' | sed "s/'//g" |awk '{print$2}')
sed -i "s/accessTokenSecret/$ACCESS_TOKEN_SECRET/g" /opt/tvip-tms/manager/manager-tvip-tms-vod-viju/application-prod.yml
sed -i "s/refreshTokenSecret/$REFRESH_TOKEN_SECRET/g" /opt/tvip-tms/manager/manager-tvip-tms-vod-viju/application-prod.yml
sudo systemctl enable manager-tvip-tms-vod-viju
sudo systemctl start manager-tvip-tms-vod-viju

Setup the integration package

Specify the access-key and password parameters received from viju in the /opt/tvip-tms/manager/manager-tvip-tms/manager-tvip-tms-vod-viju/application-prod.yml configuration file under viju:

application:
    jwt:
        access-token-secret: <access_token>
        refresh-token-secret: <refresh_token>

viju:
    partner:
        access-key: <access_key>
        password: <password>

The application/jwt settings should be identical to those configured in other services.

Apply the settings by restarting the service:

systemctl restart manager-tvip-tms-vod-viju

Setup tariff plans

Access to the VOD library is controlled by VOD tags. To create a tag associated with a viju service, follow the steps below:

  • In the VOD / VOD Tariff Tags section, create a new tag with an arbitrary name, such as VIJU.

  • In the tag settings, under VOD Sources, create a source with the code VIJU and specify the type VIJU.

Now this tag can be added to any tariff. If it is present in the tariff, users subscribed to this tariff will get access to the viju library.

Tariff settings

Go to an existing or create a new tariff and configure it to work with the viju service:

  • Assign the VOD tag associated with the VIJU service.

  • Be sure to specify the billing conditions, as they are important when working with the viju API. If necessary, create a currency in the Management / Currencies section. Separate field “Price” in case of tariffs using viju library is prohibited.

  • Be sure to activate the tariff protection option. It ensures that the created subscriptions remain unchanged: the start date will remain fixed, deleting the subscription will be prohibited, and the only available action is to set the end date if it has not been set before.

Warning

The Viju service will be passed the full cost of the tariff even if it includes other resources such as TV. The tariffication settings are also used to display the cost in promotional channels.

Import setup

For the correct operation of the service, it is necessary to set up the categories into which the content will be imported. In the VOD / Category Management section, match which category the content from the viju theater should go into, if necessary, create a new category

Features of realization

  • The viju service does not support open-date subscriptions and requires you to specify the end date of the subscription in the API.

  • TVIP TMS supports open dates for subscriptions and automatically renews them for the period specified in the tarriffication. Subscriptions are checked 4 times a day.

  • For correct synchronization of subscriptions between TMS and viju, synchronization logs of current and archived subscriptions are kept in PostgreSQL table format. Access via API will be implemented in the future.

  • The viju API is limited to 10 requests per second, which can slow down the application of rate settings.

  • The tariff cost will be transferred in API currency to the viju API gateway regardless of the selected currency

  • The VoD viju library and TMS are synchronized once a day.

  • After initial configuration, it is recommended to restart the service: systemctl restart manager-tvip-tms-vod-viju.