Start

Installing the Start VoD 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-start
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-start/application-prod.yml
sed -i "s/refreshTokenSecret/$REFRESH_TOKEN_SECRET/g" /opt/tvip-tms/manager/manager-tvip-tms-vod-start/application-prod.yml
sudo systemctl enable manager-tvip-tms-vod-start
sudo systemctl start manager-tvip-tms-vod-start

Setup the integration package

Specify the partner-name, api-key and url parameters recieved from Start in the /opt/tvip-tms/manager/manager-tvip-tms-vod-start/application-prod.yml configuration file under start section:

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

start:
    partner-name: <partner-name>
    api-key: <api-key>
    url: <url>

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-start

Setup tariff plans

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

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

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

Now this tag can be added to any tariff. If it is present in a tariff, users subscribed to that tariff will have access to the START library. To learn more about configuring VOD tariff tags, please visit related documentation page.

Tariff settings

Create a new tariff or chose an existing one and set it up to work with Start service:

  • Assign the VOD tag associated with the Start service.

  • Be sure to specify the tarification conditions, as they are important when working with Start API. If necessary, create a currency in the Management / Currencies section. Separate field “Price” in case of tariffs using Start 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 Start service will receive the full price of the tariff, even if it includes other resources such as TV. Tarification settings are also used to display the cost in promo channels.

Import setup

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

Features of realization

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

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

  • The cost of the tariff will be passed to the Start API gateway in the currency configured as part of the tarification.

  • The VOD Start library and TMS are synchronized once a day.

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