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

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

Требования​

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

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

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

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

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

  1. Установите Microsoft Visual Studio 2013 Redistributable.

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

  3. Распакуйте архив, при необходимости, перенесите папку iqchannels-windows в корень c:\ (или в любое другое место) и переименуйте в iqchannels.

  4. Укажите настройки для базы данных в файле config/config.yaml

PostgreSQL:

db:
 type: postgres
 connect: host=localhost 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: localhost\\SQLExpress;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. Запустите консоль. Для этого в меню Пуск в поиске введите cmd.

  2. В консоли перейдите в папку iqchannels.

cd c:\iqchannels
  1. Запустите скрипты миграции базы данных:
.\bin\iqchanneld.bat migrate
2017/11/15 15:46:45     WARN    migrations  Migrating...
2017/11/15 15:46:45     WARN    migrations  Reading migrations from "migrations/postgres"
2017/11/15 15:46:45     WARN    migrations  Applied 0 migration(s) in 64ms
  1. Запустите демон приложения:
.\bin\iqchanneld.bat run
2017/11/15 15:48:13     WARN    iqchannels  Starting... {id=2c19c140-0664-4972-b614-343c763786d4}
2017/11/15 15:48:13     INFO    sender  Started a vk sender {id=4a394c01-d123-49b4-8c87-3858aad64ad7}
2017/11/15 15:48:13     INFO    pusher  Started a pusher    {id=03473f54-b2a7-4554-8903-2bfd7a66ebc9}
2017/11/15 15:48:13     INFO    sender  Started a telegram sender   {id=f447540e-5071-4629-91e7-8bb58012e844}
2017/11/15 15:48:13     INFO    offliner    Started a client offliner   {id=68b02811-1ccb-419a-8495-222dfd95bd85}
2017/11/15 15:48:13     INFO    autoreplier Started an autoreplier  {id=7565d502-ff40-4b4f-a5d2-97a2e97d5ea4}
2017/11/15 15:48:13     INFO    offliner    Started a user offliner {id=528242e1-d911-4374-8a82-2c637896ebb1}
2017/11/15 15:48:13     INFO    sender  Started a facebook sender   {id=5d89fb1b-fead-412d-9823-ee08568b89a5}
2017/11/15 15:48:13     INFO    router  Started a router    {id=a42db3cb-79d7-4f4b-8954-ebff0088bb83, actor=system}
2017/11/15 15:48:13     INFO    sender  Started a telegram initializer  {id=2078a1d1-9b5c-4b28-a89a-97e5eb2cfd5b, actor=system}
2017/11/15 15:48:13     INFO    httpd2  Listening to :3002  {id=5693a1f7-b36d-4f8d-a33e-147a1d09d408}
2017/11/15 15:48:13     INFO    httpd1  Listening to :3001  {id=20b2d47e-0e75-4bab-b9d3-08b9910652c7}
2017/11/15 15:48:13     WARN    iqchannels  Started {id=2c19c140-0664-4972-b614-343c763786d4}
  1. Для остановки нажмите CTRL-C:
2017/11/15 15:49:36     WARN    iqchannels  Stopping... {id=1220c686-9a10-4a78-9b92-28d4b0627d1a}
2017/11/15 15:49:36     INFO    sender  Stopped a vk sender {id=d1da1ff1-beed-412f-9efb-f2071c955ea2}
2017/11/15 15:49:36     INFO    httpd2  Stopping... {id=64f06a00-0a3d-4443-b78f-6499b881313e}
2017/11/15 15:49:36     INFO    httpd1  Stopping... {id=651db3ad-7d51-4b2e-8de7-8b9111fa93ab}
2017/11/15 15:49:36     INFO    router  Stopped a router    {id=515edada-36ee-4b51-b4f7-72befc27aefc, actor=system}
2017/11/15 15:49:36     INFO    pusher  Stopped a pusher    {id=6d298388-c87a-4bf9-88c4-90f79444c4d5}
2017/11/15 15:49:36     INFO    sender  Stopped a telegram sender   {id=ec8b6453-658e-4c29-b76f-b23bd9420d73}
2017/11/15 15:49:36     INFO    sender  Stopped a telegram initializer  {id=d88a98b0-d7b4-4405-97d9-5fda15f139d9, actor=system}
2017/11/15 15:49:36     INFO    autoreplier Stopped an autoreplier  {id=062b5927-753a-42a5-bb8d-c4af8707c7a5}
2017/11/15 15:49:36     INFO    sender  Stopped a facebook sender   {id=6cef5418-11a0-43c2-9ee8-d6f03f594a8c}
2017/11/15 15:49:36     INFO    offliner    Stopped a client offliner   {id=2e9dc646-76b1-4f97-9aeb-bbe9f5387665}
2017/11/15 15:49:36     INFO    httpd1  Stopped {id=651db3ad-7d51-4b2e-8de7-8b9111fa93ab}
2017/11/15 15:49:36     INFO    offliner    Stopped a user offliner {id=a32dfd3b-bbfc-4897-9caa-7327a9a5840e}
2017/11/15 15:49:36     INFO    httpd2  Stopped {id=64f06a00-0a3d-4443-b78f-6499b881313e}
2017/11/15 15:49:36     WARN    iqchannels  Stopped {id=1220c686-9a10-4a78-9b92-28d4b0627d1a}

  1. Логи приложения доступны в файлах в папке var\log.

  2. Готово, перейдите к Настройке приложения.