Перейти к основному содержимому
Версия: 4.10

Установка IQChannels на Linux

Требования​

  • Операционная система: Linux x64.
  • Установленный ImageMagick для ресайза картинок.

Обзор поставки​

IQChannels является серверным приложением, которое предоставляет публичный REST API для внешних клиентов (виджета на сайте и мобильных приложения), внутренний REST API для внутренних клиентов и веб-приложение панели управления и рабочего места оператора.

Архив поставки:

  • bin — скомпилированные бинарные файлы приложения, скрипты управления приложением.
  • config — конфигурационные файлы.
  • migrations — файлы миграций для баз данных.
  • static — статические файлы (JavaScript, CSS, картинки и т.д.)
  • var/run, var/log, var/upload — папки для логов, pid-файлов (в Unix) и загружаемого пользовательского контента.

Установка приложения​

  1. Скачайте требуемый релиз со страницы Релизы iQChannels.

  2. Распакуйте архив.

$ unzip iqchannels-linux-2017.2.0.zip
  1. Перенесите папку iqchannels-linux в требуемое место, рекомендуемое /opt/iqchannels или /srv/iqchannels.
$ mv iqchannels-linux /srv/iqchannels
  1. Укажите настройки для базы данных в файле config/config.yaml

PostgreSQL:

db:
 type: postgres
 connect: port=5432 dbname=iqchannels user=iqchannels password=secret sslmode=disable
 max_idle: 4 # Max idle connections in a connection pool.
 max_open: 12 # Max open connections in a connection pool.

SQL Server:

#Первый вариант - для подключения БД в localhost:
db:
 type: mssql
 connect: port=1433;database=iqchannels;user id=sa;password=Secret22;encrypt=disable
 max_idle: 4 # Max idle connections in a connection pool.
 max_open: 12 # Max open connections in a connection pool.
 
 
 
 
#Второй вариант - пример с подключением к MSSQL на другом сервере (не в localhost):
db:
type: mssql
connect: sqlserver://sa:password@192.168.1.150:1433?database=iqchannels
max_idle: 4 # Max idle connections in a connection pool.
max_open: 12 # Max open connections in a connection pool.
  1. По умолчанию в системе для хранения вложенных в чат файлов используется каталог /iqchannels/var. При обновлении системы необходимо копировать этот каталог и подставлять его в каталог новой версии чат-платформы, иначе файлы будут недоступны для просмотра в истории сообщений. Чтобы избежать этого, рекомендуется настроить сохранение вложений в отдельный каталог, подключённый как сетевой диск. Для этого создайте сетевую папку, подключите её на сервере как сетевой диск и добавьте/измените параметр в конфигурационном файле config/config.yaml:
files:
  upload_path: "/mnt/iqchannels-var/upload"  # Путь к каталогу для хранения загружаемых файлов

При необходимости, измените другие настройки сервера в файле config/config.yaml. Там есть настройки по умолчанию с комментариями.

  1. Запустите скрипты миграции базы данных:
$ ./bin/iqchanneld migrate
  1. Запустите демон приложения:
$ ./bin/iqchanneld.sh start
  1. Для остановки, статуса, перезапуска демона используйте:
$ ./bin/iqchanneld.sh start|stop|status
  1. Для просмотра логов приложения:
$ tail -f ./var/log/iqchanneld.log
  1. Готово, перейдите к Настройке приложения.