The tms_ctl utility

tms_ctl is a single command line utility for installing, upgrading and maintaining the TVIP TMS platform. It is part of the tvip-tms-standalone package and is installed in /usr/bin/tms_ctl.

All commands must be run with root (sudo) privileges. A lock file /var/run/tms_ctl.lock is created while the command is running - running two commands in parallel will cause an error.

Show the installed version:

tms_ctl --version

List of commands

Command

Description

install

Complete platform installation. Read more: installation.

update

Updating installed services. Read more: update.

add-service [name]

Install the optional service (see below).

start-all-services / stop-all-services

Start/stop all installed TMS services.

enable-services-autostart / disable-services-autostart

Enable/disable autorun of TMS services.

backup [path]

Creating a backup. Read more: backup.

restore <path>

Restore from backup. Read more: restore.

Service management

After installation, all platform services start automatically and are added to autostart. The commands below are required for typical maintenance operations - for example, when the server is stopped for routine maintenance.

Starts all installed TMS services:

sudo tms_ctl start-all-services

Stop all installed TMS services:

sudo tms_ctl stop-all-services

Note

The commands find services automatically - all installed manager-tvip-* and gateway-tvip-* packages are detected, as well as tms-web-player if present. The services are started in the order specified in the configuration and stopped in reverse order.

Enable autostart for all TMS services:

sudo tms_ctl enable-services-autostart

Disable autostart for all TMS services:

sudo tms_ctl disable-services-autostart

Installation of additional services

The platform includes services that are put on-demand:

Service

Description

tms-web-player

Web player for watching TV and VOD from your browser.

Install a service by name:

sudo tms_ctl add-service <service-name>

Without an argument, the command displays an interactive menu with the services available for installation:

sudo tms_ctl add-service