This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
en:tvip_tms_install_guide [2017/11/11 11:21] Egor Danilenko [Configure and start] |
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:** TVIP TMS in BETA stage, please report all bugs to support@tvip.ru | + | This is outdated article, you can found actual manual [[en:tvip_tms_quick_install_ubuntu|here]] |
- | + | ||
- | + | ||
- | ===== 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_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 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 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 | + |