User Tools

Site Tools


en:tvip_tms_install_guide

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:tvip_tms_install_guide [2017/11/01 07:49]
Egor Danilenko [CentOS 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 ======
-===== WARNING ===== +This is outdated article, you can found actual manual ​[[en:tvip_tms_quick_install_ubuntu|here]]
-TVIP TMS in BETA stage, please report all bugs to support@tvip.ru +
- +
- +
-===== Ubuntu users ===== +
- +
-**Supported version:** 16.04 LTS +
- +
- +
-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_EN code to your region): +
-<​code>​ +
-locale-gen en_EN.UTF-8 +
-dpkg-reconfigure locale +
-dpkg-reconfigure keyboard-configuration +
-localedef -i en_EN -c -f UTF-8 en_EN.UTF-8 +
-</​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 1.8 or above) +
-<​code>​ +
-apt-get install openjdk-8-jre +
-</​code>​ +
-  * postgresql server ​          ​(version 9.2 or above) +
-<​code>​ +
-apt-get install postgresql +
-</​code>​ +
-Install TVIP TMS: +
-<​code>​ +
-apt-get install tvip-tms +
-</​code>​ +
- +
-===== CentOS users ===== +
-**Supported version:** 7 +
- +
-Add repository to system: +
-<​code>​ +
-cd /​etc/​yum.repos.d/​ +
-wget http://​rpm.packages.tvip.ru/​tvip-tms.repo +
-</​code>​ +
- +
-Install dependencies:​ +
- +
-  * openjdk-java or oracle java (version 1.8) +
-  * postgresql server ​       (version 9.2 or above) +
- +
-Install TVIP TMS: +
-<​code>​ +
-yum install tvip-tms +
-</​code>​ +
- +
- +
-===== Configure and start ===== +
- +
- +
-  * Switch to postgres user +
-<​code>​ +
-root@tms:~# su postgres +
-</​code>​ +
-  * Create tvip_middleware user: +
-<​code>​ +
-postgres@tms:​~#​ createuser -s tvip_middleware +
-</​code>​ +
-  * Create database for tvip_middleware:​ +
-<​code>​ +
-createdb tvip_middleware -O tvip_middleware +
-</​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_middleware +
-spring.datasource.username=tvip_middleware +
-spring.datasource.password= +
-</​code>​ +
- +
-Enable service: +
-<​code>​ +
-#​autostart +
-systemctl enable tvip-tms +
- +
-#start service +
-service tvip-tms start +
-</​code>​  +
- +
- +
-===== Check installation ===== +
- +
-Admin panel located at <​code>​http://<​your_server>:<​server_port>/​admin</​code>​ +
- +
- +
-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/​. +
- +
-===== 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_middleware tvip_middleware < /​path/​to/​dump/​tvip-middleware.sql +
-</​code>​ +
- +
-WARNING: tvip-middleware backup might be restore before FIRST run of tvip-tms+
en/tvip_tms_install_guide.1509511780.txt.gz · Last modified: 2017/11/01 07:49 by Egor Danilenko