Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
en:tvip_tms_install_guide [2019/06/14 10:53]
Egor Danilenko [Ubuntu users]
en:tvip_tms_install_guide [2019/07/08 17:15] (current)
Egor Danilenko
Line 1: Line 1:
 ====== TVIP TMS install guide ====== ====== TVIP TMS install guide ======
-**System requirements**:​  +This is outdated articleyou can found actual manual ​[[en:​tvip_tms_quick_install_ubuntu|here]]
- +
-  * 4 Core CPU +
-  * Minimum 16GB of RAM +
- +
-**WARNING:​** TVIP TMS in BETA stageplease report all bugs to support@tvip.ru +
- +
- +
-===== Ubuntu users ===== +
- +
-**Supported version:** 16.04 LTS, 18.04 LTS +
- +
-<WRAP center round tip 60%> +
-We have **quick** way to installation on Ubuntu 18.04 - check instructions ​[[en:​tvip_tms_quick_install_ubuntu|here]] +
- +
-</​WRAP>​ +
- +
- +
-First - check your system locale, if your locale is not UTF-8 you might setup correct locale (system locale influence to postgresql cluster). +
-<​code>​ +
-locale -a +
-</​code>​ +
- +
-if you not seen UTF-8 entries in output, you need setup (change en_US code to your region): +
-<​code>​ +
-locale-gen en_US.UTF-8 +
-dpkg-reconfigure locales +
-</​code>​ +
- +
-Locale change after system reboot: +
-<​code>​ +
-reboot +
-</​code>​ +
- +
-Add repository to system: +
-<​code>​ +
-echo "deb http://​deb.packages.tvip.ru/​ xenial main" >> /​etc/​apt/​sources.list.d/​tms.list +
-wget --quiet -O - http://​deb.packages.tvip.ru/​deploy/​key.asc | apt-key add - +
-apt-get update +
-</​code>​ +
-Install dependencies:​ +
- +
-  * openjdk-java or oracle java (version 11 or above), tvip-tms package has as dependency java11-runtime. +
-  * postgresql server ​          ​(version 9.2 or above) +
-<​code>​ +
-apt-get install postgresql +
-</​code>​ +
-  * elasticsearch (version 6.2.3 or above) +
-<​code>​ +
-apt-get install elasticsearch +
-</​code>​ +
- +
-Install TVIP TMS: +
-<​code>​ +
-apt-get install tvip-tms +
-</​code>​ +
- +
- +
-===== Configure and start ===== +
- +
- +
-  * Switch to postgres user +
-<​code>​ +
-root@tms:~# su postgres +
-</​code>​ +
-  * Create tvip-tms user: +
-<​code>​ +
-postgres@tms:​~#​ createuser tvip-tms +
-</​code>​ +
-  * Create database for tvip-tms: +
-<​code>​ +
-createdb tvip-tms -O tvip-tms +
-</​code>​ +
-Configure pg_hba.conf:​ +
- +
-On ubuntu this configuration located at /​etc/​postgresql/<​pg_version>/​main/​pg_hba.conf +
- +
-On centos this configuration located at /​var/​lib/​pgsql/​data/​pg_hba.conf +
- +
- +
-Set access restriction for local, 127.0.0.1/​32 ::1/128 to **trust**:​ +
-<​code>​ +
-# "​local"​ is for Unix domain socket connections only +
-local   ​all ​            ​all ​                                    ​trust +
-# IPv4 local connections:​ +
-host    all             ​all ​            ​127.0.0.1/​32 ​           trust +
-# IPv6 local connections:​ +
-host    all             ​all ​            ::​1/​128 ​                ​trust +
- +
-</​code>​ +
- +
-This option allow passwordless access to all databases from localhost (not for remote connections). +
- +
-Restart postgres service +
- +
-<​code>​ +
-service postgresql restart +
-</​code>​ +
- +
-Default database configuration (/​opt/​tvip-tms/​application-prod.properties):​  +
- +
-<​code>​ +
-server.port=80 +
-server.tomcat.accesslog.enabled=true +
-server.tomcat.accesslog.directory=/​var/​log/​tms +
-spring.datasource.tomcat.max-active=70 +
-spring.datasource.tomcat.max-wait=1000 +
-spring.datasource.url=jdbc:​postgresql://​localhost:​5432/​tvip-tms +
-spring.datasource.username=tvip-tms +
-spring.datasource.password= +
-</​code>​ +
- +
-Enable service: +
-<​code>​ +
-#​autostart +
-systemctl enable tvip-tms +
- +
-#start service +
-service tvip-tms start +
-</​code>​  +
- +
-Enable elasticsearch +
-<​code>​ +
-#​autostart +
-systemctl enable elasticsearch +
- +
-#start service +
-service elasticsearch start +
-</​code>​  +
- +
-===== Check installation ===== +
- +
-Admin panel located at <​code>​http://<​your_server>:<​server_port>/​admin</​code>​ +
- +
-Default user admin has password admin +
- +
-Fresh installation contains examples of channels, accounts, etc... +
- +
- +
-Ubuntu 16.04, CentOS 7: application logs available by: +
-<​code>​ +
-journalctl -f -u tvip-tms +
-</​code>​ +
- +
-Ubuntu 14.04: application logs available by: +
-<​code>​ +
-tail -f /​var/​log/​tvip-tms.log +
-</​code>​ +
- +
-On all OS access log available in /​var/​log/​tms/​. +
- +
- +
-===== Additional configuration ===== +
-**VoD meta import** +
-For TMDB automated media import you will request API key [[https://​developers.themoviedb.org/​3/​getting-started/​introduction|here]] and add they to configuation:​ +
- +
-  - Follow to Settings (http://​tms.example.com/​admin#​config_items. +
-  - Create new property: tmdb_api_key,​ set your API key to that property +
- +
-====== Migration from TVIP Middleware version 2 ====== +
- +
-For migration to TMS you need fetch dump tvip-middleware database and restore database on new server ([[en:​tvip_tms_install_guide#​ubuntu_users|see instructions below]]) +
- +
-Be careful: database from TMS is not compatible with TVIP Middleware 2, but TVIP Middleware 2 database is allow to use with TVIP TMS +
- +
-===== How to backup tvip-middleware (not TMS) database ===== +
- +
-  * Get database name at /​usr/​local/​etc/​tvipmw.yml,​ usually this name is tvip_middleware +
-  * Switch to postgres user from root user and change current directory to rw allowed path  +
-<​code>​ +
-root@mw:~# su postgres +
-postgres@mw:​~#​ cd /​var/​lib/​postgresql/​9.3/​ +
-</​code>​ +
- +
-Make dump: +
-<​code>​ +
-postgres@mw:​~/​9.3$ pg_dump tvip_middleware > tvip_middleware.sql +
-</​code>​ +
- +
-Transfer generated file to another host ( for backup or migration cases ) +
-For secure copy (over ssh) use command: +
-<​code>​ +
-postgres@mw:​~/​9.3$ scp tvip_middleware.sql myname@tms.example.com:/​home/​myname +
-</​code>​ +
- +
- +
-===== How to restore tvip-middleware database to FRESH TVIP TMS===== +
-If you use tvip-middleware previously:​ +
-<​code>​ +
-postgres@tms:​~#​ psql -u tvip-tms tvip-tms < /​path/​to/​dump/​tvip-middleware.sql +
-</​code>​ +
- +
-WARNING: tvip-middleware backup might be restore before FIRST run of tvip-tms+